基于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 {
        //上传图片到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;//返回上传后的路径
    }
  }