# 使用前须知(Java SDK) ![](https://support.huaweicloud.com/sdk-java-devg-obs/public_sys-resources/note_3.0-zh-cn.png) OBS SDK合规使用指南请[单击此处](https://github.com/huaweicloud/huaweicloud-sdk-java-obs/blob/master/开发者合规指南.md)；OBS SDK隐私声明请[单击此处](https://github.com/huaweicloud/huaweicloud-sdk-java-obs/blob/master/隐私政策声明.md)。 本文介绍Java SDK的版本变更，并提供版本兼容性说明，以及其他使用前须知。 #### 变更说明 如[表1]所示，本节将为您展示Java SDK的版本变更情况和兼容性说明。 表1Java SDK版本变更及兼容性说明 | **版本** | **变更类型** | **说明** | **是否兼容** | |:---|:---|:---|:---| | [v3.26.6](https://github.com/huaweicloud/huaweicloud-sdk-java-obs/releases/tag/v3.26.6) | - 新功能 - 文档优化 | 新增功能： - [支持桶在线解压策略特性](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_4503.html) - [支持桶DIS策略特性](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_4507.html) - [支持镜像回源特性](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_4507.html) - [支持WORM特性](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_4500.html) - [支持归档直读功能](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_3324.html) - [支持桶加密配置](https://support.huaweicloud.com/sdk-java-devg-obs/obs_23_1735.html) 文档优化： - [支持下载对象时限速](https://support.huaweicloud.com/sdk-java-devg-obs/obs_23_1714.html) - [优化上传段支持流式上传相关内容](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0616.html) - [优化依赖缺失和依赖冲突的解决方法](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0303.html) - [优化列举分段上传任务相关内容](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0621.html) - [优化获取上传对象进度的内容](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0604.html) - [优化有关发送请求时添加自定义头域相关内容](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2304.html) - [优化批量删除文件夹下的所有对象相关内容](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0809.html) - [补充通过临时URL访问OBS的代码示例](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0901.html) - [优化传输时校验文件一致性的内容](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0624.html) - [补充上传base64编码图片的代码示例](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0602.html) - [补充设置、获取、删除对象标签的代码示例](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_3349.html) - [补充如何配置OkhttpEventListener日志与打印详细阶段日志](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_4522.html) - [补充使用断点续传上传时设置上传回调的代码示例](https://support.huaweicloud.com/sdk-java-devg-obs/obs_23_1716.html) | 是 | | [v3.25.10](https://github.com/huaweicloud/huaweicloud-sdk-java-obs/releases/tag/v3.25.10) | 新功能 | 新功能： - 支持并行文件系统快照特性 - 支持桶qos特性 - 支持生命周期2.0 | 是 | | [v3.25.7](https://github.com/huaweicloud/huaweicloud-sdk-java-obs/releases/tag/v3.25.7) | 新功能 | 新功能： - 支持软链接特性 | 是 | | [v3.25.5](https://github.com/huaweicloud/huaweicloud-sdk-java-obs/releases/tag/v3.25.5) | 新功能 | 新功能： - 支持IMDSv2 | 是 | | [v3.25.4](https://github.com/huaweicloud/huaweicloud-sdk-java-obs/releases/tag/v3.25.4) | 新功能 问题修复和优化 | 新功能： - 支持设置okhttp的callTimeout - 支持crr配置中的DeleteData - 支持自定义域名相关配置 问题修复和优化： - 优化了校验ContentType的逻辑 | 是 | | [v3.24.12](https://github.com/huaweicloud/huaweicloud-sdk-java-obs/releases/tag/v3.24.12) | 新功能 | 新功能： - 支持bpa特性 - 支持并行文件系统trash特性 | 是 | | [v3.24.9](https://github.com/huaweicloud/huaweicloud-sdk-java-obs/releases/tag/v3.24.9) | 问题修复和优化 | 问题修复和优化： - 优化合并段的xml构建逻辑 - 优化xml解析逻辑 - 增加时间不正确导致请求失败时的自动重试 - 生命周期规则新增ExpiredObjectDeleteMarker属性 - 修复无法自动添加webp格式的ContentType的问题 | 是 | | [v3.24.8](https://github.com/huaweicloud/huaweicloud-sdk-java-obs/releases/tag/v3.24.8) | 新功能 问题修复和优化 适配第三方组件 | 新功能： - PutObject、GetObject、GetObjectMetadata、UploadPart、AppendObject、CopyObject、CopyPart、CompleteMultipartUpload支持crc64校验 - 断点续传上传支持暂停、取消 - 支持设置okhttp的EventListenerFactory，用于统计http请求各阶段耗时，默认关闭 问题修复和优化： - 优化断点续传上传时的进度条设置逻辑 - 优化部分日志打印格式 - 修复客户端加密只能在obs协议下使用的问题，增加加密算法为null时的判断 适配第三方组件： - 使用 okio 3.8.0 替代 okio 3.6.0 - 使用 log4j-core 2.20.0 替代 log4j-core 2.18.0 - 使用 jackson-core 2.15.4 替代 jackson-core 2.15.2 - 使用 jackson-databind 2.15.4 替代 jackson-databind 2.15.2 - 使用 jackson-annotations 2.15.4 替代 jackson-annotations 2.15.2 - 使用 log4j-api 2.20.0 替代 log4j-api 2.18.0 | 是 | | [v3.24.3](https://github.com/huaweicloud/huaweicloud-sdk-java-obs/releases/tag/V3.24.3) | 问题修复和优化 适配第三方组件 | 问题修复和优化： - 优化某些堆栈的日志打印 - 增加client close时的日志打印 - 优化重试逻辑 - 优化临时url的路径编码逻辑 - 优化解析、生成时间字符串的性能 - 优化xml生成逻辑 - 修复域名校验不正确的问题 - 修复部分空指针问题 - 修复拷贝对象时的元数据设置不生效的问题 - 客户端加密功能的安全整改 适配第三方组件： - 使用 okhttp 4.12.0 替代 okhttp 4.11.0 - 使用 okio 3.6.0 替代 okio 3.5.0 - 使用 jackson-core 2.15.2 替代 jackson-core 2.13.3 - 使用 jackson-databind 2.15.2 替代 jackson-databind 2.13.4.1 - 使用 jackson-annotations 2.15.2 替代 jackson-annotations 2.13.3 | 是 | | [v3.23.9.1](https://github.com/huaweicloud/huaweicloud-sdk-java-obs/releases/tag/v3.23.9.1) | 新功能 适配第三方组件 | - 新功能：支持设置自定义dns解析器 - 适配第三方组件：移除 java-xmlbuilder，使用默认的javax.xml库 | 是 | | [v3.23.9](https://github.com/huaweicloud/huaweicloud-sdk-java-obs/releases/tag/v3.23.9) | 新功能 适配第三方组件 | 新功能： - 新增配置桶清单接口 - 新增客户端加密 - 支持在生命周期规则中配置碎片过期时间 适配第三方组件： - 使用 okio 3.5.0 替代 okio 2.10.0 - 使用 okhttp 4.11.0 替代 okhttp 4.10.0 | 是 | | [v3.23.5](https://github.com/huaweicloud/huaweicloud-sdk-java-obs/releases/tag/v3.23.5) | 新功能 | 新功能： - 新增双写桶功能 - 支持标准存储、低频存储、归档存储桶容量的统计 | 是 | | [v3.23.3](https://github.com/huaweicloud/huaweicloud-sdk-java-obs/releases/tag/v3.23.3) | 新功能 适配第三方组件 | 新功能： - 支持crr进度查询 - 新增对象标签接口（设置、获取、删除 对象标签） 适配第三方组件： - 使用 powermock-module-junit4 2.0.9 替代 powermock-module-junit4 1.6.5 - 使用 powermock-api-mockito2 2.0.9 替代 powermock-api-mockito 1.6.5 - 使用 mockito-core 4.11.0 替代 mockito-core 1.10.19 | 是 | | [v3.22.12](https://github.com/huaweicloud/huaweicloud-sdk-java-obs/releases/tag/v3.22.12) | 新功能 适配第三方组件 | 新功能： - Java SDK支持深度归档 - Java SDK实现 posix accesslable相关接口 适配第三方组件： - 使用 log4j2 2.18.0 替代 log4j2 2.17.1 - 使用 okhttp 4.10.0 替代 okhttp 4.9.3 - 使用 jackson-core 2.13.3 替代 jackson-core 2.13.0 - 使用 jackson-databind 2.13.4.1 替代 jackson-databind 2.13.0 - 使用 jackson-annotations 2.13.3 替代 jackson-annotations 2.13.0 | 是 | | 低于v3.22.12（停止配套，EOM） | - | 版本过低，已停止维护，建议及时升级版本。 | - | 完整的版本变更情况请参见：[ChangeLog](https://github.com/huaweicloud/huaweicloud-sdk-java-obs/blob/master/README_CN.MD)。 #### 兼容性说明 - 推荐使用的JDK版本：JDK 8及以上版本。 - 旧版本（2.x）已不再维护，建议尽快升级至最新版。 #### 其他使用前须知 - 本文档是与OBS SDK配套的参考文档，为了您能更好的使用Java SDK，推荐前往[下载与安装SDK(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0001.html)下载最新版本的Java SDK。 - 请确认您已经熟悉OBS的基本概念，如[桶（Bucket）](https://support.huaweicloud.com/productdesc-obs/obs_03_0207.html)、[对象（Object）](https://support.huaweicloud.com/productdesc-obs/obs_03_0206.html)、[访问密钥（AK和SK）](https://support.huaweicloud.com/productdesc-obs/obs_03_0208.html)、[终端节点（Endpoint）和访问域名](https://support.huaweicloud.com/productdesc-obs/obs_03_0152.html)等。 - 您可以先参考[OBS客户端通用示例](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0100.html#obs_21_0100__section8686104202916)，了解OBS Java SDK接口调用的通用方式。 - 使用OBS客户端进行接口调用操作完成后，没有异常抛出，则表明返回值有效；如果抛出异常，则说明操作失败，此时可从[SDK自定义异常](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2005.html)实例中获取错误信息。 - 使用OBS客户端进行接口调用成功后，均会返回包含响应头信息的[SDK公共响应头](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2003.html)实例（或其子类实例）。 - 当前各区域特性开放不一致，部分特性仅在特定区域开放，使用过程中如果接口HTTP状态码为405，请确认该区域是否支持该功能特性。您可以查看[产品功能](https://support.huaweicloud.com/productdesc-obs/obs_03_0151.html)确认区域是否支持该功能特性，或者[提交工单](https://console.huaweicloud.com/ticket/#/ticketindex/createIndex)寻求技术支持。 #### 技术支持渠道 开发者社区提供的技术支持渠道如下： - 开发过程中，您有任何问题可以在Github上[提交issue](https://github.com/huaweicloud/huaweicloud-sdk-java-obs/issues)，或者在[华为云对象存储服务论坛](https://bbs.huaweicloud.com/forum/forum-620-1.html)中发帖求助。