摘要：添加快速集成的對象存儲服務，提供常用的文件操作方法，當然也提供自定義擴展，以致于滿足絕大數(shù)業(yè)務場景，并且通過擴展可以實現(xiàn)上傳文件進度條下載文件進度條存儲空間操作靜態(tài)網(wǎng)站托管訪問日志防盜鏈分片上傳追加上傳斷點續(xù)傳等等。

ApiBoot是一款基于SpringBoot1.x，2.x的接口服務集成基礎框架， 內部提供了框架的封裝集成、使用擴展、自動化完成配置，讓接口開發(fā)者可以選著性完成開箱即用， 不再為搭建接口框架而犯愁，從而極大的提高開發(fā)效率。

ApiBoot添加快速集成Aliyun的對象存儲服務Oss，提供常用的文件操作方法，當然也提供自定義擴展，以致于滿足絕大數(shù)業(yè)務場景，并且通過擴展可以實現(xiàn)上傳文件進度條、下載文件進度條、存儲空間操作、靜態(tài)網(wǎng)站托管、訪問日志、防盜鏈、分片上傳、追加上傳、斷點續(xù)傳等等。

在pom.xml配置文件內添加依賴，如下所示：

    org.minbox.framework
    api-boot-starter-alibaba-oss

ApiBoot所提供的依賴都不需要添加版本號，具體查看ApiBoot版本依賴

在使用ApiBoot Oss時，只需要注入ApiBootOssService類就可以完成默認方法的使用，如下所示：

@Autowired
private ApiBootOssService apiBootOssService;

/**
  * 流方式上傳
  */
@Test
public void uploadBytes() {
  ApiBootObjectStorageResponse response = apiBootOssService.upload("admin.txt", "admin".getBytes());
  logger.info("文件名稱：{}", response.getObjectName());
  logger.info("文件訪問路徑：{}", response.getObjectUrl());
}

/**
* 本地文件上傳
*/
@Test
public void uploadFile() {
    ApiBootObjectStorageResponse response = apiBootOssService.upload("logo.png", "/Users/yuqiyu/Downloads/logo.png");
    logger.info("文件名稱：{}", response.getObjectName());
    logger.info("文件訪問路徑：{}", response.getObjectUrl());
}

/**
* 文件流方式上傳
*
* @throws Exception
*/
@Test
public void uploadInputStream() throws Exception {
    FileInputStream inputStream = new FileInputStream(new File("/Users/yuqiyu/Downloads/logo.png"));
    ApiBootObjectStorageResponse response = apiBootOssService.upload("測試.png", inputStream);
    logger.info("文件名稱：{}", response.getObjectName());
    logger.info("文件訪問路徑：{}", response.getObjectUrl());
}

通過文件的輸入流完成對象存儲文件的上傳

/**
  * 下載文件
  */
@Test
public void download() {
  apiBootOssOverrideService.download("測試.png", "/Users/yuqiyu/Downloads/測試.png");
}

在上面的示例中，文件會自動下載到/Users/yuqiyu/Downloads/目錄下，文件名稱為測試.png。

/**
* 刪除文件示例
*/
@Test
public void delete() {
    apiBootOssOverrideService.delete("測試.png");
}

刪除對象存儲空間內的文件時只需要傳遞文件名即可。

如果你是通過SpringMvc提供的MultipartFile對象進行上傳文件，可以通過如下示例進行上傳：

MultipartFile multipartFile = ..;
// 流方式上傳
ApiBootObjectStorageResponse responseByte = apiBootOssService.upload("測試.png", multipartFile.getBytes());
// 文件輸入流方式上傳
ApiBootObjectStorageResponse responseIs = apiBootOssService.upload("測試.png", multipartFile.getInputStream());

ApiBoot Alibaba Oss提供的方法畢竟是有限的，因此ApiBoot提供了自定義的擴展方式，讓使用者可以根據(jù)Oss官方文檔進行擴展，包含上傳文件進度條、下載文件進度條、存儲空間操作、靜態(tài)網(wǎng)站托管、訪問日志、防盜鏈、分片上傳、追加上傳、斷點續(xù)傳等等。

自定義擴展首先需要創(chuàng)建類并繼承ApiBootOssService，如下所示：

//...
public class ApiBootOssOverrideService extends ApiBootOssService {
    /**
     * logger instance
     */
    static Logger logger = LoggerFactory.getLogger(ApiBootOssOverrideService.class);

    /**
     * 實現(xiàn)父類構造函數(shù)
     *
     * @param endpoint        外網(wǎng)節(jié)點
     * @param bucketName      存儲空間名稱
     * @param accessKeyId     阿里云賬號授權Id
     * @param accessKeySecret 阿里云賬號授權Secret
     * @param domain          自定義域名
     */
    public ApiBootOssOverrideService(String endpoint, String bucketName, String accessKeyId, String accessKeySecret, String domain) {
        super(endpoint, bucketName, accessKeyId, accessKeySecret, domain);
    }

    /**
     * 創(chuàng)建bucket存儲
     *
     * @param bucketName 存儲名稱
     */
    public void createBucket(String bucketName) {
        OSSClient ossClient = getOssClient();
        Bucket bucket = ossClient.createBucket(bucketName);
        logger.info("新創(chuàng)建存儲空間名稱：{}", bucket.getName());
        logger.info("新創(chuàng)建存儲空間所屬人：{}", bucket.getOwner().getDisplayName());
        closeOssClient(ossClient);
    }
}

如上createBucket方法所示ApiBootOssService內部提供了獲取OssClient以及關閉OssClient連接的方法，可以直接調用。

擴展生效

我們自定義的擴展，需要將實例放入SpringIOC容器內，方便我們在使用處進行注入，要注意，由于構造函數(shù)參數(shù)的原因，無法直接通過@Service或者@Component注解進行標注，需要通過如下方式：

//...
@Bean
@ConditionalOnMissingBean
ApiBootOssOverrideService apiBootOssOverrideService(ApiBootOssProperties apiBootOssProperties) {
  return new ApiBootOssOverrideService(apiBootOssProperties.getRegion().getEndpoint(), apiBootOssProperties.getBucketName(), apiBootOssProperties.getAccessKeyId(), apiBootOssProperties.getAccessKeySecret(), apiBootOssProperties.getDomain());
}

ApiBootOssProperties屬性配置類，是ApiBoot內置的，可以在任意地方進行注入，這里目的只是為了拿到相關配置進行構造參數(shù)實例化使用。

本章源碼地址：https://github.com/hengboy/api-boot/tree/master/api-boot-samples/api-boot-sample-alibaba-oss