azure-sdk/releases/2020-09/java.md

23 KiB

title layout tags sidebar repository
Azure SDK for Java (September 2020) post java azure releases_sidebar azure/azure-sdk-for-java

The Azure SDK team is pleased to announce our September 2020 client library releases.

GA

  • Azure Core Serializer GSON JSON
  • Azure Core Serializer Jackson JSON
  • Form Recognizer

Updates

  • Azure App Configuration
  • Azure Core
  • Azure Core AMQP
  • Azure Core Http Netty
  • Azure Core Http OkHttp
  • Azure Event Hubs
  • Azure Identity
  • Azure Key Vault Certificates
  • Azure Key Vault Keys
  • Azure Key Vault Secrets
  • Azure Search Documents
  • Azure Spring Cloud
  • Form Recognizer
  • Azure Cosmos
  • Azure Spring Boot

Preview

  • Azure Core Experimental
  • Azure Core Serializer Apache Avro
  • Azure Event Hubs
  • Azure Identity
  • Azure Key Vault Administration
  • Azure Key Vault Certificates
  • Azure Key Vault Keys
  • Azure Key Vault Secrets
  • Anomaly Detector
  • Event Grid
  • Azure Search Documents
  • Azure Service Bus
  • Azure Tables
  • Azure Text Analytics

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-anomalydetector</artifactId>
  <version>3.0.0-beta.1</version>
</dependency>

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

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-ai-formrecognizer</artifactId>
  <version>3.0.0</version>
</dependency>
<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-ai-formrecognizer</artifactId>
  <version>3.0.1</version>
</dependency>

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

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

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

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

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

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

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

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

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

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

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-identity</artifactId>
  <version>1.2.0-beta.1</version>
</dependency>

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-messaging-eventgrid</artifactId>
    <version>2.0.0-beta.1</version>
</dependency>

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

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-messaging-eventhubs</artifactId>
    <version>5.3.0-beta.1</version>
</dependency>

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

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

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-messaging-servicebus</artifactId>
    <version>7.0.0-beta.6</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-search-documents</artifactId>
  <version>11.1.0</version>
</dependency>
<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-search-documents</artifactId>
  <version>11.2.0-beta.1</version>
</dependency>

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-security-keyvault-administration</artifactId>
    <version>4.0.0-beta.1</version>
</dependency>

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-security-keyvault-certificates</artifactId>
    <version>4.1.1</version>
</dependency>

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-security-keyvault-certificates</artifactId>
    <version>4.2.0-beta.1</version>
</dependency>

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

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-security-keyvault-keys</artifactId>
    <version>4.3.0-beta.1</version>
</dependency>

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

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-security-keyvault-secrets</artifactId>
    <version>4.3.0-beta.1</version>
</dependency>

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

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-ai-textanalytics</artifactId>
  <version>5.1.0-beta.1</version>
</dependency>

To use Azure Spring Cloud starters and binders, refer to the Maven dependency information below, which may be copied into your projects Maven pom.xml file as appropriate.

<dependency>
  <groupId>com.microsoft.azure</groupId>
  <artifactId>spring-cloud-azure-context</artifactId>
  <version>1.2.8</version>
</dependency>

<dependency>
  <groupId>com.microsoft.azure</groupId>
  <artifactId>spring-cloud-azure-eventhubs-stream-binder</artifactId>
  <version>1.2.8</version>
</dependency>

<dependency>
  <groupId>com.microsoft.azure</groupId>
  <artifactId>spring-cloud-azure-servicebus-queue-stream-binder</artifactId>
  <version>1.2.8</version>
</dependency>

<dependency>
  <groupId>com.microsoft.azure</groupId>
  <artifactId>spring-cloud-azure-servicebus-topic-stream-binder</artifactId>
  <version>1.2.8</version>
</dependency>

<dependency>
    <groupId>com.microsoft.azure</groupId>
    <artifactId>spring-cloud-azure-servicebus-stream-binder-core</artifactId>
    <version>1.2.8</version>
</dependency>

<dependency>
  <groupId>com.microsoft.azure</groupId>
  <artifactId>spring-starter-azure-cache</artifactId>
  <version>1.2.8</version>
