Java概述

在使用Java SDK或阅读本手册之前，请务必先阅读《 OAS API参考手册》（以下简称 [backcolor=transparent]API手册）第一章基本概念和第二章功能简介，了解Vault、Archive、Mupltipart Upload、Job等基础概念以及所支持的操作，这部分内容本手册将不再赘述。
Java SDK，按照封装程度，分为低级接口（低级封装）和高级接口（高级封装）。其中：

1. 低级接口的入口是[backcolor=transparent]OASClient
2. 高级接口的入口是[backcolor=transparent]ArchiveManager

所有接口均有 [backcolor=transparent]同步（阻塞式） 和 [backcolor=transparent]异步（非阻塞式） 两种实现方式。

低级接口


低级接口是OAS接口的初级封装，为用户实现了：OAS服务的签名信息生成、HTTP头部、URL生成等基础功能。它是OAS RESTful接口的直接映射，每一个RESTful接口均对应于低级接口的一个方法。所有低级接口的方法，以[backcolor=transparent]OASRequest作为入参，以[backcolor=transparent]OASResult为返回结果。

高级接口


为了简化用户的开发流程，缩短学习曲线，SDK在低级接口的基础上提供更高级的封装，形成[backcolor=transparent]高级接口，它进一步封装了校验码生成、自动重试、断点续传等复杂功能。用户在使用过程中不需要关心高级接口内部实际调用的是哪个RESTful接口，只需按照所需的业务类型调用接口即可。

使用建议



高级接口 VS. 低级接口


在高级接口和低级接口的选择上，建议用户使用[backcolor=transparent]高级接口，因为：

1. 使用高级接口，会大大提升开发效率、降低代码复杂度、使用户的代码更多地面向业务而不是在和OAS的交互上；
2. 更利于用户程序的稳定，使用高级接口，OAS底层的通信协议变更对用户是透明的，以免OAS接口协议变化时用户再次修改程序；

[backcolor=transparent]当所需功能没有被包含在高级接口内时，才考虑调用低级接口。

同步接口 VS. 异步接口


在同步接口和异步接口的选择上，同步接口会更简单上手，但是对于部分较费时会阻塞程序、降低请求效率。异步接口在使用上相对复杂，但是可有效提高并发量。建议用户在进行上传或下载操作时，使用异步接口，在进行查询操作时使用阻塞接口。

Demo程序


参考 《最佳实践-Java》。