SpringBoot上传文件至阿里云OSS对象

一、创建阿里云账号并开通OSS对象存储服务

1、阿里云官网：https://www.aliyun.com/
2、创建阿里云账号，并打开控制台，搜索OSS

3、点击对象存储OSS：

4、点击Buckjet列表------>点击创建Bucket，填写Bucket名称，区域选择离自己最近的城市。

至此已经创建好Bucket。

二、SpringBoot项目中完成文件上传至OSS

此处给出OSS的帮助文档：https://help.aliyun.com/product/31815.html
1、新建SpringBoot项目
项目目录如下图所示:

3、pom.xml中引入依赖

<dependency>
    <groupId>com.aliyun.oss</groupId>
    <artifactId>aliyun-sdk-oss</artifactId>
    <version>3.10.2</version>
</dependency>

pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.5.9</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.tianyi</groupId>
    <artifactId>UploadDemo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>UploadDemo</name>
    <description>UploadDemo</description>
    <properties>
        <java.version>1.8</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-freemarker</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>com.aliyun.oss</groupId>
            <artifactId>aliyun-sdk-oss</artifactId>
            <version>3.10.2</version>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

3、PageController.java

package com.tianyi.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class PageController {

    @GetMapping("/upload")
    public String upload(){
        return "upload";
    }
}

4、UploadController.java

package com.tianyi.controller;

import com.tianyi.service.OssUploadService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;
import javax.servlet.http.HttpServletRequest;

@Controller
public class UploadController {

    @Autowired
    private OssUploadService ossUploadService;
  
    @PostMapping("/upload/file")
    @ResponseBody
    public String upload(@RequestParam("file") MultipartFile multipartFile, HttpServletRequest request){
        if(multipartFile.isEmpty()){
            return "文件有误！！！";
        }

        //获取指定的文件夹
        String dir = request.getParameter("dir");
        return ossUploadService.uploadFile(multipartFile, dir);
    }
}

5、OssUploadService.java

package com.tianyi.service;

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.CannedAccessControlList;
import org.springframework.stereotype.Service;
import org.springframework.web.multipart.MultipartFile;

import java.io.*;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.UUID;

@Service
public class OssUploadService {

    public String uploadFile(MultipartFile multipartFile, String dir){

        // Endpoint以华东1（杭州）为例，其它Region请按实际情况填写。关于其他Region对应的Endpoint信息，请参见访问域名和数据中心。
        String endpoint = "**********";
        // 阿里云账号AccessKey拥有所有API的访问权限，风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维，请登录RAM控制台创建RAM用户。
        String accessKeyId = "**********";
        String accessKeySecret = "************";
        // 填写Bucket名称，例如examplebucket。
        String bucketName = "*********";
        //填写文件名。文件名包含路径，不包含Bucket名称。
        OSS ossClient = null;

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

            //判断桶是否存在，不存在则创建桶
            if(!ossClient.doesBucketExist(bucketName)){
                //创建bucket
                ossClient.createBucket(bucketName);
                //设置oss实例的访问权限：公共读
                ossClient.setBucketAcl(bucketName, CannedAccessControlList.PublicRead);
            }
            //获取文件上传的流
            InputStream inputStream = multipartFile.getInputStream();
            //构建日期目录
            SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy/MM/dd");
            String datePath = dateFormat.format(new Date());
            //获取文件名
            String originname = multipartFile.getOriginalFilename();

            String fileUrl = dir + "/" + datePath + "/" + originname;
            //文件上传到云服务器
            ossClient.putObject(bucketName, fileUrl, inputStream);

            return "https://" + bucketName + "." + endpoint + "/" + fileUrl;
        } 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());
        } catch (IOException e) {
            e.printStackTrace();
            return "fail";
        } finally {
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }
        return "success";
    }
}

注意上面有四个参数，需要与自己阿里云OSS中创建的Bucket对应。
(1) endpoint
进入自己所创建的Bucket中,复制对应的endpoint

(2) accessKeyId 和 accessKeySecret
点击头像----->选择AccessKey管理

选择查看Secret

填写验证码，就可以获取到accessKeyId 和 accessKeySecret了。

(3) bucketName 就是之前所创建的Bucekt名称
将以上四个参数补充到代码当中。
6、application.yml

server:
  port: 8080

spring:
  freemarker:
    suffix: .html
    cache: false

6、upload.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>文件上传</title>
</head>
<body>
    <h1>文件上传</h1>

    <form action="/upload/file" id="uploadform" enctype="multipart/form-data" method="post">
        <input name="dir" value="filedir">
        <input name="file" type="file" multiple onchange="toupload()" accept="image/jpg">
    </form>
    <script>
        function toupload(){
            document.getElementById("uploadform").submit();
        }
    </script>
</body>
</html>

三、测试

1、启动项目

2、浏览器中输入http://localhost:8080/upload

选择所要上传的文件，文件自动上传到OSS所创建的Bucket中，浏览器返回文件的路径。

3、进入OSS中查看

至此，在SpringBoot中简单上传文件至OSS已经完成。