之前使用过阿里云的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>
的值