</dependency>

<dependency>
  <groupId>com.microsoft.azure</groupId>
  <artifactId>spring-cloud-starter-azure-eventhubs</artifactId>
  <version>1.2.8</version>
</dependency>

<dependency>
  <groupId>com.microsoft.azure</groupId>
  <artifactId>spring-cloud-starter-azure-eventhubs-kafka</artifactId>
  <version>1.2.8</version>
</dependency>

<dependency>
  <groupId>com.microsoft.azure</groupId>
  <artifactId>spring-cloud-starter-azure-servicebus</artifactId>
  <version>1.2.8</version>
</dependency>

<dependency>
    <groupId>com.microsoft.azure</groupId>
    <artifactId>spring-starter-azure-storage</artifactId>
    <version>1.2.8</version>
</dependency>

<dependency>
    <groupId>com.microsoft.azure</groupId>
    <artifactId>spring-cloud-starter-azure-storage-queue</artifactId>
    <version>1.2.8</version>
</dependency>

<dependency>
    <groupId>com.microsoft.azure</groupId>
    <artifactId>spring-cloud-azure-storage</artifactId>
    <version>1.2.8</version>
</dependency>

<dependency>
    <groupId>com.microsoft.azure</groupId>
    <artifactId>spring-integration-eventhubs</artifactId>
    <version>1.2.8</version>
</dependency>

<dependency>
    <groupId>com.microsoft.azure</groupId>
    <artifactId>spring-integration-servicebus</artifactId>
    <version>1.2.8</version>
</dependency>

<dependency>
    <groupId>com.microsoft.azure</groupId>
    <artifactId>spring-integration-storage-queue</artifactId>
    <version>1.2.8</version>
</dependency>

To use Azure Spring Boot starters, refer to the Maven dependency information below, which may be copied into your projects Maven pom.xml file as appropriate.

<dependency>
  <groupId>com.microsoft.azure</groupId>
  <artifactId>azure-active-directory-b2c-spring-boot-starter</artifactId>
  <version>2.3.5</version>
</dependency>
<dependency>
  <groupId>com.microsoft.azure</groupId>
  <artifactId>azure-active-directory-spring-boot-starter</artifactId>
  <version>2.3.5</version>
</dependency>
<dependency>
  <groupId>com.microsoft.azure</groupId>
  <artifactId>azure-cosmosdb-spring-boot-starter</artifactId>
  <version>2.3.5</version>
</dependency>
<dependency>
  <groupId>com.microsoft.azure</groupId>
  <artifactId>azure-data-gremlin-spring-boot-starter</artifactId>
  <version>2.3.5</version>
</dependency>
<dependency>
  <groupId>com.microsoft.azure</groupId>
  <artifactId>azure-keyvault-secrets-spring-boot-starter</artifactId>
  <version>2.3.5</version>
</dependency>
<dependency>
  <groupId>com.microsoft.azure</groupId>
  <artifactId>azure-spring-boot-metrics-starter</artifactId>
  <version>2.3.5</version>
<dependency>
</dependency>
  <groupId>com.microsoft.azure</groupId>
  <artifactId>azure-servicebus-jms-spring-boot-starter</artifactId>
  <version>2.3.5</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:

Azure Core (Changelog)

New Features

  • New InputStream and OutputStream APIs for serialization and deserialization.
  • Added logging for the request attempt count to better correlate when requests are retried.
  • Updated reactor-core version to 3.3.9.RELEASE.
  • Updated FasterXML Jackson versions to 2.11.2.

Bug Fixes

  • General performance fixes for serialization, URL modification and parsing, and more.
  • Improved request and response body logging performance by using bulk ByteBuffer reading instead of byte by byte reading.
  • Fixed bug where header logging checked for a log level of not equals verbose instead of equals verbose.

Azure Core AMQP (Changelog)

New Features

  • Expose AmqpAnnotatedMessage, AmqpMessageHeader, and other AMQP properties.
  • Add support for authenticating with Shared Access Signatures.

Bug Fixes

  • Close children sessions and links when its associated parent is disposed.

