使用前须知(Java SDK)
本文介绍Java SDK的版本变更,并提供版本兼容性说明,以及其他使用前须知。
变更说明
如表1所示,本节将为您展示Java SDK的版本变更情况和兼容性说明。
版本 |
变更类型 |
说明 |
是否兼容 |
---|---|---|---|
新功能 适配第三方组件 |
新功能:
适配第三方组件:
|
- |
|
新功能 适配第三方组件 |
新功能:
适配第三方组件:
|
是 |
|
新功能 |
新功能:
|
是 |
|
新功能 适配第三方组件 |
新功能:
适配第三方组件:
|
是 |
|
新功能 适配第三方组件 |
新功能:
适配第三方组件:
|
是 |
|
适配第三方组件 |
|
是 |
|
适配第三方组件 |
使用 log4j2 2.17.0 替代 log4j2 2.16.0 |
是 |
|
v3.21.11 |
新功能 适配第三方组件 |
新功能:
适配第三方组件:
|
是 |
低于v3.21.11(停止配套,EOM) |
- |
|
- |
完整的版本变更情况请参见:ChangeLog。
兼容性说明
- 推荐使用的JDK版本:JDK 8及以上版本。
- 旧版本(2.x)已不再维护,建议尽快升级至最新版。
其他使用前须知
- 本文档是与OBS SDK配套的参考文档,为了您能更好的使用Java SDK,推荐前往下载与安装SDK(Java SDK)下载最新版本的Java SDK。
- 请确认您已经熟悉OBS的基本概念,如桶(Bucket)、对象(Object)、访问密钥(AK和SK)、终端节点(Endpoint)和访问域名等。
- 您可以先参考OBS客户端通用示例,了解OBS Java SDK接口调用的通用方式。
- 使用OBS客户端进行接口调用操作完成后,没有异常抛出,则表明返回值有效;如果抛出异常,则说明操作失败,此时可从SDK自定义异常实例中获取错误信息。
- 使用OBS客户端进行接口调用成功后,均会返回包含响应头信息的SDK公共响应头实例(或其子类实例)。
- 当前各区域特性开放不一致,部分特性只在部分区域开放,使用过程中如果接口HTTP状态码为405,请确认该区域是否支持该功能特性。您可以查看功能总览确认区域是否支持该功能特性,或者提交工单寻求技术支持。