SpringBoot整合阿里雲OSS物件儲存實現檔案上傳

一隻大熊熊ovo發表於2021-04-13
Spring Boot阿里物件

1. 準備工作：

一、首先登入阿里雲OSS物件儲存控制檯建立一個Bucket作為你的儲存空間。
二、建立Access Keyan按要求建立進行，這裡的方法步驟我就不展現出來了，你們可以自行查詢阿里雲文件，這個獲取值本身就不難。
重點：記下你的AccessKey ID、AccessKey Secret以及你剛才建立的Buacket名字BucketName。

2. 配置：

在pom裡引入oss要用的依賴

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

在application.yml裡面新增配置檔案

# 定義的埠號
server:
  port: 8080

aliyun:
  oss:
    #yourEndpoint填寫Bucket所在地域對應的Endpoint，可在建立好的Bucket概況頁檢視。
    endpoint: oss-cn-chengdu.aliyuncs.com		# 以成都為例，Endpoint填寫為https://oss-cn-chengdu.aliyuncs.com
    #阿里雲賬號AccessKey擁有所有API的訪問許可權，風險很高。強烈建議您建立並使用RAM使用者進行API訪問或日常運維，請登入RAM控制檯建立RAM使用者
    accessKeyId: **********				# 阿里雲賬號AccessKey裡所對應的AccessKey ID
    accessKeySecret: **********				# 阿里雲賬號AccessKey裡所對應的AccessKey Secret
    bucketName: **********				# OSS物件儲存空間名

3. 詳細程式碼：

第一步：建立一個service包，新建一個AliyunOssService.java

import org.springframework.stereotype.Service;
import org.springframework.web.multipart.MultipartFile;
import java.util.Map;

@Service
public interface AliyunOssService {
    Map<String, Object> upload(MultipartFile file, String fileName);
}

第二步：在service包裡建立一個impl包，新建一個AliyunOssServiceImpl.java

import com.system.demo.service.AliyunOssService;
import com.system.demo.util.FileUploadUtil;
import org.springframework.stereotype.Service;
import org.springframework.web.multipart.MultipartFile;
import javax.annotation.Resource;
import java.util.HashMap;
import java.util.Map;

@Service("aliyunOssService")
public class AliyunOssServiceImpl implements AliyunOssService {

    @Resource
    private FileUploadUtil fileUploadUtil;

    @Override
    public Map<String, Object> upload(MultipartFile file, String fileName){
        //定義一個目錄（這裡的目錄可根據自己實際情況自己拼接定義）
        String path = "a";   //我這裡就隨便定義一個a資料夾
        //拼接，這裡將路徑和檔名拼接在了一起
        fileName = path + "/" +fileName;
        Map<String, Object> map =new HashMap<>();
        map.put("code", 200);
        map.put("msg", "查詢成功");
        map.put("data", this.fileUploadUtil.upload(file, fileName));
        return map;
    }

}

第三步：建立一個util包，新建一個FileUploadUtil.java

import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.model.ObjectMetadata;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;
import org.springframework.web.multipart.MultipartFile;
import java.io.IOException;
import java.io.InputStream;

@Component
public class FileUploadUtil {

    @Value("${aliyun.oss.endpoint}")
    private String endpoint;

    @Value("${aliyun.oss.accessKeyId}")
    private String accessKeyId;

    @Value("${aliyun.oss.accessKeySecret}")
    private String accessKeySecret;

    @Value("${aliyun.oss.bucketName}")
    private String bucketName;

    public String upload(MultipartFile file, String fileName){
            // 寫入檔案
            try {
                //獲取上傳的輸入流
                InputStream inputStream = file.getInputStream();

                //設定訪問地址是預設是預覽圖片
                ObjectMetadata meta = new ObjectMetadata();
                meta.setContentType("image/jpg");

                // 建立OSSClient例項
                OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);

                /*
                呼叫oss上傳到阿里雲物件儲存oss----Bucket儲存空間
                第一個引數 bucket名稱
                第二個引數 檔名稱
                第三個引數 輸入流
                第四個引數 檔案型別
                 */
                ossClient.putObject(bucketName, fileName, inputStream, meta);

                // 刪除檔案。如需刪除資料夾，請將ObjectName設定為對應的資料夾名稱。如果資料夾非空，則需要將資料夾下的所有object刪除後才能刪除該資料夾。
                //ossClient.deleteObject(bucketName, "a/");

                // 關閉OSSClient。
                ossClient.shutdown();

                //上傳成功後獲取檔案路徑
                String url = "https://" + bucketName + "." + endpoint + "/"+ fileName;
                return url;
            } catch (IOException e) {
                e.printStackTrace();
            }
        return null;
    }
}

第四步：定義介面建立一個controller包，新建一個FileUpload.java

import com.system.demo.service.impl.AliyunOssServiceImpl;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;
import javax.annotation.Resource;
import java.util.Map;

@RestController
@RequestMapping("oss")
public class FileUpload {

    @Resource
    private AliyunOssServiceImpl aliyunOssServiceImpl;

    @RequestMapping(value = "fileoss", method = RequestMethod.POST)
    public Map<String, Object> uploadOssFile(MultipartFile file, String fileName){
        return this.aliyunOssServiceImpl.upload(file, fileName);

    }
}

4. 測試：

首先執行啟動類，在Postman進行測試
選擇請求方式：POST
請求路徑：localhost:8080/oss/fileoss
選擇Body-->form-data
-----第一列資料：KEY為file，選擇型別為File，新增VALUE為自己想要上傳的檔案；
-----第二列資料：KEY為fileName，選擇型別為Text，新增VALUE為的檔名

如下圖：
在這裡插入圖片描述
新增完成後，點選send，發起請求，等待返回資料，返回的JSON格式中data所對應的地址，為該檔案的預覽地址。
同時，你也可在你的OSS裡面檢視你的檔案。

相關文章