概述
更新时间:
在使用Java SDK或阅读本手册之前,请务必先阅读《OAS API参考手册》(以下简称 API手册)第一章基本概念和第二章功能简介,了解Vault、Archive、Mupltipart Upload、Job等基础概念以及所支持的操作,这部分内容本手册将不再赘述。
Java SDK,按照封装程度,分为低级接口(低级封装)和高级接口(高级封装)。其中:
- 低级接口的入口是OASClient
- 高级接口的入口是ArchiveManager
所有接口均有 同步(阻塞式) 和 异步(非阻塞式) 两种实现方式。
低级接口
低级接口是OAS接口的初级封装,为用户实现了:OAS服务的签名信息生成、HTTP头部、URL生成等基础功能。它是OAS RESTful接口的直接映射,每一个RESTful接口均对应于低级接口的一个方法。所有低级接口的方法,以OASRequest作为入参,以OASResult为返回结果。
高级接口
为了简化用户的开发流程,缩短学习曲线,SDK在低级接口的基础上提供更高级的封装,形成高级接口,它进一步封装了校验码生成、自动重试、断点续传等复杂功能。用户在使用过程中不需要关心高级接口内部实际调用的是哪个RESTful接口,只需按照所需的业务类型调用接口即可。
使用建议
高级接口 VS. 低级接口
在高级接口和低级接口的选择上,建议用户使用高级接口,因为:
- 使用高级接口,会大大提升开发效率、降低代码复杂度、使用户的代码更多地面向业务而不是在和OAS的交互上;
- 更利于用户程序的稳定,使用高级接口,OAS底层的通信协议变更对用户是透明的,以免OAS接口协议变化时用户再次修改程序;
当所需功能没有被包含在高级接口内时,才考虑调用低级接口。
同步接口 VS. 异步接口
在同步接口和异步接口的选择上,同步接口会更简单上手,但是对于部分较费时会阻塞程序、降低请求效率。异步接口在使用上相对复杂,但是可有效提高并发量。建议用户在进行上传或下载操作时,使用异步接口,在进行查询操作时使用阻塞接口。
Demo程序
参考《最佳实践-Java》。
文档内容是否对您有帮助?