Azure SDK for Java (June 2021)

The Azure SDK team is pleased to announce our June 2021 client library releases.

39 packages released this month.

Stable Packages (18)

• Cognitive Search

• Core

• Core - AMQP

• Core - HTTP Netty

• Core - HTTP OkHttp

• Cosmos DB

• Event Grid

• Event Hubs

• Event Hubs - Azure Blob Storage Checkpoint Store

• Management - Core

• Storage - Blobs

• Storage - Blobs Batch

• Storage - Blobs Cryptography

• Storage - Common

• Storage - Files Data Lake

• Storage - Files Shares

• Storage - Queues

• Tables

Patch Updates (13)

• App Configuration

• Communication Common

• Communication Identity

• Communication Phone Numbers

• Communication Sms

• Core - Test

• Core Serializer GSON JSON

• Core Serializer Jackson JSON

• Event Hubs - Azure Blob Storage Checkpoint Store

• Form Recognizer

• Identity

• Service Bus

• Text Analytics

Beta Packages (8)

• Azure Video Analyzer Edge

• Container Registry

• Core Experimental

• Core Serializer Apache Avro

• Metrics Advisor

• Storage - Blobs Changefeed

• Storage - Blobs NIO

• Tracing OpenTelemetry Plugin

Release highlights

App Configuration 1.1.13 Changelog

Dependency Updates

• Updated azure-core from 1.16.0 to 1.17.0.
• Updated azure-core-http-netty from 1.9.2 to 1.10.0.

Azure Video Analyzer Edge 1.0.0-beta.4 Changelog

• Update the description of the package, to add more info on the maven page.
• Update dependency version, azure-core to 1.17.0

Cognitive Search 11.4.0 Changelog

Features Added

• Added the ability to configure Knowledge Store in skillsets.
• Added factory method to SynonymMap to enable creation from a file.
• Added support for Edm.GeographyPoint in FieldBuilder when property has type GeoPoint.
• Added support for geography based filtering in SearchFilter when GeoPosition, GeoPoint, GeoLineString, or GeoPolygon are used as formatting arguments.
• Added new skills CustomEntityLookupSkill and DocumentExtractionSkill and new skill versions for KeyPhraseExtractionSkill and LanguageDetectionSkill.
• Added support for the ADLS Gen 2 Indexer data source type.
• Added skillset counts to SearchServiceCounters.
• Added additional log messages to SearchIndexingBufferedSender and SearchIndexingBufferedAsyncSender.

Breaking Changes

• Removed support for service version 2020-06-30-Preview. Default version is now 2020-06-30.
• Removed Semantic Search capability to SearchClient and SearchAsyncClient.
• Removed support for Normalizers in SearchField and SearchIndex with CustomNormalizer and LexicalNormalizer.

Dependency Updates

• Updated azure-core from 1.16.0 to 1.17.0.
• Updated azure-core-http-netty from 1.9.2 to 1.10.0.
• Updated azure-core-serializer-json-jackson from 1.2.3 to 1.2.4.
• Updated Jackson from 2.12.2 to 2.12.3.
• Updated Reactor from 3.4.5 to 3.4.6.
• Updated Reactor Netty from 1.0.6 to 1.0.7.

Communication Common 1.0.2 Changelog

Updated azure-communication-common version

Communication Identity 1.1.1 Changelog

Updated azure-communication-identity version

Communication Phone Numbers 1.0.3 Changelog

Updated azure-communication-phonenumbers version

Communication Sms 1.0.3 Changelog

Updated azure-communication-sms version

Container Registry 1.0.0-beta.3 Changelog

New features

• Flattened the content properties to the Tag, Manifest and Repository properties.
• Enabled support for non-public clouds.
• Added expiration time for the jwt tokens.
• Added more samples and documentation.

Core 1.17.0 Changelog

Features Added

• Added AsyncCloseable interface to support closing resources asynchronously.
• Added GeoJSON classes to the models package.
• Added createRetriableDownloadFlux to FluxUtil.
• Added HttpRange to the http package.
• Added the ability to terminate paging using a custom predicate in ContinuablePagedFlux.
• Added getPollInterval to PollerFlux.
• Added setResponseTimeout and setReadTimeout to HttpClientOptions.
• Added support for the JsonFlatten annotation to target fields.

Dependency Updates

• Upgraded Jackson from 2.12.2 to 2.12.3.
• Upgraded Reactor from 3.4.5 to 3.4.6.

Core - AMQP 2.2.0 Changelog

New Features

• Adding support for AMQP data types SEQUENCE and VALUE.

