The Azure SDK team is pleased to make available the December 2019 client library GA release. This represents the updated release of the ground-up rewrite of the client libraries to ensure consistency, idiomatic design, and excellent developer experience and productivity. This GA release includes new and updated client libraries for Identity, Key Vault (keys, secrets and certificates) , and Storage (Blobs and Queues). Some of the libraries are released as preview and they are Azure App Configuration, Event Hubs and Event Hubs , Checkpoint Store, Storage File.

Installation Instructions

To use the GA and preview libraries, refer to the Maven dependency information below, which may be copied into your projects Maven pom.xml file as appropriate. If you are using a different build tool, refer to its documentation on how to specify dependencies.

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-data-appconfiguration</artifactId>
  <version>1.0.0-beta.7</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-identity</artifactId>
  <version>1.0.1</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-security-keyvault-certificates</artifactId>
  <version>4.0.0-beta.6</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-security-keyvault-secrets</artifactId>
  <version>4.0.1</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-security-keyvault-keys</artifactId>
  <version>4.0.1</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-messaging-eventhubs</artifactId>
  <version>5.0.0-beta.6</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-messaging-eventhubs-checkpointstore-blob</artifactId>
  <version>1.0.0-beta.4</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-storage-blob</artifactId>
  <version>12.1.0</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-storage-blob-batch</artifactId>
  <version>12.1.0</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-storage-blob-cryptography</artifactId>
  <version>12.1.0</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-storage-file-datalake</artifactId>
  <version>12.0.0-beta.7</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-storage-file-share</artifactId>
  <version>12.0.0</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-storage-queue</artifactId>
  <version>12.1.0</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-core-tracing-opencensus</artifactId>
  <version>1.0.0-beta.5</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-core-tracing-opentelemetry</artifactId>
  <version>1.0.0-beta.1</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-cosmos</artifactId>
  <version>4.0.0-preview.1</version>
</dependency>

Feedback

If you have a bug or feature request for one of the libraries, please post an issue to GitHub.

Changelog

Detailed changelogs are linked from the Quick Links below. Here are some of the highlights:

App Configuration

  • Added support for Azure Activity Directory authentication. For more details, please see the App Configuration change log.
  • Added service API version support.
  • Removed clearReadOnly API, updated setReadOnly API to support setting and clearing read only based on the flag passed.
  • Removed Range class, SettingSelector no longer supports Range.

Event Hubs

  • A large portion of the public API surface, including members and parameters, have had adjustments to their naming and organization to improve discoverability, provide better context to developers. For more details, please see the Event Hubs changelog.
  • EventHubClient (and its async counterpart) have been replaced by separate clients for consumer and producer, named EventHubsConsumerAsyncClient, EventHubProducerAsyncClient, EventHubsConsumerClient, and EventHubProducerClient.
  • Consumer and producer clients are no longer bound to a single partition.
  • EventProcessorClient is created and configured through EventProcessorClientBuilder.

Keyvault Certificates

  • The public API surface, including members and parameters, have had adjustments to their naming and organization to improve discoverability, provide better context to developers. For more details. please see the KeyVault Certificates

Keyvault Keys

  • Added the backend support in KeyEncryptionKeyClient to parse and use Symmetric Keys stored as a secret in the key vault for cryptography operations. For more details. please see the KeyVault Keys

Storage Blob

  • Optimized downloadToFile to avoid an unnecessary getProperties call and to lock on an ETag once the operation has started. For more details, please see the Storage Blob change log.

Storage Blob Batch

  • Changed exception throwing to throw StorageBlobException on invalid request and BlobBatchStorageException when batch operations fail. For more details, please see the Storage Blob Batch change log.

Storage Blob Cryptography

  • Added a check in EncryptedBlobClientBuilder to enforce HTTPS for bearer token authentication. For more details, please see the Storage Blob Cryptography change log.

Storage File Datalake

  • Fixed bug in ClientBuilders that prevented OAuth from functioning. For more details, please see the Storage File Datalake change log.

Storage File Share

  • Renamed FileReference to StorageFileItem. For more details, please see the Storage File Share change log.

Storage Queue

  • Added a check in ClientBuilders to enforce HTTPS for bearer token authentication. For more details, please see the Storage Queue change log.

Tracing

  • Added tracing instrumentation for AMQP and HTTP Java SDK client libraries using OpenTelemetry implementation of the interface. Detailed changelog for azure-core-tracing-opentelemetry.

Need help?

Latest Releases

View all the latest versions of Java packages here.