文件上传服务（本地存储和阿里云OSS对象存储）

@Ydpgramer

已于 2023-06-07 16:21:50 修改

阅读量1.5k

点赞数 1

文章标签： servlet java 开发语言

于 2023-06-07 16:12:04 首次发布

本文链接：https://blog.csdn.net/m0_65006010/article/details/131084334

版权

文章介绍了文件上传服务的重要性，并详细讲解了如何实现本地存储，包括创建存储目录、使用原始文件名和UUID作为文件名。接着，文章转向阿里云OSS对象存储，阐述了环境准备、开通服务、创建Bucket以及使用SDK进行文件上传的代码实现过程。

摘要由CSDN通过智能技术生成

一.简介

文件上传服务在项目应用中非常广泛，例如我们经常发微博、微信发朋友圈、发抖音、QQ空间等都需要用到文件上传服务

二.本地存储

1.简介

文件上传时在服务端会产生一个临时文件，请求响应完成之后，这个临时文件被自动删除，并没有进行保存。此时我们就需要完成将上传的文件保存在服务器的本地磁盘上。

2.创建存储文件的目录

3.代码实现

3.1 原始文件名

@Slf4j
@RestController
@RequestMapping("/upload")
public class UploadeController {
    @PostMapping
    public Result upload( MultipartFile file) throws IOException {
        log.info("文件上传{}",file);
        //获取文件名
        String fileName = file.getOriginalFilename();
        //将文件存入指定目录
        file.transferTo(new File("/Users/yudongping/Desktop/files/"+fileName));
        return Result.success();
    }
}

测试（选择文件进行传输）

返回请求

上传是成功，图片成功存储到本地目录中

上传文件的时候会有文件大小限制，此时就需要我们手动去进行配置

#单个文件大小的限制
spring.servlet.multipart.max-file-size=1MB
#多个文件上传的总大小限制
spring.servlet.multipart.max-request-size=10MB

3.2 uuid唯一识别码

使用原始文件名进行存储的弊端在于不同的用户上传了不同的文件而文件名相同时，后面上传的文件会把之前的同名文件覆盖掉，此时我们就要用到uuid识别码给定文件一个随机且唯一的文件名，这样就能避免文件重命名无法保存完整的情况

@Slf4j
@RestController
@RequestMapping("/upload")
public class UploadeController {
    @PostMapping
    public Result upload( MultipartFile file) throws IOException {
        log.info("文件上传{}",file);
        //获取文件名
        String fileName = file.getOriginalFilename();

        //构造唯一文件名
        int index = fileName.lastIndexOf(".");
        String extname = fileName.substring(index);//获取文件扩展名
        //构建新的文件名
        String newfileName = UUID.randomUUID().toString()+extname;
        log.info("新的文件名为：{}",newfileName);

        //将文件存入指定目录
        file.transferTo(new File("/Users/yudongping/Desktop/files/"+newfileName));
        return Result.success();
    }
}

选择上传文件的步骤与3.1相同

此时的文件名变成了随机且唯一的uuid识别码：

三.阿里云OSS对象存储

1.环境准备

1.简介

阿里云对象存储OSS（Object Storage Service），是一款海量、安全、低成本、高可靠的云存储服务。使用OSS，您可以通过网络随时存储和调用包括文本、图片、音频和视频等在内的各种文件。

2.进入阿里云官网注册阿里云账号

3.找到对象存储OSS

4.开通OSS服务并创建OSS Bucket

2.代码实现

1.获取AceessKey

2.复制AceessKey

3.找到官方SDK

根据文档进行开发，首先我们需要来打开阿里云OSS的官方文档，在官方文档中找到 SDK 的示例代码：

4.添加依赖

<!--        阿里云OSS对象-->
        <dependency>
            <groupId>com.aliyun.oss</groupId>
            <artifactId>aliyun-sdk-oss</artifactId>
            <version>3.15.1</version>
        </dependency>
<!--        如果使用的是Java 9及以上的版本，则需要添加jaxb相关依赖。添加jaxb相关依赖示例代码如下：-->
        <dependency>
            <groupId>javax.xml.bind</groupId>
            <artifactId>jaxb-api</artifactId>
            <version>2.3.1</version>
        </dependency>
        <dependency>
            <groupId>javax.activation</groupId>
            <artifactId>activation</artifactId>
            <version>1.1.1</version>
        </dependency>
        <!-- no more than 2.3.3-->
        <dependency>
            <groupId>org.glassfish.jaxb</groupId>
            <artifactId>jaxb-runtime</artifactId>
            <version>2.3.3</version>
        </dependency>

5.参照官方的sdk

改造一下，即可实现文件上传功能：

package com.ydpgramer.mytest;


import com.aliyun.oss.ClientException;
import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.OSSException;
import com.aliyun.oss.model.PutObjectRequest;
import com.aliyun.oss.model.PutObjectResult;
import java.io.FileInputStream;
import java.io.InputStream;


public class Aliyun {
    public static void main(String[] args) throws Exception {
        // Endpoint以华北2（北京）为例，其它Region请按实际情况填写。
        String endpoint = "https://oss-cn-beijing.aliyuncs.com";
        // 阿里云账号AccessKey拥有所有API的访问权限，风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维，请登录RAM控制台创建RAM用户。
        String accessKeyId = "LTAI5tGNck6sSqNpdCySNXTk";
        String accessKeySecret = "QyysAkhMCm57IX7l37j1nL3ZSsZVWg";
        // 填写Bucket名称，例如examplebucket。
        String bucketName = "ydpgrameer";
        // 填写Object完整路径，完整路径中不能包含Bucket名称，例如exampledir/exampleobject.txt。
        String objectName = "ydp.png";
        // 填写本地文件的完整路径，例如D:\\localpath\\examplefile.txt。
        // 如果未指定本地路径，则默认从示例程序所属项目对应本地路径中上传文件流。
        String filePath= "/Users/yudongping/Desktop/files/ydp.png";

        // 创建OSSClient实例。
        OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);

        try {
            InputStream inputStream = new FileInputStream(filePath);
            // 创建PutObjectRequest对象。
            PutObjectRequest putObjectRequest = new PutObjectRequest(bucketName, objectName, inputStream);
            // 设置该属性可以返回response。如果不设置，则返回的response为空。
            putObjectRequest.setProcess("true");
            // 创建PutObject请求。
            PutObjectResult result = ossClient.putObject(putObjectRequest);
            // 如果上传成功，则返回200。
            System.out.println(result.getResponse().getStatusCode());
        } catch (OSSException oe) {
            System.out.println("Caught an OSSException, which means your request made it to OSS, "
                    + "but was rejected with an error response for some reason.");
            System.out.println("Error Message:" + oe.getErrorMessage());
            System.out.println("Error Code:" + oe.getErrorCode());
            System.out.println("Request ID:" + oe.getRequestId());
            System.out.println("Host ID:" + oe.getHostId());
        } catch (ClientException ce) {
            System.out.println("Caught an ClientException, which means the client encountered "
                    + "a serious internal problem while trying to communicate with OSS, "
                    + "such as not being able to access the network.");
            System.out.println("Error Message:" + ce.getMessage());
        } finally {
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }
    }
}

在以上代码中，需要替换的内容为：

accessKeyId：阿里云账号AccessKey

accessKeySecret：阿里云账号AccessKey对应的秘钥

bucketName：Bucket名称

objectName：对象名称，在Bucket中存储的对象的名称

filePath：文件路径

6.上传成功