Dependency Updates

• Upgraded azure-core dependency to 1.15.0.

Core - HTTP Netty 1.10.0 Changelog

Dependency Updates

• Upgraded azure-core from 1.16.0 to 1.17.0.
• Upgraded Netty from 4.1.63.Final to 4.1.65.Final.
• Upgraded Reactor Netty from 1.0.6 to 1.0.7.

Core - HTTP OkHttp 1.7.0 Changelog

Dependency Updates

• Upgraded azure-core from 1.16.0 to 1.17.0.

Core - Test 1.6.3 Changelog

Features Added

• Updated JUnit 5 test status logging to only long when AZURE_TEST_DEBUG is true instead of always logging.

Dependency Updates

• Upgraded azure-core from 1.16.0 to 1.17.0.
• Upgraded JUnit 5 from 5.7.1 to 5.7.2.

Core Experimental 1.0.0-beta.14 Changelog

Breaking Changes

• Removed geojson package and GeoJSON classes.

Dependency Updates

• Upgraded azure-core from 1.16.0 to 1.17.0.

Core Serializer Apache Avro 1.0.0-beta.11 Changelog

Dependency Updates

• Upgraded azure-core from 1.16.0 to 1.17.0.

Core Serializer GSON JSON 1.1.3 Changelog

Dependency Updates

• Upgraded azure-core from 1.16.0 to 1.17.0.

Core Serializer Jackson JSON 1.2.4 Changelog

Dependency Updates

• Updated azure-core from 1.16.0 to 1.17.0.
• Updated Jackson from 2.12.2 to 2.12.3.

Cosmos DB 4.16.0 Changelog

Key Bug Fixes

• Fixed an issue on handling partition splits during bulk operations in Gateway Mode.
• Fixed an issue with NumberFormatException happening on requests on large containers.
• Fixed an issue with BackOff time in ThroughputController.
• Fixed an issue with ThroughputControl calculation.
• Improved behavior when CosmosClientBuilder.userAgentSuffix exceeds 64 characters. Now userAgentSuffix will be honored as long as total userAgent value is less than 256 characters or truncated to fit the 256 characters limited.
• Fixed issue when using client-side throughput control in combination with bulk upserts, previously resulting in unnecessarily upserting documents multiple times in some cases when getting throttled.

Event Grid 4.4.0 Changelog

New Features

• Added new Storage system event StorageBlobInventoryPolicyCompletedEventData.
• Added new attributes contentLocation and metadataLocation to AcsRecordingChunkInfoProperties.

Dependency Updates

• Update azure-core dependency to 1.17.0.
• Update azure-core-http-netty dependency to 1.10.0.

Event Hubs 5.8.0 Changelog

Features Added

• Add EventHubClientBuilder.credential(String, String, AzureNamedKeyCredential) overload.
• Add EventHubClientBuilder.credential(String, String, AzureSasCredential) overload.
• Add EventProcessorClientBuilder.credential(String, String, AzureNamedKeyCredential) overload.
• Add EventProcessorClientBuilder.credential(String, String, AzureSasCredential) overload.
• Add EventHubConnectionStringProperties to get connection string properties.

Dependency Updates

• Update azure-core dependency to 1.17.0.
• Update azure-core-amqp dependency to 2.2.0.

Event Hubs - Azure Blob Storage Checkpoint Store 1.7.1 Changelog

Dependency Updates

• Update azure-storage-blob to 12.11.1.

Event Hubs - Azure Blob Storage Checkpoint Store 1.8.0 Changelog

Dependency Updates

• Update azure-messaging-eventhubs dependency to 5.8.0.
• Update azure-storage-blob to 12.12.0.

Form Recognizer 3.1.1 Changelog

Bug Fixes

• Fixed invoices and other recognition operations to avoid Null Pointer Exception when data returned with no sub-line item fields detected.
• Fixed invoices and other recognition operations that return a FormField with text and no boundingBox or page information.

Dependency updates

• Updated azure-core to 1.17.0.
• Updated azure-core-http-netty to 1.10.0.

Identity 1.3.1 Changelog

Dependency Updates

• Upgraded azure-core dependency to 1.17.0

Management - Core 1.3.0 Changelog

Features Added

• Added Support for Challenge Based Authentication in ArmChallengeAuthenticationPolicy.

Fixed

