后端Java学习：springboot之文件上传(阿里云OSS存储)

一、什么是阿里云存储？

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

二、阿里云存储的特点和功能

• 海量存储：支持无限量的数据存储，恰当各种规模的企业和个人用户。
  
• 高可用性：数据存储在多个数据中心，提供99.999999999%（11个9）的数据持久性。
  
• 安全性：提供多种安全机制，包罗数据加密、访问控制和身份验证等，确保用户数据的安全。
  
• 高性能：支持大并发读写，可以或许快速响应用户哀求。
  
• 机动计费：根据存储空间和流量使用情况举行计费，恰当不同需求的用户。
  
• 丰富的API：支持RESTful API，方便开辟者集成和使用。
  
• 多种存储类型：提供尺度存储、低频存储和归档存储等不同存储类型，满足不同访问频率的数据需求。
  
• 数据管理：支持生命周期管理、版本管理和数据迁移等功能，方便用户管理存储的数据。
  

三、springboot文件上传

1.为什么要使用阿里云OSS对象存储

在我们使用了阿里云OSS对象存储服务之后，我们的项目当中假如涉及到文件上传如许的业务，在前端举行文件上传并哀求到服务端时，在服务器本地磁盘当中就不需要再来存储文件了。我们直接将吸收到的文件上传到oss，由 oss帮我们存储和管理，同时阿里云的oss存储服务还保障了我们所存储内容的安全可靠。

2.举行准备工作（注册阿里云账户，并创建阿里云oss对象实例）

1.注册阿里云账户（注册完成后需要实名认证）
2.注册完账号之后，就可以登录阿里云
 

3.通过控制台找到对象存储OSS服务

   假如是第一次访问，还需要开通对象存储服务OSS  
   

 

4.开通OSS服务之后，就可以进入到阿里云对象存储的控制台

 5.点击左侧的 "Bucket列表"，创建一个Bucket

创建

3.编写入门程序

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

参照官方提供的SDK，改造一下，即可实现文件上传功能：

1. import com.aliyun.oss.ClientException;
2. import com.aliyun.oss.OSS;
3. import com.aliyun.oss.OSSClientBuilder;
4. import com.aliyun.oss.OSSException;
5. import com.aliyun.oss.model.PutObjectRequest;
6. import com.aliyun.oss.model.PutObjectResult;
8. import java.io.FileInputStream;
9. import java.io.InputStream;
11. public class AliOssTest {
12.     public static void main(String[] args) throws Exception {
13.         // Endpoint以华东1（杭州）为例，其它Region请按实际情况填写。
14.         String endpoint = "oss-cn-shanghai.aliyuncs.com";
15.         
16.         // 阿里云账号AccessKey拥有所有API的访问权限，风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维，请登录RAM控制台创建RAM用户。
17.         String accessKeyId = "LTAI5t9MZK8iq5T2Av5GLDxX";
18.         String accessKeySecret = "C0IrHzKZGKqU8S7YQcevcotD3Zd5Tc";
19.         
20.         // 填写Bucket名称，例如examplebucket。
21.         String bucketName = "web-framework01";
22.         // 填写Object完整路径，完整路径中不能包含Bucket名称，例如exampledir/exampleobject.txt。
23.         String objectName = "1.jpg";
24.         // 填写本地文件的完整路径，例如D:\\localpath\\examplefile.txt。
25.         // 如果未指定本地路径，则默认从示例程序所属项目对应本地路径中上传文件流。
26.         String filePath= "C:\\Users\\Administrator\\Pictures\\1.jpg";
28.         // 创建OSSClient实例。
29.         OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);
31.         try {
32.             InputStream inputStream = new FileInputStream(filePath);
33.             // 创建PutObjectRequest对象。
34.             PutObjectRequest putObjectRequest = new PutObjectRequest(bucketName, objectName, inputStream);
35.             // 设置该属性可以返回response。如果不设置，则返回的response为空。
36.             putObjectRequest.setProcess("true");
37.             // 创建PutObject请求。
38.             PutObjectResult result = ossClient.putObject(putObjectRequest);
39.             // 如果上传成功，则返回200。
40.             System.out.println(result.getResponse().getStatusCode());
41.         } catch (OSSException oe) {
42.             System.out.println("Caught an OSSException, which means your request made it to OSS, "
43.                     + "but was rejected with an error response for some reason.");
44.             System.out.println("Error Message:" + oe.getErrorMessage());
45.             System.out.println("Error Code:" + oe.getErrorCode());
46.             System.out.println("Request ID:" + oe.getRequestId());
47.             System.out.println("Host ID:" + oe.getHostId());
48.         } catch (ClientException ce) {
49.             System.out.println("Caught an ClientException, which means the client encountered "
50.                     + "a serious internal problem while trying to communicate with OSS, "
51.                     + "such as not being able to access the network.");
52.             System.out.println("Error Message:" + ce.getMessage());
53.         } finally {
54.             if (ossClient != null) {
55.                 ossClient.shutdown();
56.             }
57.         }
58.     }
59. }

