What Is the Retry Mechanism of SDK? (SDK for Java)

Updated on 2025-01-24 GMT+08:00

View PDF

SDK uses the maxErrorRetry parameter configured in Creating and Configuring an OBS Client (SDK for Java) to retry. The default value for retry times is 3. 0 to 5 is recommended.

If the network connection is abnormal or the server returns the 5XX error when an ObsClient API is called, the SDK performs an exponential backoff retry.

NOTICE:

For ObsClient.putObject, when the data source is an InputStream other than FileInputStream, the SDK does not retry when an I/O exception occurs because the data stream cannot be re-read. The upper-layer application needs to retry.
When ObsClient.getObject is successfully called and ObsObject is returned, the SDK does not retry when an I/O exception occurs during data reading from ObsObject.getObjectContent because this situation is beyond the scope of the processing logic of the SDK. The upper-layer application needs to retry.

Parent topic: FAQs (SDK for Java)

Previous topic: How Can I Set an Object to Be Accessible to Anonymous Users? (Java SDK)

Next topic: How Do I Obtain the Static Website Access Address of a Bucket? (Java SDK)