JDK 1.6 及以上

背景信息

开发包下载,请联系产品团队。

Maven中央库依赖配置

<dependency>
    <groupId>com.aliyun.oas</groupId>
    <artifactId>aliyun-oas</artifactId>
    <version>[VERSION]</version>
</dependency>

三方依赖(发布包内已包含)

  • async-http-client-1.8.12.jar
  • hamcrest-all-1.3.jar
  • json-smart-1.2.jar
  • junit-4.11.jar
  • littleproxy-1.0.0-beta8.jar
  • log4j-1.2.17.jar
  • netty-3.9.2.Final.jar
  • slf4j-api-1.7.5.jar
  • slf4j-log4j12-1.7.2.jar
  • snakeyaml-1.13.jar

必要的配置

  • 得到OAS API的服务接入地址:
    • 公网:[ RegionName ].oas.aliyuncs.com
    • 阿里云内网:[ RegionName ].oas-internal.aliyuncs.com
  • 访问OAS服务时,配置您的AccessKeyId和AccessKeySecret

其中,[ RegionName ]取值为: cn-hangzhou、cn-qingdao、cn-beijing、cn-hongkong等。更多详细说明,请参考《OAS API参考手册

配置示例:

//配置OAS API服务地址
ServiceHost serviceHost = new ServiceHost("http://cn-hangzhou.oas.aliyuncs.com", 80);
//用AccessKeyId和AccessKeySecret初始化认证信息
ServiceCredentials credentials = new ServiceCredentials(yourAccessKeyId,
    yourAccessKeySecret);
//客户端基础配置
ClientConfiguration clientConfiguration = new ClientConfiguration();
//实例化API对象
AliyunOASClient aliyunOASClient = OASFactory
    .aliyunOASClientFactory(serviceHost, credentials, clientConfiguration).withLogger();
....

更新日志

版本 0.2.2

  • 新增PushToOss、PullFromOss高级接口
  • bugfix:ConcurrentHashMap在 jdk 1.6/1.7/1.8 中keySet()表征不一样,导致下载出错,统一用keys()取代

版本 0.2.1

  • 新增OAS商业化中数据加密方法TreeEtag的支持及计算工具TreeEtagGenerator
  • 增加QueryManager作为查询接口,可查询Vault列表、Job列表等
  • 增加OASFactory工厂类,作为所有低级接口、高级接口对象实例化的入口
  • 增加用户对多线程数量的设置,默认为3,最大为10
  • 增加ServiceHost对象,作为OAS服务地址、端口的配置封装
  • 修复在流式上传时IdleTimeOut的bug报错
  • 更多的Java注释方便用户查阅

版本 0.1.3

  • 高级下载接口中的每一分块的 IO 线程和计算线程合并为一个,减少内存使用
  • ArchiveManager 增加静态方法 getVaultIdFromName
  • 修复 DownloadManager 在下载 Inventory 创建文件失败的问题
  • 高级接口中多段上传时使用线程池计算哈希值,减少计算时间
  • 高级接口默认并发数从20减少至10
  • 修复当高级接口的 waitUntilFinished 方法抛出异常时,部分线程没有正常退出的问题
  • JobMonitor 增加两个静态构造方法,分别为 createByVaultNameAndJobId 和 createByVaultIdAndJobId
  • InitiateMultipartUploadRequest 部分变量的访问权限修正为私有
  • 增加零字节文件上传的校验

版本 0.1.2

  • 修复 10GB 以上文件下载报错问题
  • 修复 ECS 环境下多段上传可能失败的问题

版本 0.1.1

  • 修复文件超过 64GB 时高级接口分段大小计算错误的 BUG

版本 0.1.0

  • 初始发布