| title | description | services | documentationcenter | author | manager | editor | ms.assetid | ms.service | ms.workload | ms.tgt_pltfrm | ms.devlang | ms.topic | ms.date | ms.author |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
DocumentDB Java API & SDK | Microsoft Docs |
Learn all about the Java API and SDK including release dates, retirement dates, and changes made between each version of the DocumentDB Java SDK. |
documentdb |
java |
rnagpal |
jhubbard |
cgronlun |
7861cadf-2a05-471a-9925-0fec0599351b |
documentdb |
data-services |
na |
java |
article |
01/03/2017 |
rnagpal |
[!div class="op_single_selector"]
| **SDK Download** | [Maven](http://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22com.microsoft.azure%22%20AND%20a%3A%22azure-documentdb%22) |
| **API documentation** | [Java API reference documentation](http://azure.github.io/azure-documentdb-java/) |
| **Contribute to SDK** | [GitHub](https://github.com/Azure/azure-documentdb-java/) |
| **Get started** | [Get started with the Java SDK](documentdb-java-get-started.md) |
| **Web app tutorial** | [Web application development with DocumentDB](documentdb-java-application.md) |
| **Current supported runtime** | [JDK 7](http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html) |
- Added simple client instance-based proxy support with ConnectionPolicy.setProxy() API.
- Added DocumentClient.close() API to properly shutdown DocumentClient instance.
- Improved query performance in direct connectivity mode by deriving the query plan from the native assembly instead of the Gateway.
- Set FAIL_ON_UNKNOWN_PROPERTIES = false so users don't need to define JsonIgnoreProperties in their POJO.
- Refactored logging to use SLF4J.
- Fixed a few other bugs in consistency reader.
- Fixed a bug in the connection management to prevent connection leaks in direct connectivity mode.
- Fixed a bug in the TOP query where it may throw NullReferenece exception.
- Improved performance by reducing the number of network call for the internal caches.
- Added status code, ActivityID and Request URI in DocumentClientException for better troubleshooting.
- Fixed an issue in the connection management for stability.
- Added support for BoundedStaleness consistency level.
- Added support for direct connectivity for CRUD operations for partitioned collections.
- Fixed a bug in querying a database with SQL.
- Fixed a bug in the session cache where session token may be set incorrectly.
- Added support for cross partition parallel queries.
- Added support for TOP/ORDER BY queries for partitioned collections.
- Added support for strong consistency.
- Added support for name based requests when using direct connectivity.
- Fixed to make ActivityId stay consistent across all request retries.
- Fixed a bug related to the session cache when recreating a collection with the same name.
- Added Polygon and LineString DataTypes while specifying collection indexing policy for geo-fencing spatial queries.
- Fixed issues with Java Doc for Java 1.8.
- Fixed a bug in PartitionKeyDefinitionMap to cache single partition collections and not make extra fetch partition key requests.
- Fixed a bug to not retry when an incorrect partition key value is provided.
- Added the support for multi-region database accounts.
- Added support for automatic retry on throttled requests with options to customize the max retry attempts and max retry wait time. See RetryOptions and ConnectionPolicy.getRetryOptions().
- Deprecated IPartitionResolver based custom partitioning code. Please use partitioned collections for higher storage and throughput.
- Added retry policy support for throttling.
- Added time to live (TTL) support for documents.
- Implemented partitioned collections and user-defined performance levels.
- Fixed a bug in HashPartitionResolver to generate hash values in little-endian to be consistent with other SDKs.
- Add Hash & Range partition resolvers to assist with sharding applications across multiple partitions.
- Implement Upsert. New upsertXXX methods added to support Upsert feature.
- Implement ID Based Routing. No public API changes, all changes internal.
- Release skipped to bring version number in alignment with other SDKs
- Supports GeoSpatial Index
- Validates id property for all resources. Ids for resources cannot contain ?, /, #, , characters or end with a space.
- Adds new header "index transformation progress" to ResourceResponse.
- Implements V2 indexing policy
- GA SDK
Microsoft will provide notification at least 12 months in advance of retiring an SDK in order to smooth the transition to a newer/supported version.
New features and functionality and optimizations are only added to the current SDK, as such it is recommend that you always upgrade to the latest SDK version as early as possible.
Any request to DocumentDB using a retired SDK will be rejected by the service.
Warning
All versions of the Azure DocumentDB SDK for Java prior to version 1.0.0 will be retired on February 29, 2016.
| Version | Release Date | Retirement Date |
|---|---|---|
| 1.9.4 | November 24, 2016 | --- |
| 1.9.3 | October 30, 2016 | --- |
| 1.9.2 | October 28, 2016 | --- |
| 1.9.1 | October 26, 2016 | --- |
| 1.9.0 | October 03, 2016 | --- |
| 1.8.1 | June 30, 2016 | --- |
| 1.8.0 | June 14, 2016 | --- |
| 1.7.1 | April 30, 2016 | --- |
| 1.7.0 | April 27, 2016 | --- |
| 1.6.0 | March 29, 2016 | --- |
| 1.5.1 | December 31, 2015 | --- |
| 1.5.0 | December 04, 2015 | --- |
| 1.4.0 | October 05, 2015 | --- |
| 1.3.0 | October 05, 2015 | --- |
| 1.2.0 | August 05, 2015 | --- |
| 1.1.0 | July 09, 2015 | --- |
| 1.0.1 | May 12, 2015 | --- |
| 1.0.0 | April 07, 2015 | --- |
| 0.9.5-prelease | Mar 09, 2015 | February 29, 2016 |
| 0.9.4-prelease | February 17, 2015 | February 29, 2016 |
| 0.9.3-prelease | January 13, 2015 | February 29, 2016 |
| 0.9.2-prelease | December 19, 2014 | February 29, 2016 |
| 0.9.1-prelease | December 19, 2014 | February 29, 2016 |
| 0.9.0-prelease | December 10, 2014 | February 29, 2016 |
[!INCLUDE documentdb-sdk-faq]
To learn more about DocumentDB, see Microsoft Azure DocumentDB service page.