JAVA整合阿里云OSS/VUE上传阿里云OSS

前言

今天码帮帮系统已经整合到上传项目案例的功能了，这里有一些图片资源需要上传，之前做项目对接过七牛云，也有使用过阿里云的视频点播服务，不过这次对接阿里云的OSS确实有点小尴尬，感觉文档不是很好对接，因为之前对接过七牛云，所以会有对接七牛云的流程在脑海里！按在七牛云的对接流程是服务端通过accessKeyId、accessKeySecret、endpoint得到签名，然后客户端根据签名上传，当然也有纯客户端的做法，但是作为一个服务端开发者，认为accessKeyId、accessKeySecret这些信息放在客户端，容易暴露出去，不是很安全，所以对接阿里云也是按照这种思路去做的，但是看了阿里云的OSS文档并没有找到这样的流程文档，可能是OSS体系太过庞大了，导致文档太多，没找到吧！那么本文将演示如何通过JAVA服务端生成签名，到VUE客户端上传图片的完整流程！

阿里云相关

开通OSS服务

创建Bucket

注意地域，这玩意一定要记好，不然后面会有坑！那么到这里基本的就差不多了，后面还有跨域、在线预览问题，后面会单独讲！

JAVA整合

导入依赖

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

编写阿里云OSS基本工具

import com.aliyun.oss.OSSClient;
import com.aliyun.oss.common.utils.BinaryUtil;
import com.aliyun.oss.model.GetObjectRequest;
import com.aliyun.oss.model.MatchMode;
import com.aliyun.oss.model.PolicyConditions;
import com.aliyun.oss.model.PutObjectResult;
import lombok.extern.slf4j.Slf4j;
import org.springframework.core.io.ClassPathResource;

import java.io.File;
import java.net.URL;
import java.nio.charset.StandardCharsets;
import java.util.Date;
import java.util.LinkedHashMap;
import java.util.Map;

/**
* @description: 阿里云OSS工具
 * 官方链接地址:https://help.aliyun.com/document_detail/31926.html?spm=a2c4g.11186623.6.1737.5f3e3bd36kleqs
 * 公共云下OSS Region和Endpoint对照表:https://help.aliyun.com/document_detail/31837.htm?spm=a2c4g.11186623.0.0.7b6b2c20Qv3xQw#concept-zt4-cvy-5db
 * 在线预览问题:https://help.aliyun.com/noticelist/articleid/1060057906.html
* @author TAO
* @date 2021/11/30 22:26
*/
@Slf4j
public class AliUtil {

    private static String accessKeyId = "xxx";

    private static String accessKeySecret = "xxx";

    //公共云下OSS Region和Endpoint对照表:https://help.aliyun.com/document_detail/31837.htm?spm=a2c4g.11186623.0.0.7b6b2c20Qv3xQw#concept-zt4-cvy-5db
    private static String endpoint = "oss-cn-beijing.aliyuncs.com";

    /**
     * 获取临时访问OSS签名  前端-用签名的方式上传文件
     * @param bucketName
     * @param dir bucket中的目录
     * @return
     */
    public static Map<String, String> getSignature(String bucketName, String dir) {
        Map<String, String> respMap = new LinkedHashMap<>();
        String endpointForSig = endpoint;
        String host = "https://" + bucketName + "." + endpointForSig;
        OSSClient client = new OSSClient(endpointForSig, accessKeyId, accessKeySecret);
        try {
            //设置过期时间为半小时1800L
            long expireTime = 60 * 30;
            long expireEndTime = System.currentTimeMillis() + expireTime * 1000;
            java.sql.Date expiration = new java.sql.Date(expireEndTime);
            // PostObject请求最大可支持的文件大小为5 GB，即CONTENT_LENGTH_RANGE为5*1024*1024*1024。
            PolicyConditions policyConditions = new PolicyConditions();
            policyConditions.addConditionItem(PolicyConditions.COND_CONTENT_LENGTH_RANGE, 0, 1048576000);
            policyConditions.addConditionItem(MatchMode.StartWith, PolicyConditions.COND_KEY, dir);
            String postPolicy = client.generatePostPolicy(expiration, policyConditions);
            byte[] binaryData = postPolicy.getBytes(StandardCharsets.UTF_8);
            String encodedPolicy = BinaryUtil.toBase64String(binaryData);
            String postSignature = client.calculatePostSignature(postPolicy);
            respMap.put("accessid", accessKeyId);
            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) {
            log.info("获取阿里云OSS签名失败===>{}", e.getMessage());
        }
        return respMap;
    }

    public static Map<String, String> getSignature(String bucketName) {
        return getSignature(bucketName, "");
    }

