阿里云oss 上传图片

之前使用过阿里云的oss储存服务，也写了一个上传图片的代码，但是最近在写东西的时候发现对这方面又比较陌生，而且发现在官网找文档也有点费劲，所以把代码写出来之后特地写个博客记录一下，以防以后还需要用到。

首先在官方文档中https://help.aliyun.com/document_detail/84781.html
找到简单上传中的文件流上传

可以根据这段代码进行改善，成为自己需要的代码。
阿里云oss上传文件之前需要开通这个服务并且创建一个bucket，这方面的创建可以结合文档创建适合自己的bucket。我这边因为图片上传一般是用作用户头像或者博客文章之类的图片，所以选择的是低频访问储存

oss对象上传代码的最后一句代码：

ossClient.putObject("<yourBucketName>", "<yourObjectName>", inputStream);

<yourObjectName> 是上传的文件在bucket的哪个文件夹下，bucket相当于一个文件夹储存你的文件，然后你可以自己利用某种规则对文件进行分文件夹，以至于上传的文件不会太杂乱，我下面的代码是以每年/每月--每日/文件名这样储存文件的 eg: 2020/12-01/01.png
这样就可以做到每天的文件夹在一个文件夹

简单来说<yourObjectName>就是一个路径

下面就是上传文件的代码可以自行根据需求改善
service层

package com.sixteen.blog.service.impl;

import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;
import com.sixteen.blog.service.OssService;
import com.sixteen.blog.utils.AliyunOssConstant;
import org.joda.time.DateTime;
import org.springframework.stereotype.Service;
import org.springframework.web.multipart.MultipartFile;

import java.io.IOException;
import java.io.InputStream;
import java.util.UUID;

@Service
public class OssServiceImpl implements OssService {
    //上传头像，返回阿里云OSS的头像的url，具体实现
    @Override
    public String uploadAvatar(MultipartFile file) {
        // Endpoint以杭州为例，其它Region请按实际情况填写。
        String endpoint = AliyunOssConstant.END_POINT;
        String accessKeyId = AliyunOssConstant.KEY_ID;
        String accessKeySecret = AliyunOssConstant.KEY_SECRET;
        String bucketName = AliyunOssConstant.BUCKET_NAME;

        try {
            // 创建OSSClient实例。
            OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);

            // 获取上传文件的输入流。
            //通过传过来的file的getInputStream方法获取inputStream
            InputStream inputStream = file.getInputStream();
            //获取文件名称
            String fileName = file.getOriginalFilename();
            /**
             * 1.解决上传同一文件而被新上传的覆盖，使用uuid进行拼接文件名使文件名唯一
             * 2.解决上传文件分类问题，根据时间进行分类
             */
            // 将uuid 转为string 并且把-去除
            String uuid = UUID.randomUUID().toString().replaceAll("-", "");
            fileName = uuid + fileName;

            /**
             * 使用的依赖是：
             * <dependency>
             *    <groupId>joda-time</groupId>
             *    <artifactId>joda-time</artifactId>
             *</dependency>
             * new DateTime().toString(),toString()传入日期规则
             * yyyy/MM-dd   形成 年为一个文件夹，月-日为一个文件夹
             */
            String date = new DateTime().toString("yyyy/MM-dd");

            //  2019/7-30/xdyguhn41601.jpg
            String filePath = date + "/" +  fileName;

            /**
             * 第一个参数    bucket名字
             * 第二个参数    上传文件到阿里云OSS的文件路径和文件名称，filePath = path + fileName
             *              eg:/a/b/c.jpg
             * 第三个参数    是文件输入流
             */
            ossClient.putObject(bucketName, filePath, inputStream);

            // 关闭OSSClient。
            ossClient.shutdown();
            // https://six-teen.oss-cn-beijing.aliyuncs.com/favicon.png
            // 即https:// + bucketName +. +endpoint + / +文件名
            String url = "https://" + bucketName + "." + endpoint + "/" + filePath;
            return url;
        } catch (Exception e) {
            e.printStackTrace();
            return null;
        }
    }
}

像accessKeyId 这种信息我是在springboot的配置文件中储存，利用@ConfigurationProperties注解进行属性值的注入
service层的AliyunOssConstant是一个工具类，就是用来储存accessKeyId 这样的信息
AliyunOssConstant

package com.sixteen.blog.utils;

import lombok.Data;
import org.springframework.beans.factory.InitializingBean;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

@ConfigurationProperties(prefix = "aliyun.oss")
@Component
@Data
public class AliyunOssConstant implements InitializingBean {
    private String endPoint;
    private String keyId;
    private String keySecret;
    private String bucketName;

    public static String END_POINT;
    public static String KEY_ID;
    public static String KEY_SECRET;
    public static String BUCKET_NAME;
    //在给上面属性通过配置文件注入值之后，定义static变量，让外界直接用类名.的方式获取属性
    //此方法在上面私有属性被注入值之后，可以执行下面的方法
    @Override
    public void afterPropertiesSet() throws Exception {
        END_POINT = endPoint;
        KEY_ID = keyId;
        KEY_SECRET = keySecret;
        BUCKET_NAME = bucketName;
    }
}

在配置文件中
application.yml

aliyun:
  oss:
    end-point: 你的endPoint
    key-id: 你的accessKeyId
    key-secret: 你的accessKeySecret
    bucket-name: 你的bucketName

这边提一句，如果工具类的属性正常的命名方式像这种 endPoint这样的话，在配置文件中可以 end-point 这样赋值。

最后就是controller层了
controller

package com.sixteen.blog.controller;

import com.sixteen.blog.common.R;
import com.sixteen.blog.service.OssService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.util.StringUtils;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;

@RestController
@CrossOrigin
@RequestMapping("/blog/file")
public class OssController {
    @Autowired
    private OssService ossService;
    /**
     * MultipartFile file 即接收上传的文件
     * @param file
     * @return
     */
    @PostMapping("/upload")
    public R uploadFile(MultipartFile file){
        String url = ossService.uploadFileToAliyun(file);
        //如果url为空，就返回错误，如果 不为空就返回成功并返回数据
        return StringUtils.isEmpty(url) ? R.error():R.ok().data("url",url);
    }
}

通过上传文件，然后自己拼接图片的url 返回出去
上传的文件的访问链接：
"https://"+bucketName+"."+endpoint+"/"+filePath;
filePath 就是oss上传文件时 <yourObjectName>的值