• Fixed bug in ManagementErrorDeserializer. (#21615)

Dependency Updates

• Upgraded azure-core from 1.16.0 to 1.17.0.

Metrics Advisor 1.0.0-beta.4 Changelog

Features added

• Added support for Azure Log Analytics DataFeed source
• Added data source credential API support to client
• Added authentication type support for data feed
• Added property splitAlertByDimensions to AnomalyAlertConfiguration model
• Added clientOptions() methods to the MetricsAdvisorClientBuilder and MetricsAdvisorAdministrationClientBuilder

Breaking changes

• Replaced updateSubscriptionKey and updateApiKey into one method updateKey
• Deprecated support for HttpRequestDataFeed and ElasticsearchDataFeed source type
• Removed granularity type DataFeedGranularityType.PerSecond as it’s not supported by the service anymore
• Renamed value and expectedValue to valueOfRootNode and expectedValueOfRootNode
• Renamed top parameter to maxPageSize
• Renamed method listAnomaliesForAlert and listAnomaliesForDetectionConfig to listAnomalies
• Renamed method listIncidentsForAlert and listIncidentsForDetectionConfig to listIncidents
• Renamed ErrorCodeException and ErrorCode to MetricsAdvisorResponseException and MetricsAdvisorError

Service Bus 7.2.3 Changelog

Fixed

Fixed the issue that the second call of ServiceBusReceiverClient.complete is stuck when connection is broken.

Dependency Updates

• Upgraded azure-core dependency to 1.17.0.
• Upgraded azure-core-amqp dependency to 2.2.0.
• Upgraded azure-core-http-netty to 1.10.0.

Storage - Blobs 12.12.0 Changelog

• GA release

Storage - Blobs Batch 12.10.0 Changelog

• GA release

Storage - Blobs Changefeed 12.0.0-beta.7 Changelog

Dependency updates

• Updated blob dependency to 12.12.0

Storage - Blobs Cryptography 12.12.0 Changelog

• GA release

Storage - Blobs NIO 12.0.0-beta.7 Changelog

Dependency Updates

• Updated azure-storage-blob to version 12.12.0

Storage - Common 12.12.0 Changelog

• GA release

Storage - Files Data Lake 12.6.0 Changelog

• GA release

Storage - Files Shares 12.10.0 Changelog

• GA release

Storage - Queues 12.10.0 Changelog

• GA release

Tables 12.0.0 Changelog

Bug fixes

• Fixed issue where clients builders would not throw when calling buildClient() or buildAsyncClient() if no endpoint had been set.
• Fixed issue where TableClient’s and TableClientAsync’s submitTransaction() and submitTransactionWithResponse() could not be called from inside a Reactor thread (e.g. calling it inside a chain of reactive operations, such as myOtherOperation.then(result -> client.submitTransaction(transactionActions)).
• Fixed issue that would make an exception be raised when calling submitTransaction() if Java’s SecurityManager was enabled and no ReflectPermission had been granted.

New Features

• Introduced the following classes:
• TableAccessPolicies
• TableTransactionAction
• TableTransactionActionType
• TableTransactionFailedException
• TableTransactionResult
• Added support for generating SAS tokens at the Account and Table Service level in all clients. Introduced the following related classes:
• TableAccountSasPermission
• TableAccountSasResourceType
• TableAccountSasService
• TableAccountSasSignatureValues
• TableSasIpRange
• TableSasPermission
• TableSasSignatureValues
• Added the following methods to TableClient, TableAsyncClient:
• listAccessPolicies()
• setAccessPolicies()
• setAccessPoliciesWithResponse()
• generateSasToken()
• Added the following methods to TableServiceClient, TableServiceAsyncClient:
• getProperties()
• getPropertiesWithResponse()
• setProperties()
• setPropertiesWithResponse()
• getStatistics()
• getStatisticsWithResponse()
• generateAccountSasToken()

Breaking Changes

• Removed the TableBatch and TableAsyncBatch types, as well as the methods TableAsyncClient.createBatch() and TableClient.createBatch(). In their place, batch operations can now be submitted via the following methods:
• TableAsyncClient.submitTransaction(List<TableTransactionAction> transactionalBatch)
• TableAsyncClient.submitTransactionWithResponse(List<TableTransactionAction> transactionalBatch)
• TableClient.submitTransaction(List<TableTransactionAction> transactionalBatch)
• TableClient.submitTransactionWithResponse(List<TableTransactionAction> transactionalBatch, Duration timeout, Context context)
• Renamed BatchOperationResponse to TableTransactionActionResponse
• deleteEntity() variants in TableClient and TableAsyncClient now accept an ifUnchanged flag instead of an eTag parameter for conditional operations. When said flag is set to true, the ETag of a given TableEntity will be matched with the ETag of the entity in the Table service.
• Replaced deleteEntityWithResponse(String partitionKey, String rowKey, String eTag) with deleteEntityWithResponse(TableEntity entity, boolean ifUnchanged) in TableAsyncClient.
• Replaced deleteEntityWithResponse(String partitionKey, String rowKey, String eTag, Duration timeout, Context context) with deleteEntityWithResponse(TableEntity entity, boolean ifUnchanged, Duration timeout, Context context) in TableClient.
• Removed remaining public APIs supporting the use of TableEntity subclasses from TableAsyncClient.
• Removed the following method overloads from TableClient and TableAsyncClient:
• upsertEntity(TableEntity entity, TableEntityUpdateMode updateMode)
• updateEntity(TableEntity entity, TableEntityUpdateMode updateMode, boolean ifUnchanged)
• getEntity(String partitionKey, String rowKey, List<String> select)
• Client builders now also throw an IllegalStateException when calling buildClient() and buildAsyncClient() if multiple forms of authentication are provided, with the exception of sasToken + connectionString; or if endpoint and/or sasToken are set alongside a connectionString and the endpoint and/or SAS token in the latter are different than the former, respectively.
• The following methods and their WithResponse variants in TableClient and TableAsyncClient now throw an IllegalArgumentException instead of an IllegalStateException when an empty TableEntity is provided:
• createEntity()
• upsertEntity()
• updateEntity()
• deleteEntity()

Text Analytics 5.0.7 Changelog

Dependency Updates

• Updated azure-core from 1.16.0 to 1.17.0.
• Updated azure-core-http-netty from 1.9.2 to 1.10.0.

Tracing OpenTelemetry Plugin 1.0.0-beta.11 Changelog

Dependency Updates

• Upgraded azure-core from 1.16.0 to 1.17.0.

Need help

• For reference documentation visit the Azure SDK for Java documentation.
• For tutorials, samples, quick starts and other documentation, visit Azure for Java Developers.
• For build reports on code quality, test coverage, etc, visit Azure Java SDK.
• File an issue via Github Issues.
• Check previous questions or ask new ones on StackOverflow using azure-java-sdk tag.

Latest Releases

View all the latest versions of Java packages here.

Installation Instructions

To use the GA and beta 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-ai-formrecognizer</artifactId>
  <version>3.1.1</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-ai-metricsadvisor</artifactId>
  <version>1.0.0-beta.4</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-ai-textanalytics</artifactId>
  <version>5.0.7</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-communication-common</artifactId>
  <version>1.0.2</version>
</dependency>

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

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-communication-phonenumbers</artifactId>
  <version>1.0.3</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-communication-sms</artifactId>
  <version>1.0.3</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-containers-containerregistry</artifactId>
  <version>1.0.0-beta.3</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-core</artifactId>
  <version>1.17.0</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-core-amqp</artifactId>
  <version>2.2.0</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-core-experimental</artifactId>
  <version>1.0.0-beta.14</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-core-http-netty</artifactId>
  <version>1.10.0</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-core-http-okhttp</artifactId>
  <version>1.7.0</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-core-management</artifactId>
  <version>1.3.0</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-core-serializer-avro-apache</artifactId>
  <version>1.0.0-beta.11</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-core-serializer-json-gson</artifactId>
  <version>1.1.3</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-core-serializer-json-jackson</artifactId>
  <version>1.2.4</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-core-test</artifactId>
  <version>1.6.3</version>
</dependency>

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

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-cosmos</artifactId>
  <version>4.16.0</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-data-appconfiguration</artifactId>
  <version>1.1.13</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-data-tables</artifactId>
  <version>12.0.0</version>
</dependency>

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

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-media-videoanalyzer-edge</artifactId>
  <version>1.0.0-beta.4</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-messaging-eventgrid</artifactId>
  <version>4.4.0</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-messaging-eventhubs</artifactId>
  <version>5.8.0</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-messaging-eventhubs-checkpointstore-blob</artifactId>
  <version>1.7.1</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-messaging-eventhubs-checkpointstore-blob</artifactId>
  <version>1.8.0</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-messaging-servicebus</artifactId>
  <version>7.2.3</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-search-documents</artifactId>
  <version>11.4.0</version>
</dependency>

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

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

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-storage-blob-changefeed</artifactId>
  <version>12.0.0-beta.7</version>
</dependency>

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

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-storage-blob-nio</artifactId>
  <version>12.0.0-beta.7</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-storage-common</artifactId>
  <version>12.12.0</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-storage-file-datalake</artifactId>
  <version>12.6.0</version>
</dependency>

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

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

Feedback

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