    /**
     * 上传文件
     * @param bucketName
     * @param fileName 文件名
     * @param file 文件
     */
    public static void uploadFile(String bucketName, String fileName, File file) {
        // 创建OSSClient实例
        OSSClient ossClient = new OSSClient(endpoint, accessKeyId, accessKeySecret);
        // 上传文件
        PutObjectResult putObjectResult = ossClient.putObject(bucketName, fileName, file);
        String eTag = putObjectResult.getETag();
        log.info("eTag===>", eTag);
        // 关闭client
        ossClient.shutdown();
    }

    /**
     * 从OSS下载文件，将文件存储在项目tmp目录下，文件名是时间戳
     * @param objectName objectName oss文件名
     * @param bucketName 文件本地存储路径
     * @return
     */
    public static String downloadFileFromOSS(String objectName, String bucketName) {
        String resource;
        String OS = System.getProperty("os.name").toLowerCase();
        if (OS.equals("linux")) {
            resource = new ClassPathResource("/background/template_bg_image.jpg").getPath();

        } else {
            resource = AliUtil.class.getClassLoader().getResource("background/template_bg_image.jpg").getPath();
        }
        // 创建OSSClient实例
        OSSClient ossClient = new OSSClient(endpoint, accessKeyId, accessKeySecret);
        // 填写不包含Bucket名称在内的Object完整路径，例如testfolder/exampleobject.txt。
        ossClient.getObject(new GetObjectRequest(bucketName, objectName), new File(resource));
        ossClient.shutdown();
        return resource;
    }

    /***
     * 获取下载地址
     */
    public static String getDownUrl(String key, String bucket) {
        OSSClient client = new OSSClient(endpoint, accessKeyId, accessKeySecret);
        //判断文件是否存在
        // 设置URL过期时间为10年
        Date expiration = new Date(System.currentTimeMillis() + 3600L * 1000 * 24 * 10 * 365);
        // 生成URL
        URL url = client.generatePresignedUrl(bucket, key, expiration);
        client.shutdown();
        String s = url.toString().substring(0, url.toString().indexOf("?"));
        //生产环境中，OSS地址为内网地址，在此处转成外网地址
        if (s.contains("-internal")) {
            s = s.replace("-internal", "");
        }
        return s;
    }

    public static void main(String[] args) {
        String bucketName = "你的bucketName";
        File file = new File("C:\\Users\\Administrator\\Desktop\\test.png");
        String fileName = "tttyyy.jpg";
        Map<String, String> signature = AliUtil.getSignature(bucketName);
        log.info("signature===>",signature.toString());
        AliUtil.uploadFile(bucketName, fileName, file);
    }

}

编写controller

    @GetMapping("/getOssSignature")
    @ApiOperation(value = "获取阿里云oss签名", authorizations = @Authorization(value = "token"))
    public R getSkillByType(){
        Map<String, String> signature = AliUtil.getSignature("你的bucketName");
        return R.ok(signature);
    }

请求测试

完成，这里也可自行测试java的main方法启动上传图片，亲测有效！

VUE对接阿里云OSS

VUE这里直接使用element的el-upload作为上传组件！

el-upload

<el-upload class="upload-demo" drag  list-type="picture-card" :on-preview="handlePictureCardPreview"
 :on-remove="handleRemove" :http-request="fileUpload"  action="https://jsonplaceholder.typicode.com/posts/"
    multiple>el-upload>

其他代码

let axios = require('axios')

data(){
	return{
	    dialogImageUrl: '',
	    dialogVisible: false
	}
},
methods:{
	handleRemove (file, fileList) {
        console.log(file, fileList)
    },
    handlePictureCardPreview (file) {
        this.dialogImageUrl = file.url
        this.dialogVisible = true
    }
}

核心代码

fileUpload(param){
	let file = param.file // 得到文件的内容
    console.log("===>",file);
    getOssSignature().then(res =>{
	    console.log("res===>",res);
	    let sendData = new FormData();
        sendData.append('OSSAccessKeyId', res.accessid);
        sendData.append('policy', res.policy);
        sendData.append('Signature', res.signature);
        sendData.append('keys', res.dir);
        sendData.append('key',file.name)
        sendData.append('success_action_status', 200) // 指定返回的状态码
        sendData.append('file', file)
        axios.post(res.host, sendData).then(() => {
            console.log('得到上传到阿里云的图片地址：  ' + res.host+file.name)
        })
  	}).catch(err =>{
			console.error("获取签名失败！！！")
    });
}

那么到这里VUE客户端代码就完成了！但是还有两个问题,一个是跨域如下！

另一个是在线预览，如下

跨域问题

修改CORS

在线预览

这个问题我就不多说了，让官网自己回答吧！OSS升级通知