OSS官方文档提示(Java版本):如何通过Java在服务端签名直传并设置上传回调_对象存储(OSS)-阿里云帮助中心 (aliyun.com)
本文章演示SpringBoot + Vue实现上传
为什么要使用前端直传?
Web端常见的上传方法是用户在浏览器或App端上传文件到应用服务器,应用服务器再把文件上传到OSS。这种方式需通过应用服务器中转,传输效率明显低于数据直传至OSS的方式。
数据直传至OSS是利用OSS的PostObject接口,使用表单上传方式上传文件至OSS。您可以通过以下案例了解如何通过表单上传的方式,直传数据到OSS:
-
在客户端通过JavaScript代码完成签名,然后通过表单直传数据到OSS。详情请参见JavaScript客户端签名直传。
-
在服务端完成签名,然后通过表单直传数据到OSS。详情请参见服务端签名后直传。
-
在服务端完成签名,并且服务端设置了上传后回调,然后通过表单直传数据到OSS。OSS回调完成后,再将应用服务器响应结果返回给客户端。详情请参见服务端签名直传并设置上传回调。
这里我们只进行服务端简单上传,但是不考虑回调!!
使用方式:
1.先在我们的开发工具(IDEA)中创建控制层实现类OSSController
2.创建方法policy,由于我们需要将数据传递给前端,可以将返回类型设置为Map<String,String>类型
@RequestMapping("/oss/policy")
public Map<String, String> policy() {
}
3.使用OSS官方提供的核心代码模板
String accessId = "LTAI5tM6icTZgRDsNHjSUUnm";//请填写您的AccessKeyId
String accessKeySecret = "OaTw157Im5ApUKljMgbfgJFwAyiQ9o";//请填写您的AccessKeySecret
// Endpoint以广州为例,其他Region请按实际情况填写。
String endpoint = "oss-cn-guangzhou.aliyuncs.com";
// 填写Bucket名称,例如examplebucket。
String bucket = "examplebucket";
// 填写Host名称,格式为https://bucketname.endpoint。
String host = "https://" + bucket + "." + endpoint;
// 设置上传回调URL,即回调服务器地址,用于处理应用服务器与OSS之间的通信。OSS会在文件上传完成后,把文件上传信息通过此回调URL发送给应用服务器。
// String callbackUrl = "https://192.168.0.0:8888";
// 设置上传到OSS文件的前缀,可置空此项。置空后,文件将上传至Bucket的根目录下。
SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd");
String date = simpleDateFormat.format(new Date());
String dir = "自定义前缀" + date + "/"; //设置文件名称
// 创建OSSClient实例。
OSS ossClient = new OSSClientBuilder().build(endpoint, accessId, accessKeySecret);
try {
long expireTime = 30;
long expireEndTime = System.currentTimeMillis() + expireTime * 1000;
Date expiration = new Date(expireEndTime);
// PostObject请求最大可支持的文件大小为5 GB,即CONTENT_LENGTH_RANGE为5*1024*1024*1024。
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);
Map<String, String> 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));
// respMap.put("expire", formatISO8601Date(expiration));
return respMap;
} catch (Exception e) {
// Assert.fail(e.getMessage());
System.out.println(e.getMessage());
} finally {
ossClient.shutdown();
}
return null;
}
注: 根据需求更改我们的配置,
另外如果出现
4.启动服务器运行测试
这里我们成功的话可以看到,前端收到了我们的Oss信息
5.在我们的Vue程序中创建一个组件ossUpload.vue
6.这里我们根据element-ui官方文档提供的vue模板,注意需要引入element-ui
<el-upload
class="upload-demo"
action="https://jsonplaceholder.typicode.com/posts/"
:file-list="fileList"
list-type="picture">
<el-button size="small" type="primary">点击上传</el-button>
<div slot="tip" class="el-upload__tip">只能上传jpg/png文件,且不超过500kb</div>
</el-upload>
<script>
export default {
data() {
return {
fileList: [{name: 'food.jpeg', url: 'https://fuss10.elemecdn.com/3/63/4e7f3a15429bfda99bce42a18cdd1jpeg.jpeg?imageMogr2/thumbnail/360x360/format/webp/quality/100'}, {name: 'food2.jpeg', url: 'https://fuss10.elemecdn.com/3/63/4e7f3a15429bfda99bce42a18cdd1jpeg.jpeg?imageMogr2/thumbnail/360x360/format/webp/quality/100'}]
};
},
methods: {
handleRemove(file, fileList) {
console.log(file, fileList);
},
handlePreview(file) {
console.log(file);
}
}
}
</script>
7.绑定数据
<template>
<el-upload
class="upload-demo"
:action="objData.host"
:file-list="fileList"
:before-upload="ossPolicy"
:data="objData"
list-type="picture">
<el-button size="small" type="primary">点击上传</el-button>
<div slot="tip" class="el-upload__tip">只能上传jpg/png文件,且不超过500kb</div>
</el-upload>
</template>
<script>
export default {
data() {
return {
fileList: [{name: 'food.jpeg',
url: 'https://fuss10.elemecdn.com/3/63/4e7f3a15429bfda99bce42a18cdd1jpeg.jpeg?imageMogr2/thumbnail/360x360/format/webp/quality/100'},
{name: 'food2.jpeg',
url: 'https://fuss10.elemecdn.com/3/63/4e7f3a15429bfda99bce42a18cdd1jpeg.jpeg?imageMogr2/thumbnail/360x360/format/webp/quality/100'}],
objData:{
OssAccessKeyId:'',
policy:'',
signature:'',
key:'',
host:'',
dir:'',
}
};
},
methods: {
ossPolicy(file){
let _self = this
//在上传前进行服务器签名
return new Promise((resolve, reject)=>{
//请求后端
this.axios({
method: 'get',
url: 'http://localhost:8088/oss/policy'
}).then(response =>{
_self.objData.OssAccessKeyId = response.data.accessid;
_self.objData.policy = response.data.policy;
_self.objData.signature = response.data.signature;
_self.objData.host = response.data.host;
_self.objData.dir = response.data.dir; //直传oss的服务地址
_self.objData.key = response.data.dir + "${filename}";
resolve(true);//继续上传
}).catch(function (error){
console.log("错误" + error),
reject(false) //停止上传
});
});
},
handleRemove(file, fileList) {
console.log(file, fileList);
},
handlePreview(file) {
console.log(file);
}
}
}
</script>
<style scoped>
</style>
根据element-ui中的参数说明,我们绑定了
action | 必选参数,上传的地址 | string | — | — |
data | 上传时附带的额外参数 | object | — | — |
在上传之前获取axios传递的后端oss信息
before-upload | 上传文件之前的钩子,参数为上传的文件,若返回 false 或者返回 Promise 且被 reject,则停止上传。 |
8.这时,我们可以点击上传,,上传我们的文件,然后查看bucket库中的文件,发现我们完成了上传
特别注意:
- 如果出现了跨域问题,我们需要在controller的policy方法中添加@CrossOrigin注解
- 注意我们的host需要前后端一直,不能有空格!
- 注意各个配置的大小写是否一致!