云平台对象存储OSS

文件存储是我们项目中经常要用到的能力，一般处理方法有如下几种：

1. 以文件的方式存储到服务器上，这种情况适合小规模存储需求，是服务和存储一体化的解决方案，存在的弊病就是耦合性过大，不容易扩展。
2. 借助一些第三方存储系统存储，例如数据库、分布式文件系统等，这样的方案系统耦合性低、扩展性强，也是目前系统架构中常用的方式，但是对第三方系统的运维有较高要求。
3. 利用成熟的云平台存储服务。目前市场上知名的云服务平台都有此服务，这样的解决方案除了具备分布式存储的诸多优点外，最重要的是免维护，开发、调试、运营、运维成本都很低，而且服务稳定可靠。今天就以阿里云的OSS服务作以简要介绍。

服务开通

首先要开通阿里云账号，然后开通OSS服务。

OSS控制台

查阅相关开发者指南

阿里云提供了详细的开发者文档，通过这些文档就可以完全掌握如何使用OSS功能。

引入OSS java依赖包

        
        
            com.aliyun.oss
            aliyun-sdk-oss
            3.5.0
        

配置相关参数

本示例遵循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的使用方式。

1. 创建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();
    }

2. 上传文件
   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();
    }

3. 查看已经存储的资源列表

    @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服务，这样可以大大节约项目的实施成本、提高实施效率。