Azure Core Experimental (Changelog)

New Features

  • Added AvroSerializer interface containing Avro specific serializer APIs.
  • Added AvroSerializerProvider interface as a service provider for AvroSerializer.

Azure Core Http Netty (Changelog)

New Features

  • Added new APIs to configure request write timeout, response timeout, and response body read timeout.
  • Updated reactor-core version to 3.3.9.RELEASE.
  • Updated reactor-netty version to 0.9.11.RELEASE.

Breaking Changes

  • Changed default timeouts from infinite to 60 seconds.

Azure Core Http OkHttp (Changelog)

New Features

  • Updated okhttp dependency from 4.2.2 to 4.8.1.
  • Added request timeout configuration.

Breaking Changes

  • Changed default connect timeout from 60 seconds to 10 and default read timeout from 120 seconds to 60 seconds.

Bug Fixes

  • Fixed bug where Configuration proxy would lead to a NullPointerException when set.

Azure Core Serializer Apache Avro (Changelog)

New Features

  • Updated ApacheAvroSerializer to implement AvroSerializer instead of ObjectSerializer.
  • Added implementation for AvroSerializerProvider.

Azure Core Serializer JSON GSON (Changelog)

  • General availability.

Azure Core Serializer JSON Jackson (Changelog)

  • General availability.

Azure Event Hubs Changelog

New Features

  • Add support for connection strings containing a Shared Access Signature.
  • Add options for controlling partition ownership expiration, load balancing strategy.

Azure Event Hubs Beta Changelog

New Features

  • A producer client can be configured to be an idempotent producer. When an event with the same producer group id and publishing sequence number is sent twice, only one will be accepted to the event hub.

Form Recognizer (Changelog)

  • General availability, stable version 3.0.0 released targetting v2.0 GA version of the Form Recognizer service

Breaking changes

  • Renamed BoundingBox model to FieldBoundingBox

Azure Identity (Changelog)

  • Upgraded core dependency to 1.8.1

Azure Identity Beta (Changelog)

  • Added InteractiveBrowserCredentialBuilder.redirectUrl(String) to configure the redirect URL
  • Deprecated InteractiveBrowserCredentialBuilder.port(int)
  • Added support for App Service 2019 MSI Endpoint in ManagedIdentityCredential
  • Added Shared Token cache support for MacOS Keychain, Gnome Keyring, and plain text for other Linux environments
  • Added option to write to shared token cache from InteractiveBrowserCredential, AuthorizationCodeCredential, UsernamePasswordCredential, DeviceCodeCredential ClientSecretCredential and ClientCertificateCredential
  • Added new APIs for authenticating users with DeviceCodeCredential, InteractiveBrowserCredential and UsernamePasswordCredential.
    • Added method authenticate which pro-actively interacts with the user to authenticate if necessary and returns a serializable AuthenticationRecord
  • Added following configurable options in classes DeviceCodeCredentialBuilder and InteractiveBrowserCredentialBuilder
    • authenticationRecord enables initializing a credential with an AuthenticationRecord returned from a prior call to Authenticate
    • disableAutomaticAuthentication disables automatic user interaction causing the credential to throw an AuthenticationRequiredException when interactive authentication is necessary.

Azure Key Vault Administration 4.0.0-beta.1 (Changelog)

New features

  • Added two new clients for performing Role-based Access Control (RBAC) operations on Key Vault: KeyVaultAccessControlClient and KeyVaultAccessControlAsyncClient.
  • Added two new clients for performing backup and restore operations on Key Vault: KeyVaultBackupClient and KeyVaultBackupAsyncClient.

Azure Key Vault Certificates 4.3.0-beta.1 (Changelog)

Key Bug Fixes

  • Fixed an issue that prevented using classes from package com.azure.security.keyvault.certificates when working on a project using Java 9+.

Azure Key Vault Keys 4.3.0-beta.1 (Changelog)

Key Bug Fixes

  • Fixed an issue that prevented using classes from package com.azure.security.keyvault.keys when working on a project using Java 9+.

Anomaly Detector (Changelog)

  • Initial preview release for Anomaly Detector.

