阿里云OSS对象存储
- 认识OSS
- 一、创建Bucket
- 二、后台服务接口编写
- 三、接口测试
认识OSS
在实际的项目中，经常要用到上传图片的地方，阿里云的OSS对象存储，可以很好的将我们上传的图片存储到阿里云服务中，数据库只要存储图片的访问地址即可。
下面我们主要来编写后台服务的OSS功能。前端的调用相关后续在讲。一、创建Bucket
这里注册阿里云账号和已经开通OSS对象存储，这里就不再说了，网上有很多的文案。
1. 进入OSS的控制台，在Bucket 管理列表中，可以查看到自己的Bucket 数量，如果已经有了，则不要创建。没有的话，跟着我下面来创建一个Bucket 。
2. 点击创建Bucket ，进入到Bucket基本信息填写表单中。
3.基本信息填写
- 【Bucket名称】 可以随意取，最好跟自己的项目名称有关系的名称，避免后面创建的Bucket多了分不清楚。
- 【地域】可以任意选择，可以根据自己所在区域进行选择。
- 【Endpoint】默认不可修改的，这个后面编写接口的时候要用到。
- 【所属资源组】可以不选择。
- 【存储类型】自己学习用的话，选择“低频访问选择”就可以，如果是企业项目的话，最好选择标准存储。后面的归档类型，主要是存放后就基本不访问的情况。我们这里选择“低频访问选择”。
- 【HDFS服务】/【同城冗余存储】/【版本控制】这些都可以不用开启。
- 【读写权限】选择“公共读”就可以，写的时候，后端接口会进行身份认证校验的。
- 【服务端加密方式】/【实时日志查询】都可以不开通。
创建成功后，就会显示在Bucket 列表中。
二、后台服务接口编写
官网帮助文档：https://help.aliyun.com/document_detail/32009.html
1.安装SDK： 官网提供了三种SKD的安装方式，这里我们使用maven的方式安装。
<dependency>
<groupId>com.aliyun.oss</groupId>
<artifactId>aliyun-sdk-oss</artifactId>
<version>3.15.1</version>
</dependency>2.创建Access Key：在OSS存储对象首页概览中，最右侧中的常用入口有Access Key的入口。如果没有找到，或者在个人中心出的Access Key，也可以进入到Access Key设置页面。
进入会有提示窗口，选择继续即可。
进入到Access Key列表页面，如果创建过Access Key，可以直接使用，无需创建。如果没有，点击创建，进行验证码创建即可。
创建成功后，就会有AccessKey ID和AccessKeySecret，后面后用到。
3.OSS访问常量定义： 在进行文件上传的时候，需要身份的校验，因此我们需要把身份验证的相关信息，定义在配置文件中（yml/properties）。
这里主要用到的几个信息是：endpoint、accessKeyId、accessKeySecret、bucketName。
#配置阿里云oss
aliyun.oss.file.endpoint=你的自己’‘endpoint’‘
aliyun.oss.file.keyid=你自己的’‘accessKeyId’‘
aliyun.oss.file.keysecret=你自己的’‘accessKeySecret’‘
aliyun.oss.file.bucketname=你自己的’‘bucketName’‘如果找不到【endpoint】信息的同学，可以进入你自己【Bucket 列表】，点击Bucket 名称进入到Bucket 的详情页面。选择【概览】，进入页面，下面就会有。选择外网访问中的Endpoint
4.上传逻辑代码：
- 使用Value()注解，注入在配置文件中配的常量参数。
- 在filename文件中，拼接了文件目录字符串，文件目录以每日的格式进行存储。（可选，如果不设置目录的话，所有的图片对象都全部存储在根目录）
- 最后拼接图片访问的url，返回给前端，前端统一封装成实体类，提交给新增/跟新的接口。
@Service
public class OssServiceImpl implements OssService {
@Value("${aliyun.oss.file.endpoint}")
String endpoint;
@Value("${aliyun.oss.file.keyid}")
String accessKeyId;
@Value("${aliyun.oss.file.keysecret}")
String accessKeySecret;
@Value("${aliyun.oss.file.bucketname}")
String bucketName;
@Override
public String uploadFile(MultipartFile file) {
String dir = new SimpleDateFormat("yyyy-MM-dd").format(new Date());
//获取文件名
String filename = dir + "/" + file.getOriginalFilename();
// 创建OSSClient实例。
OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);
try {
//获取文件流
InputStream inputStream = file.getInputStream();
// 创建PutObject请求。
ossClient.putObject(bucketName, filename, inputStream);
//返回拼接后oss访问路径
String url = "https://" + bucketName + "." + endpoint + "/" + filename;
return url;
} catch (OSSException oe) {
System.out.println("Caught an OSSException, which means your request made it to OSS, "
+ "but was rejected with an error response for some reason.");
System.out.println("Error Message:" + oe.getErrorMessage());
System.out.println("Error Code:" + oe.getErrorCode());
System.out.println("Request ID:" + oe.getRequestId());
System.out.println("Host ID:" + oe.getHostId());
return null ;
} catch (ClientException ce) {
System.out.println("Caught an ClientException, which means the client encountered "
+ "a serious internal problem while trying to communicate with OSS, "
+ "such as not being able to access the network.");
System.out.println("Error Message:" + ce.getMessage());
return null;
} catch (IOException e) {
e.printStackTrace();
return null;
} finally {
if (ossClient != null) {
ossClient.shutdown();
}
}
}
}三、接口测试
我这里集成了swagger，直接在swagger-ui中进行测试。
- 重启服务成功。
- 进入swagger-ui，上传图片后，提交。
- 接口返回成功。
- 进入OSS对象存储服务中，也现在了上传的图片。
后面我们只要访问这个URL就可以了。数据库只要存储这个地址。
