文件存储是我们项目中经常要用到的能力，一般处理方法有如下几种：
- 以文件的方式存储到服务器上，这种情况适合小规模存储需求，是服务和存储一体化的解决方案，存在的弊病就是耦合性过大，不容易扩展。
- 借助一些第三方存储系统存储，例如数据库、分布式文件系统等，这样的方案系统耦合性低、扩展性强，也是目前系统架构中常用的方式，但是对第三方系统的运维有较高要求。
- 利用成熟的云平台存储服务。目前市场上知名的云服务平台都有此服务，这样的解决方案除了具备分布式存储的诸多优点外，最重要的是免维护，开发、调试、运营、运维成本都很低，而且服务稳定可靠。今天就以阿里云的OSS服务作以简要介绍。
服务开通
首先要开通阿里云账号，然后开通OSS服务。
OSS控制台
查阅相关开发者指南
阿里云提供了详细的开发者文档，通过这些文档就可以完全掌握如何使用OSS功能。
引入OSS java依赖包
<!-- 阿里云OSS依赖包 -->
<dependency>
<groupId>com.aliyun.oss</groupId>
<artifactId>aliyun-sdk-oss</artifactId>
<version>3.5.0</version>
</dependency>
配置相关参数
本示例遵循consul微服务的基本架构，配置参数全部以Key/Value的方式存储到consul配置中心。
OSS接入参数
对应的java配置属性bean为：
package com.crazyice.lee.accumulation.file.conf;
import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
@Data
@ConfigurationProperties(prefix = "oss")
public class OssConf {
private String endpoint;
private String accessKeyId;
private String accessKeySecret;
private String bucketName;
}
接口调用测试
阿里云OSS除了提供bucket创建、各种对象上传/下载、资源列表、删除等基本功能外，还包括了图像处理、ACL、自定义域名、数据备份迁移、资源管理工具等辅助能力。这里通过JUnitTest演示几个典型功能来简要说明一下OSS API的使用方式。
-
创建bucket
bucket是一个根存储节点，你的对象资源都存储在你定义的bucket下，通过控制台创建该bucket。
创建bucket
1.1 首先把配置bean注入到测试类中。
@Autowired
private OssConf ossConf;
1.2 测试创建bucket
@Test
public void testOssCreateBucket(){
// 创建OSSClient实例。
OSS ossClient = new OSSClientBuilder().build(ossConf.getEndpoint(), ossConf.getAccessKeyId(), ossConf.getAccessKeySecret());
// 创建存储空间。
ossClient.createBucket(ossConf.getBucketName());
// 关闭OSSClient。
ossClient.shutdown();
}
- 上传文件
OSS服务提供了多种上传文件的方式，有流方式、有文件方式，这里演示一下本地文件方式。
@Test
public void testOssUploadFile(){
// 创建OSSClient实例。
OSS ossClient = new OSSClientBuilder().build(ossConf.getEndpoint(), ossConf.getAccessKeyId(), ossConf.getAccessKeySecret());
// 上传本地文件
ossClient.putObject(ossConf.getBucketName(),"test1",new File("/Users/crazyicelee/wordcount.txt"));
// 关闭OSSClient。
ossClient.shutdown();
}
- 查看已经存储的资源列表
@Test
public void testOssList(){
// 创建OSSClient实例。
OSS ossClient = new OSSClientBuilder().build(ossConf.getEndpoint(), ossConf.getAccessKeyId(), ossConf.getAccessKeySecret());
// 获取资源列表
ObjectListing objectListing=ossClient.listObjects(ossConf.getBucketName());
for(OSSObjectSummary ossObjectSummary:objectListing.getObjectSummaries()){
log.info("云存储对象：{}-{}",ossObjectSummary.getKey(),ossObjectSummary.getSize());
}
// 关闭OSSClient。
ossClient.shutdown();
}
控制台管理OSS
阿里云既提供了API方式使用这些功能，也提供了控制台方式管理你的云端资源，功能全面，操作简单，本文就不赘述，大家感兴趣可以自行了解。
从以上代码示例大家可以看出，使用阿里云的OSS非常简洁，如果你的项目对云存储没有特殊的要求可以考虑使用公有云平台的OSS服务，这样可以大大节约项目的实施成本、提高实施效率。