复制代码

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

• accessKeyId：阿里云账号AccessKey
  
• accessKeySecret：阿里云账号AccessKey对应的秘钥
  
• bucketName：Bucket名称
  
• objectName：对象名称，在Bucket中存储的对象的名称
  
• filePath：文件路径
  

  AccessKey ：
  

   运行以上程序后，会把本地的文件上传到阿里云OSS服务器上：

4.集成代码

阿里云oss对象存储服务的准备工作以及入门程序我们都已经完成了，接下来我们就需要在案例当中集成oss对象存储服务，来存储和管理案例中上传的图片。
引入阿里云OSS上传文件工具类（由官方的示例代码改造而来）

1. import com.aliyun.oss.OSS;
2. import com.aliyun.oss.OSSClientBuilder;
3. import org.springframework.stereotype.Component;
4. import org.springframework.web.multipart.MultipartFile;
6. import java.io.IOException;
7. import java.io.InputStream;
8. import java.util.UUID;
10. @Component
11. public class AliOSSUtils {
12.     private String endpoint = "https://oss-cn-shanghai.aliyuncs.com";
13.     private String accessKeyId = "LTAI5t9MZK8iq5T2Av5GLDxX";
14.     private String accessKeySecret = "C0IrHzKZGKqU8S7YQcevcotD3Zd5Tc";
15.     private String bucketName = "web-framework01";
17.     /**
18.      * 实现上传图片到OSS
19.      */
20.     public String upload(MultipartFile multipartFile) throws IOException {
21.         // 获取上传的文件的输入流
22.         InputStream inputStream = multipartFile.getInputStream();
24.         // 避免文件覆盖
25.         String originalFilename = multipartFile.getOriginalFilename();
26.         String fileName = UUID.randomUUID().toString() + originalFilename.substring(originalFilename.lastIndexOf("."));
28.         //上传文件到 OSS
29.         OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);
30.         ossClient.putObject(bucketName, fileName, inputStream);
32.         //文件访问路径
33.         String url = endpoint.split("//")[0] + "//" + bucketName + "." + endpoint.split("//")[1] + "/" + fileName;
35.         // 关闭ossClient
36.         ossClient.shutdown();
37.         return url;// 把上传到oss的路径返回
38.     }
39. }

复制代码

修改UploadController代码：

1. import com.itheima.pojo.Result;
2. import com.itheima.utils.AliOSSUtils;
3. import lombok.extern.slf4j.Slf4j;
4. import org.springframework.beans.factory.annotation.Autowired;
5. import org.springframework.web.bind.annotation.PostMapping;
6. import org.springframework.web.bind.annotation.RestController;
7. import org.springframework.web.multipart.MultipartFile;
8. import java.io.IOException;
10. @Slf4j
11. @RestController
12. public class UploadController {
14.     @Autowired
15.     private AliOSSUtils aliOSSUtils;
17.     @PostMapping("/upload")
18.     public Result upload(MultipartFile image) throws IOException {
19.         //调用阿里云OSS工具类，将上传上来的文件存入阿里云
20.         String url = aliOSSUtils.upload(image);
21.         //将图片上传完成后的url返回，用于浏览器回显展示
22.         return Result.success(url);
23.     }
24.    
25. }

复制代码

使用postman测试：

   如许就成功上传图片啦，data返回的就是图片的数据。
  四、总结

在Spring Boot中实现文件上传功能需要设置项目依赖、创建控制器处置惩罚文件上传哀求、设置文件巨细限定、编写HTML表单供用户选择文件，并确保存储目录存在。启动应用后，可以通过访问上传表单举行测试，同时要注意文件类型查抄和异常处置惩罚，以提升安全性和用户体验。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。