OSS开通和使用
OSS官方文档https://help.aliyun.com/document_detail/31947.html?spm=5176.8465980.entries.4.58571450PowxpZ
创建Bucket
创建子AccessKey
阿里云主账号AccessKey拥有所有API的访问权限,风险很高。强烈建议创建并使用RAM账号进行API访问或日常运维,请登录RAM控制台创建RAM账号。官网地址https://ram.console.aliyun.com/manage/ak
SDK版整合OSS
Java版SDK官方文档https://help.aliyun.com/document_detail/32009.html?spm=a2c4g.11186623.6.923.1fca4697YMyJIl
将oss参数写入配置文件
# 阿里云oss,用于常量类读取
aliyun.oss.file.endpoint=your-endpoint
aliyun.oss.file.keyid=your-ak
aliyun.oss.file.keysecret=your-sk
aliyun.oss.file.bucketname=your-bucketName
创建工具类
// 当项目已启动,spring加载之后,执行接口一个方法
@Component
public class ConstantPropertiesUtils implements InitializingBean {
// 读取配置文件中的内容
@Value("${aliyun.oss.file.endpoint}")
private String endpoint;
@Value("${aliyun.oss.file.keyid}")
private String keyId;
@Value("${aliyun.oss.file.keysecret}")
private String keySecret;
@Value("${aliyun.oss.file.bucketname}")
private String bucketName;
//定义公开静态常量
public static String END_POINT;
public static String ACCESS_KEY_ID;
public static String ACCESS_KEY_SECRET;
public static String BUCKET_NAME;
@Override
public void afterPropertiesSet() throws Exception {
END_POINT = endpoint;
ACCESS_KEY_ID = keyId;
ACCESS_KEY_SECRET = keySecret;
BUCKET_NAME = bucketName;
}
简单文件上传示例
// service层
public String uploadFileAvatar(MultipartFile file) {
String endpoint = ConstantPropertiesUtils.END_POINT;
String accessKeyId = ConstantPropertiesUtils.ACCESS_KEY_ID;
String accessKeySecret = ConstantPropertiesUtils.ACCESS_KEY_SECRET;
String bucketName = ConstantPropertiesUtils.BUCKET_NAME;
// 创建OSSClient实例。
OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);
try {
// 上传文件流。
InputStream inputStream = file.getInputStream();
// 获取文件名称
String filename = file.getOriginalFilename();
//第一个参数:Bucket名称
//第二个参数:上传到oss文件路径和文件名称 如 /aa/bb/1.jpg
//第三个参数:上传文件输入流
ossClient.putObject(bucketName, filename, inputStream);
// 关闭OSSClient。
ossClient.shutdown();
// 把文件上传到阿里云路径手动返回
// 需要把上传到阿里云oss路径手动拼接出来
String url = "https://" + bucketName + "." + endpoint + "/" + filename;
return url;
} catch (Exception e) {
e.printStackTrace();
return null;
}
}
// controller层
@Autowired
private OssService ossService;
//上传文件的方法
@PostMapping
public R uploadOssFile(MultipartFile file) {
// 获取上传文件 MultipartFile
// 返回上传到oss的路径
String url = ossService.uploadFileAvatar(file);
return R.ok().data("url", url);
}
- MultipartFile:获取文件类
- 多次上传相同名称文件,最后一次上传把之前文件覆盖,因此需要将文件名添加随机唯一值,让每个文件名称不同
- 对文件进行分类
- 根据日期进行分类
- 把文件按照日期进行分类
文件上传完善,文件名唯一、按日期分类
// 上传文件流。
InputStream inputStream = file.getInputStream();
// 获取文件名称
String filename = file.getOriginalFilename();
// 1. 在文件名称里面添加随机唯一值
//uuid:qwer-43u5 去掉中间-
String uuid = UUID.randomUUID().toString().replaceAll("-", "");
//qwer-43u5jpg
filename = uuid + filename;
// 2. 把文件按照日期进行分类
// 2020/2/2/02.jpg
// 获取当前日期 需要依赖joda-time
String datePath = new DateTime().toString("yyyy/MM/dd");
filename = datePath + "/" + filename;
ossClient.putObject(bucketName, filename, inputStream);
// 关闭OSSClient。
ossClient.shutdown();
// 把文件上传到阿里云路径手动返回
// 需要把上传到阿里云oss路径手动拼接出来
String url = "https://" + bucketName + "." + endpoint + "/" + filename;
return url;
Spring Boot Starter版整合OSS
SpringBoot整合版官方文档https://github.com/alibaba/spring-cloud-alibaba
引入依赖
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alicloud-oss</artifactId>
<version>2.1.1.RELEASE</version>
</dependency>
配置文件
spring.cloud.alicloud.access-key=your-ak
spring.cloud.alicloud.secret-key=your-sk
spring.cloud.alicloud.oss.endpoint=your-endpoint
spring.cloud.alicloud.oss.bucketName=your-bucketName
简单文件上传核心代码
@Value("${spring.cloud.alicloud.oss.bucketName}")
private String bucketName;
@Value("${spring.cloud.alicloud.oss.endpoint}")
private String endpoint;
@Autowired
private OSS ossClient;
@Override
public String uploadPic(MultipartFile file) {
String dataPath = "pic/" + new SimpleDateFormat("yyyy-MM-dd").format(new Date());
String fileName = file.getOriginalFilename();
long time = new Date().getTime();
fileName = dataPath + "/" + time + fileName;
try {
InputStream inputStream = file.getInputStream();
ossClient.putObject(bucketName, fileName, inputStream);
// 把上传之后路径返回
String url = "https://" + bucketName + "." + endpoint + "/" + fileName;
return url;
} catch (IOException e) {
e.printStackTrace();
}
return null;
}
Oss服务端获取签名直传
官方文档地址https://help.aliyun.com/document_detail/31926.html?spm=a2c4g.11186623.6.1732.3e0743d3M82Gc0
修改Bucket的CORS策略
客户端进行表单直传到OSS时,会从浏览器向OSS发送带有Origin
的请求消息。OSS对带有Origin
头的请求消息会进行跨域规则(CORS)的验证。因此需要为Bucket设置跨域规则以支持Post方法。
引入依赖
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alicloud-oss</artifactId>
<version>2.1.1.RELEASE</version>
</dependency>
配置文件
spring.cloud.alicloud.access-key=your-ak
spring.cloud.alicloud.secret-key=your-sk
spring.cloud.alicloud.oss.endpoint=your-endpoint
spring.cloud.alicloud.oss.bucketName=your-bucketName
获取服务端签名
@Value("${spring.cloud.alicloud.oss.bucketName}")
private String bucketName;
@Value("${spring.cloud.alicloud.oss.endpoint}")
private String endpoint;
@Value("${spring.cloud.alicloud.access-key}")
private String accessId;
@Autowired
private OSS ossClient;
@Override
public Map<String, String> getPolicy() {
//https://oss-aliyun-sample.oss-cn-beijing.aliyuncs.com/hahaha.jpg
String host = "https://" + bucketName + "." + endpoint; // host的格式为 bucketname.endpoint
String format = new SimpleDateFormat("yyyy-MM-dd").format(new Date());
String dir = format + "/"; // 用户上传文件时指定的前缀。
Map<String, String> respMap = null;
try {
long expireTime = 30;
long expireEndTime = System.currentTimeMillis() + expireTime * 1000;
Date expiration = new Date(expireEndTime);
PolicyConditions policyConds = new PolicyConditions();
policyConds.addConditionItem(PolicyConditions.COND_CONTENT_LENGTH_RANGE, 0, 1048576000);
policyConds.addConditionItem(MatchMode.StartWith, PolicyConditions.COND_KEY, dir);
String postPolicy = ossClient.generatePostPolicy(expiration, policyConds);
byte[] binaryData = postPolicy.getBytes("utf-8");
String encodedPolicy = BinaryUtil.toBase64String(binaryData);
String postSignature = ossClient.calculatePostSignature(postPolicy);
respMap = new LinkedHashMap<String, String>();
respMap.put("accessid", accessId);
respMap.put("policy", encodedPolicy);
respMap.put("signature", postSignature);
respMap.put("dir", dir);
respMap.put("host", host);
respMap.put("expire", String.valueOf(expireEndTime / 1000));
} catch (Exception e) {
System.out.println(e.getMessage());
}
return respMap;
}
测试获取签名