Help Center/ Object Storage Service/ SDK Reference/ Java/ Before You Start (SDK for Java)

Updated on 2025-09-22 GMT+08:00

View PDF

Before You Start (SDK for Java)

This section describes version updates and compatibility and important notes about Object Storage Service (OBS) SDK for Java.

Version Updates

Table 1 describes the version updates and compatibility of OBS SDK for Java.

**Table 1** Version updates and compatibility of OBS SDK for Java
Version	Update	Description	Compatible or Not
v3.25.5	New features	Supported Instance Metadata Service Version 2 (IMDSv2).	Yes
v3.25.4	New features Issue resolution and optimization	New features: Allowed you to set callTimeout in OkHttp. Supported DeleteData in CRR configurations. Allowed you to configure custom domain names. Issue resolution and optimization: Optimized the logic for verifying ContentType.	Yes
v3.24.12	New features	New features: Supported the Block Public Acess (BPA) feature. Supported Intelligent Tiering. Supported the trash feature in parallel file systems.	Yes
v3.24.9	Issue resolution and optimization	Issue resolution and optimization: Optimized the XML construction logic for completing multipart uploads. Optimized the XML parsing logic. Added the automatic retry when a request fails due to incorrect time. Added the ExpiredObjectDeleteMarker attribute to lifecycle rules. Fixed the issue where the WebP format cannot be automatically added for ContentType.	Yes
v3.24.8	New features Issue resolution and optimization Adaptation to third-party dependencies	New features: Supported CRC64 check for PutObject, Getobject, GetObjectMetadata, UploadPart, AppendObject, CopyObject, CopyPart and CompeleMultiUploadPart. Allowed you to suspend or cancel resumable uploads. Allowed you to set EventListenerFactory in OkHttp to collect statistics on the time consumed in each phase of an HTTP request. This function is disabled by default. Issue resolution and optimization: Optimized the progress bar setting logic during resumable uploads. Optimized the printing format of some logs. Fixed the issue where client-side encryption is restricted to the OBS protocol only. Added the check logic when the encryption algorithm is null. Adaptation to third-party dependencies: Replaced Okio 3.6.0 with Okio 3.8.0. Replaced log4j-core 2.18.0 with log4j-core 2.20.0. Replaced jackson-core 2.15.2 with jackson-core 2.15.4. Replaced jackson-databind 2.15.2 with jackson-databind 2.15.4. Replaced jackson-annotations 2.15.2 with jackson-annotations 2.15.4. Replaced log4j-api 2.18.0 with log4j-api 2.20.0.	Yes
v3.24.3	Issue resolution and optimization Adaptation to third-party dependencies	Issue resolution and optimization: Optimized the log printing of some stacks. Added the log printing when the client is closed. Optimized the retry logic. Optimized the path encoding logic for temporary URLs. Optimized the performance of parsing and generating time strings. Optimized the XML creation logic. Fixed the issue of incorrect domain name verification. Fixed some null pointer issues. Fixed the issue where the metadata setting does not take effect during object copy. Enhanced the security of client-side encryption. Adaptation to third-party dependencies: Replaced OkHttp 4.11.0 with OkHttp 4.12.0. Replaced Okio 3.5.0 with Okio 3.6.0. Replaced jackson-core 2.13.3 with jackson-core 2.15.2. Replaced jackson-databind 2.13.4.1 with jackson-databind 2.15.2. Replaced jackson-annotations 2.13.3 with jackson-annotations 2.15.2.	Yes
v3.23.9.1	New features Adaptation to third-party dependencies	New features: Allowed you to customize DNS resolvers. Adaptation to third-party dependencies: Removed java-xmlbuilder and used the default javax.xml library.	Yes
v3.23.9	New features Adaptation to third-party dependencies	New features: Added the API for configuring bucket inventories. Added client-side encryption. Allowed you to configure the expiration time of fragments in lifecycle rules. Adaptation to third-party dependencies: Replaced Okio 2.10.0 with Okio 3.5.0. Replaced OkHttp 4.10.0 with OkHttp 4.11.0.	Yes
v3.23.5	New features	New features: Added the dual-write feature to buckets. Supported the Standard, Infrequent Access, and Archive storage classes. Supported capacity statistics on storage in three storage classes.	Yes
v3.23.3	New features Adaptation to third-party dependencies	New features: Allowed you to query the progress of cross-region replication. Added the APIs for setting, obtaining, and deleting object tags. Adaptation to third-party dependencies: Replaced powermock-module-junit4 1.6.5 with powermock-module-junit4 2.0.9. Replaced powermock-api-mockito 1.6.5 with powermock-api-mockito2 2.0.9. Replaced mockito-core 1.10.19 with mockito-core 4.11.0.	Yes
v3.22.12	New features Adaptation to third-party dependencies	New features: Added the posix-accessible APIs. Adaptation to third-party dependencies: Replaced log4j2 2.17.1 with log4j2 2.18.0. Replaced OkHttp 4.9.3 with OkHttp 4.10.0. Replaced jackson-core 2.13.0 with jackson-core 2.13.3. Replaced jackson-databind 2.13.0 with jackson-databind 2.13.4.1. Replaced jackson-annotations 2.13.0 with jackson-annotations 2.13.3.	Yes
Versions earlier than v3.22.12 (EOM)	-	These earlier versions have reached their end of marketing (EOM). You are advised to upgrade them.	-

For more information about version updates, see ChangeLog.

Compatibility

Recommended JDK versions: JDK 8 or later
The earlier 2.X versions are no longer maintained. You are advised to upgrade them to the latest version as soon as possible.

Important Notes

To make the most of this document, download the latest version of Java SDK from SDK Download and Installation (SDK for Java).
Make sure that you are familiar with basic OBS concepts, such as buckets, objects, access keys (AKs/SKs), and endpoints and domain names.
You can learn about how to call an API through the OBS SDK for Java by referring to Using an OBS Client.
After an API is called using an instance of ObsClient, if no exception is thrown, the return value is valid. If an exception is thrown, the operation fails. For details about errors, see SDK Exceptions (SDK for Java).
After an API is successfully called using an instance of ObsClient, a class or sub-class instance of HeaderResponse that contains response headers will be returned.
Some features are available only in some regions. If an API call returns the 405 HTTP status code, check whether the region supports this feature. For details, refer to Function Overview or submit a service ticket to contact technical support.