基于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 {
//上传图片到OSS
String 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.上传文件到OSS
InputStream inputStream = file.getInputStream();
// 2.1创建上传的Object的metadata
ObjectMetadata 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);
// 生成URL
OSSClient 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 {
@Autowired
OssUtil ossUtil; //引入工具类
@RequestMapping("/upload")
public String upload(MultipartFile file) throws IOException {
String fileUrl = ossUtil.uploadFile(file); //调用上传的方法
return fileUrl;//返回上传后的路径
}
}