Azure Search Documents 11.1.0 (Changelog)

New Features

  • GA release of buildSearchFields on SearchIndexClient and SearchIndexAsyncClient.
  • GA release of JsonSerializer functionality for SearchClient and SearchAsyncClient.
  • GA release of default HttpLogOptions on client builders.

Breaking Changes

  • Renamed SearchableFieldProperty to SearchableField and SimpleFieldProperty to SimpleField.
  • Renamed FieldBuilderOptions.setConverter to FieldBuilderOptions.setJsonSerializer.
  • Replaced ObjectSerializer setters in builders with JsonSerializer to better represent the type requirement.

Bug Fixes

  • Deprecated getter OcrSkill.setShouldDetectOrientation() and replaced with correct Javabeans named isShouldDetectOrientation().

Azure Search Documents 11.2.0-beta.1 (Changelog)

New Features

  • Added SearchBatchClient and SearchBatchAsyncClient which handle automatically creating and sending document batches.
  • Added IndexingHook interface to provide callback functionality when indexing documents with batching clients.
  • Added IndexingParametersConfiguration, and related enums, to offer strongly type configuration for IndexingParameters.
  • Added ScoringStatistics and SessionId to SearchOptions.

Breaking Changes

  • Updated Jackson annotations to include required = true when service must receive or return the property.

Azure Spring Cloud

New features

  • Enable Storage starter to support overwriting blob data.
  • Enable Actuator for storage blob.
  • Enable scheduled enqueue message in Service Bus binders.

Key Bug Fixes

  • Fixed the repeated consumption of Event Hubs messages when the checkpoint mode is BATCH.

Event Grid (Changelog)

  • Initial Preview release for Event Grid

Azure Service Bus (Changelog)

New features

  • Add support for authenticating with a connection string containing a Shared Access Signature.

Breaking changes

  • LockRenewalOperation is removed. Replaced with renewMessageLock and renewSessionLock.
  • ServiceBusDeadLetterReceiverBuilder is removed and replaced with ServiceBusReceiverBuilder.subQueue(SubQueue).
  • Remove settlement methods that take String lockToken and replace with ServiceBusReceivedMessage.
  • Rename ServiceBusMangementClient to ServiceBusAdministrationClient.
  • Replace all return and parameter types of Instant with OffsetDateTime.

Tables (Changelog)

  • Initial preview release for Azure Tables

Azure Cosmos (Changelog)

4.4.0 (2020-09-12)

Key Bug Fixes

  • Fixed RequestTimeoutException when enabling netty-tcnative-boringssl dependency.
  • Fixed memory leak issue on Delete operations in GATEWAY mode.
  • Fixed a leak in CosmosClient instantiation when endpoint uri is invalid.
  • Improved CPU History diagnostics.

Azure Cosmos (Changelog)

4.4.0-beta.1 (2020-08-27)

New Features

  • Added new API to efficiently load many documents (via list of pk/id pairs or all documents for a set of pk values).
  • Added new deleteItem API.
  • Enabled query metrics by default.

Key Bug Fixes

  • Fixed NPE in GatewayAddressCache.
  • Fixing query metric issue for zero item response.
  • Improved performance (reduced CPU usage) for address parsing and Master-Key authentication.

Bug Fixes

  • Changed Fluent annotations to Immutable when the class is immutable.

Azure Spring Boot

Key Bug Fixes

  • Exclude disabled secrets when getting Key Vault secrets
  • Get full list of groups the user belongs to from Graph API

Azure Text Analytics (Changelog)

New features

  • Updated Text Analytics SDK's default service API version to v3.1-preview.2 from v3.0.
  • Added support for Personally Identifiable Information(PII) entity recognition feature. To use this feature, you need to make sure you are using the service's v3.1-preview.1 API.
  • Added support for the Opinion Mining feature. To use this feature, you need to make sure you are using the service's v3.1-preview.1 and above API. To get this support pass includeOpinionMining as true in AnalyzeSentimentOptions when calling the sentiment analysis endpoints.

Need help

Latest Releases

View all the latest versions of Java packages [here][java-latest-releases].

{% include refs.md %}