基于springboot和vue实现oss上传

基于springboot实现oss上传

1 OSS对象存储
阿里云对象存储服务（Object Storage Service，简称 OSS），是阿里云提供的海量、安全、低成本、高可靠的云存储服务。OSS可用于图片、音视频、日志等海量文件的存储。各种终端设备、Web网站程序、移动应用可以直接向OSS写入或读取数据。

2 OSS相关概念
（1）Endpoint：外网访问oss服务器的域名，通过该域名可以访问OSS服务的API，进行文件上传、下载等操作。

（2）Bucket：存储空间，是存储对象的容器，所有存储对象都必须隶属于某个存储空间。

（3）Object：对象，对象是 OSS 存储数据的基本单元，也被称为 OSS 的文件（可以是.png，.txt等任意文件）。

（4）AccessKey：访问密钥，指的是访问身份验证中用到的 AccessKeyId 和 AccessKeySecret。

3 开通并设置阿里OSS

3.1 开通OSS服务

步骤1：登录到阿里云官网；

步骤2：点击下图所示"对象存储OSS"菜单。

3.2 创建存储空间Bucket

点击“创建Bucket”按钮。

按照下图填写bucket名称和相关配置后，点击“确认”保存即可！注意：读写权限应当选择“公共读”，否则上传的文件无法访问！

这样，我们的文件存储空间bucket就创建好了。

4 创建accessKeyId和accessKeySecret

短信验证后就可以获取到了accessKeyId和accessKeySecret了。

5 基于springboot代码实现oss上传

5.1 在pom.xml中加入oss依赖

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

5.2在properties中加入相关的配置

uposs.allowed-file-size-max=2MB 文件的大小，可根据需求自行设置
uposs.allowed-file-suffix=PNG,JPG,JPEG 文件上传的格式
uposs.aliyun.oss.endpoint=oss-cn-beijing.aliyuncs.com # oss对外服务的访问域名
uposs.aliyun.oss.bucketName=xxxx-xxxx #bucket的名称
uposs.aliyun.oss.accessKeyID=LTAI5t9wkfTMvJuVxUEevHpK # 访问身份验证中用到用户标识
uposs.aliyun.oss.accessKeySecret=n2cSXyT27Qqk0eBETSnSxRJpYLa93O# 用户用于加密签名字符串和oss用来验证签名字符串的密钥

5.3加入工具类，仅供参考

package com.weishu.weishusystemmanagement.utils;import com.aliyun.oss.OSSClient;
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;
import java.net.URL;
import java.util.Date;
import java.util.Objects;
import java.util.UUID;/*** OSS工具类 - 阿里云OSS服务器工具类**/
@Component
public class OssUtil {/** 从配置文件获取阿里云OSS的相关配置*//*** 阿里云OSS的地域节点*/@Value("${uposs.aliyun.oss.endpoint}")private String endpoint;/*** 阿里云OSS的存储空间名称*/@Value("${uposs.aliyun.oss.bucketName}")private String bucketName;/*** 阿里云OSS的访问秘钥ID*/@Value("${uposs.aliyun.oss.accessKeyID}")private String accessKeyID;/*** 阿里云OSS的访问秘钥凭证*/@Value("${uposs.aliyun.oss.accessKeySecret}")private String accessKeySecret;/*** 阿里云OSS的存储空间的上传文件的存储目录*/
//    @Value("${uposs.aliyun.oss.uploadSaveDir}")
//    private String uploadSaveDir;/*** 上传文件** @param file 上传的文件* @return 上传成功之后文件的URL路径* @throws IOException IO异常*/public String uploadFile(MultipartFile file) throws IOException {//上传图片到OSSString fileUrl = uploadImg2OSS(file);//获取上传图片到OSS之后的URL路径String str = getURL(fileUrl);return str.trim();}/*** 上传图片到OSS** @param file 上传的文件* @return 上传文件的新的名称* @throws IOException IO异常*/@SuppressWarnings("deprecation")private String uploadImg2OSS(MultipartFile file) throws IOException {// 1.生成新的文件名称(以防止文件名称重复)String fileName = file.getOriginalFilename();String suffix = Objects.requireNonNull(fileName).substring(fileName.lastIndexOf(".")).toLowerCase();String uuid = UUID.randomUUID().toString().replace("-", "");String lastName = uuid + suffix;// 2.上传文件到OSSInputStream inputStream = file.getInputStream();// 2.1创建上传的Object的metadataObjectMetadata objectMetadata = new ObjectMetadata();objectMetadata.setContentLength(inputStream.available());objectMetadata.setCacheControl("no-cache");objectMetadata.setHeader("Pragma", "no-cache");objectMetadata.setContentType(FileUtil.getContentType(lastName.substring(lastName.lastIndexOf("."))));objectMetadata.setContentDisposition("inline;filename=" + lastName);//解决不能预览文件objectMetadata.setContentType("image/jpg");// 2.2上传文件OSSClient ossClient = new OSSClient(endpoint, accessKeyID, accessKeySecret);ossClient.putObject(bucketName,  lastName, inputStream, objectMetadata);inputStream.close();return lastName;}/*** 获得URL链接** @param lastName 上传文件的新的名称* @return 文件上传成功之后文件的URL路径*/@SuppressWarnings("deprecation")private String getURL(String lastName) {// 设置URL的过期时间为20年, 即: 20*365*24*60*60*1000L 毫秒Date expiration = new Date(new Date().getTime() + 20*365*24*60*60*1000L);// 生成URLOSSClient ossClient = new OSSClient(endpoint, accessKeyID, accessKeySecret);URL url = ossClient.generatePresignedUrl(bucketName, lastName, expiration);// 去除URL的参数String tmp = url.toString().split("\\?")[0];int index = tmp.lastIndexOf("/") + 1;return tmp.substring(0, index)  + tmp.substring(index);}}

5.4 前端访问controller返回上传oss后的文件路径

package com.weishu.weishusystemmanagement.controller;import com.weishu.weishusystemmanagement.utils.OssUtil;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;import java.io.IOException;
import java.util.ArrayList;
import java.util.List;@RestController
@RequestMapping("/ossUpload")
public class OssUploadController {@AutowiredOssUtil ossUtil; //引入工具类@RequestMapping("/upload")public String upload(MultipartFile file) throws IOException {String fileUrl = ossUtil.uploadFile(file); //调用上传的方法return fileUrl;//返回上传后的路径}}