Java SDK

Last Updated: Dec 27, 2017

SDK whose version later than 4.0.0 provides time to live and multiple versions of data, but not incompatible with the SDK in Version 2.x.x.

SDK version: 4.1.0

Release date: 11/10/2016



  • The split points of partitions can be get from reponse of DescribeTable.

SDK version: 4.0.0

Release date: 01/08/2016


SDK version: 2.2.4

Release date: 12/05/2016



  • Add API condition update.

  • Add filter.

SDK version 2.1.0

Release date: 12/11/2015



  • Asynchronous network transmission and performance tuning: When the CPU usage is the same, the QPS is increased by several times.
  • Flexible and easy-to-use asynchronous interfaces: Callback is introduced and Future is returned simultaneously.
  • Unbundled from OSS SDK: The new version only includes code of TableStore SDK. The directory is slightly adjusted.
  • Optimized retry logic: The default retry logic is optimized. An erroneous single row can be retried independently during batch operations. The retry logic custom method is clearer.
  • Optimized log: Logs are recorded for each step from request sending to request receiving. Logs of slow requests are recorded. Logs of the whole chain from SDK to back-end services are recorded using TraceId.
  • OTSWriter interface supporting batch data importing: This interface aims at providing easy-to-use and efficient data importing service for users.
  • Other optimized functions: Toolbox functions for various data classes are enriched and interfaces for data size computing are provided.


The new SDK may be slightly incompatible with the SDK in Version 2.0.4.

  • When an old SDK is replaced with the new one, you must change the import paths of a few classes, because the packages of these data classes are adjusted. For example, the package of “ClientConfiguration” is changed from “com.aliyun.openservices” to “com.aliyun.openservices.ots”. The major reason why the package is adjusted is that Table Store SDK is unbundled from OSS SDK. It is thus more appropriate to put the classes of data commonly used into the package of Table Store.
  • When you no longer use an OTSClient instance (for example, before the program ends), call the shutdown method of OTSClient to release the thread and connection resources occupied by the OTSClient object.
  • Names of some configuration items in “ClientConfiguration” are adjusted. For example, a time unit is added as a configuration item.
  • The dependency between packages in the new SDK is changed. For example, “HttpAsyncClient” and “Jodatime” are used. If any problem occurs during SDK running, check whether a conflicting dependency is introduced.

SDK version 2.0.4

Release date: 25/09/2015


Thank you! We've received your feedback.