prepare110 chat ga version (Azure#24001)

* Updated to 09-07-2021 for GA release

* Updated to use azure-core-testfrom current, until it is GAed

* Addressed APIView comments

* Updated changelog

* Fixed versioning issue

* Updated common version to latest released 1.0.4

* Fixed JavaDocs checkstyle issues

Co-authored-by: Andrei Giurgiu <agiurg@microsoft.com>

Author: angiurgiu

eng/jacoco-test-coverage/pom.xml

@@ -59,7 +59,7 @@
     <dependency>
     <groupId>com.azure</groupId>
       <artifactId>azure-communication-chat</artifactId>
-      <version>1.1.0-beta.3</version> <!-- {x-version-update;com.azure:azure-communication-chat;current} -->
+      <version>1.1.0</version> <!-- {x-version-update;com.azure:azure-communication-chat;current} -->
     </dependency>
     <dependency>
       <groupId>com.azure</groupId>

eng/versioning/version_client.txt

@@ -51,7 +51,7 @@ com.azure:azure-analytics-synapse-artifacts;1.0.0-beta.5;1.0.0-beta.6
 com.azure:azure-analytics-synapse-spark;1.0.0-beta.4;1.0.0-beta.5
 com.azure:azure-analytics-synapse-managedprivateendpoints;1.0.0-beta.5;1.0.0-beta.6
 com.azure:azure-analytics-synapse-monitoring;1.0.0-beta.3;1.0.0-beta.4
-com.azure:azure-communication-chat;1.0.1;1.1.0-beta.3
+com.azure:azure-communication-chat;1.0.1;1.1.0
 com.azure:azure-communication-callingserver;1.0.0-beta.4;1.0.0-beta.5
 com.azure:azure-communication-common;1.0.4;1.1.0-beta.1
 com.azure:azure-communication-sms;1.0.3;1.1.0-beta.1

sdk/communication/azure-communication-chat/CHANGELOG.md

@@ -1,16 +1,8 @@
 # Release History
 
-## 1.1.0-beta.3 (Unreleased)
-
-### Features Added
-
-### Breaking Changes
-
-### Bugs Fixed
-
-### Other Changes
-
-#### Dependency updates
+## 1.1.0 (2021-09-27)
+- Added javadoc code samples
+- Removed redundant overload `ChatThreadAsyncClient.sendTypingNotification(TypingNotificationOptions options)`
 - Upgraded `azure-communication-common` to 1.0.4
 
 ## 1.1.0-beta.2 (2021-08-10)

sdk/communication/azure-communication-chat/README.md

@@ -52,7 +52,7 @@ add the direct dependency to your project as follows.
 <dependency>
     <groupId>com.azure</groupId>
     <artifactId>azure-communication-chat</artifactId>
-    <version>1.1.0-beta.2</version>
+    <version>1.1.0</version>
 </dependency>
 ```
 
@@ -102,7 +102,7 @@ The following sections provide several code snippets covering some of the most c
 
 ### Create the Chat Client
 
-<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L38-L48 -->
+<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L39-L49 -->
 ```Java
 String endpoint = "https://<RESOURCE_NAME>.communcationservices.azure.com";
 
@@ -133,7 +133,7 @@ Use the `createChatThread` method to create a chat thread.
 It contains a `getChatThread()` method which returns the `ChatThread` object that can be used to get the thread client from which you can get the `ChatThreadClient` for performing operations on the created thread: add participants, send message, etc.
 The `ChatThread` object also contains the `getId()` method which retrieves the unique ID of the thread.
 
-<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L62-L79 -->
+<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L63-L80 -->
 ```Java
 List<ChatParticipant> participants = new ArrayList<ChatParticipant>();
 
@@ -159,7 +159,7 @@ String chatThreadId = result.getChatThread().getId();
 
 The `getChatThreadProperties` method retrieves a thread's properties from the service.
 
-<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L88-L89 -->
+<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L89-L90 -->
 ```Java
 ChatThreadClient chatThreadClient = chatClient.getChatThreadClient("Id");
 ChatThreadProperties chatThreadProperties = chatThreadClient.getProperties();
@@ -170,7 +170,7 @@ ChatThreadProperties chatThreadProperties = chatThreadClient.getProperties();
 Use `deleteChatThread` method to delete a chat thread
 `chatThreadId` is the unique ID of the chat thread.
 
-<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L98-L99 -->
+<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L99-L100 -->
 ```Java
 String chatThreadId = "Id";
 chatClient.deleteChatThread(chatThreadId);
@@ -181,7 +181,7 @@ chatClient.deleteChatThread(chatThreadId);
 The `getChatThreadClient` method returns a thread client for a thread that already exists. It can be used for performing operations on the created thread: add participants, send message, etc.
 `chatThreadId` is the unique ID of the existing chat thread.
 
-<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L110-L111 -->
+<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L111-L112 -->
 ```Java
 String chatThreadId = "Id";
 ChatThreadClient chatThreadClient = chatClient.getChatThreadClient(chatThreadId);
@@ -192,7 +192,7 @@ ChatThreadClient chatThreadClient = chatClient.getChatThreadClient(chatThreadId)
 Use `updateTopic` method to update a thread's topic
 `topic` is used to hold the new topic of the thread.
 
-<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L122-L122 -->
+<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L123-L123 -->
 ```Java
 chatThreadClient.updateTopic("New Topic");
 ```
@@ -210,7 +210,7 @@ Use the `sendMessage` method to send a chat message to the chat thread that the
 
 A `SendChatMessageResult` response returned from sending a chat message, it contains an id, which is the unique ID of the message.
 
-<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L134-L138 -->
+<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L134-L139 -->
 ```Java
 SendChatMessageOptions sendChatMessageOptions = new SendChatMessageOptions()
     .setContent("Message content")
@@ -224,7 +224,7 @@ SendChatMessageResult sendResult = chatThreadClient.sendMessage(sendChatMessageO
 The `getMessage` method retrieves a chat message from the service.
 `chatMessageId` is the unique ID of the chat message.
 
-<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L147-L148 -->
+<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L148-L149 -->
 ```Java
 String chatMessageId = "Id";
 ChatMessage chatMessage = chatThreadClient.getMessage(chatMessageId);
@@ -234,7 +234,7 @@ ChatMessage chatMessage = chatThreadClient.getMessage(chatMessageId);
 
 You can retrieve chat messages using the `listMessages` method on the chat thread client at specified intervals (polling).
 
-<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L157-L164 -->
+<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L158-L165 -->
 ```Java
 PagedIterable<ChatMessage> chatMessagesResponse = chatThreadClient.listMessages();
 chatMessagesResponse.iterableByPage().forEach(resp -> {
@@ -276,7 +276,7 @@ Use `updateMessage` to update a chat message identified by chatThreadId and mess
 
 - Use `content` to provide a new chat message content;
 
-<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L173-L177 -->
+<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L174-L178 -->
 ```Java
 String chatMessageId = "Id";
 UpdateChatMessageOptions updateChatMessageOptions = new UpdateChatMessageOptions()
@@ -290,7 +290,7 @@ chatThreadClient.updateMessage(chatMessageId, updateChatMessageOptions);
 Use `updateMessage` to update a chat message identified by chatMessageId.
 `chatMessageId` is the unique ID of the chat message.
 
-<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L186-L187 -->
+<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L187-L188 -->
 ```Java
 String chatMessageId = "Id";
 chatThreadClient.deleteMessage(chatMessageId);
@@ -302,7 +302,7 @@ chatThreadClient.deleteMessage(chatMessageId);
 
 Use `listParticipants` to retrieve a paged collection containing the participants of the chat thread.
 
-<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L196-L203 -->
+<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L197-L204 -->
 ```Java
 PagedIterable<ChatParticipant> chatParticipantsResponse = chatThreadClient.listParticipants();
 chatParticipantsResponse.iterableByPage().forEach(resp -> {
@@ -323,7 +323,7 @@ Use `addParticipants` method to add participants to the chat thread.
 - `display_name`, optional, is the display name for the thread member.
 - `share_history_time`, optional, is the time from which the chat history is shared with the member. To share history since the inception of the chat thread, set this property to any date equal to, or less than the thread creation time. To share no history previous to when the member was added, set it to the current date. To share partial history, set it to the required date.
 
-<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L216-L229 -->
+<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L217-L230 -->
 ```Java
 List<ChatParticipant> participants = new ArrayList<ChatParticipant>();
 
@@ -346,7 +346,7 @@ chatThreadClient.addParticipants(participants);
 Use `removeParticipant` method to remove a participant from the chat thread.
 `identifier` is the CommunicationIdentifier you've created.
 
-<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L240-L240 -->
+<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L241-L241 -->
 ```Java
 chatThreadClient.removeParticipant(user);
 ```
@@ -358,7 +358,7 @@ chatThreadClient.removeParticipant(user);
 Use `sendReadReceipt` method to post a read receipt event to a chat thread, on behalf of a user.
 `chatMessageId` is the unique ID of the chat message that was read.
 
-<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L249-L250 -->
+<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L250-L251 -->
 ```Java
 String chatMessageId = "Id";
 chatThreadClient.sendReadReceipt(chatMessageId);
@@ -368,7 +368,7 @@ chatThreadClient.sendReadReceipt(chatMessageId);
 
 `getReadReceipts` method retrieves read receipts for a chat thread.
 
-<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L259-L266 -->
+<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L260-L267 -->
 ```Java
 PagedIterable<ChatMessageReadReceipt> readReceiptsResponse = chatThreadClient.listReadReceipts();
 readReceiptsResponse.iterableByPage().forEach(resp -> {
@@ -389,11 +389,11 @@ Use `sendTypingNotification` method to post a typing notification event to a cha
 
 - Use `senderDisplayName` to set the display name of the notification sender;
 
-<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L276-L278 -->
+<!-- embedme ./src/samples/java/com/azure/communication/chat/ReadmeSamples.java#L277-L279 -->
 ```Java
 TypingNotificationOptions options = new TypingNotificationOptions();
 options.setSenderDisplayName("Sender Display Name");
-chatThreadClient.sendTypingNotification(options);
+chatThreadClient.sendTypingNotificationWithResponse(options, Context.NONE);
 ```
 
 

sdk/communication/azure-communication-chat/pom.xml

@@ -14,7 +14,7 @@
 
   <groupId>com.azure</groupId>
   <artifactId>azure-communication-chat</artifactId>
-  <version>1.1.0-beta.3</version> <!-- {x-version-update;com.azure:azure-communication-chat;current} -->
+  <version>1.1.0</version> <!-- {x-version-update;com.azure:azure-communication-chat;current} -->
 
   <name>Microsoft Azure client library for chat application</name>
   <description>

sdk/communication/azure-communication-chat/src/main/java/com/azure/communication/chat/ChatAsyncClient.java

@@ -32,6 +32,14 @@
 
 /**
  * Async Client that supports chat operations.
+ *
+ * <p><strong>Instantiating an asynchronous Chat Client</strong></p>
+ *
+ * {@codesnippet com.azure.communication.chat.chatasyncclient.instantiation}
+ *
+ * <p>View {@link ChatClientBuilder this} for additional ways to construct the client.</p>
+ *
+ * @see ChatClientBuilder
  */
 @ServiceClient(builder = ChatClientBuilder.class, isAsync = true)
 public final class ChatAsyncClient {
@@ -60,6 +68,12 @@ public ChatThreadAsyncClient getChatThreadClient(String chatThreadId) {
     /**
      * Creates a chat thread.
      *
+     * <p><strong>Code Samples</strong></p>
+     *
+     * <p>Create a chat thread based on "options".</p>
+     *
+     * {@codesnippet com.azure.communication.chat.chatasyncclient.createchatthread#createchatthreadoptions}
+     *
      * @param options Options for creating a chat thread.
      * @throws ChatErrorResponseException thrown if the request is rejected by server.
      * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.

sdk/communication/azure-communication-chat/src/main/java/com/azure/communication/chat/ChatClient.java

@@ -19,6 +19,14 @@
 
 /**
  * Sync Client that supports chat operations.
+ *
+ * <p><strong>Instantiating a synchronous Chat Client</strong></p>
+ *
+ * {@codesnippet com.azure.communication.chat.chatclient.instantiation}
+ *
+ * <p>View {@link ChatClientBuilder this} for additional ways to construct the client.</p>
+ *
+ * @see ChatClientBuilder
  */
 @ServiceClient(builder = ChatClientBuilder.class, isAsync = false)
 public final class ChatClient {
@@ -52,6 +60,12 @@ public ChatThreadClient getChatThreadClient(String chatThreadId) {
     /**
      * Creates a chat thread.
      *
+     * <p><strong>Code Samples</strong></p>
+     *
+     * <p>Create a chat thread based on "options".</p>
+     *
+     * {@codesnippet com.azure.communication.chat.chatclient.createchatthread#createchatthreadoptions}
+     *
      * @param options Options for creating a chat thread.
      * @throws ChatErrorResponseException thrown if the request is rejected by server.
      * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.

sdk/communication/azure-communication-chat/src/main/java/com/azure/communication/chat/ChatServiceVersion.java

@@ -10,7 +10,7 @@
  */
 public enum ChatServiceVersion implements ServiceVersion {
     V2021_03_07("2021-03-07"),
-    V2021_04_05_preview6("2021-04-05-preview6");
+    V2021_09_27("2021-09-27");
 
     private final String version;
 
@@ -35,6 +35,6 @@ public String getVersion() {
      */
     public static ChatServiceVersion getLatest() {
 
-        return V2021_04_05_preview6;
+        return V2021_09_27;
     }
 }

sdk/communication/azure-communication-chat/src/main/java/com/azure/communication/chat/ChatThreadAsyncClient.java

@@ -58,6 +58,14 @@
 
 /**
  * Async Client that supports chat thread operations.
+ *
+ * <p><strong>Instantiating an asynchronous Chat Thread Client</strong></p>
+ *
+ * {@codesnippet com.azure.communication.chat.chatthreadasyncclient.instantiation}
+ *
+ * <p>View {@link ChatClientBuilder this} for additional ways to construct the client.</p>
+ *
+ * @see ChatClientBuilder
  */
 @ServiceClient(builder = ChatThreadClientBuilder.class, isAsync = true)
 public final class ChatThreadAsyncClient {
@@ -408,6 +416,12 @@ PagedFlux<ChatParticipant> listParticipants(ListParticipantsOptions listParticip
     /**
      * Sends a message to a thread.
      *
+     * <p><strong>Code Samples</strong></p>
+     *
+     * <p>Send a chat message based on "options".</p>
+     *
+     * {@codesnippet com.azure.communication.chat.chatthreadasyncclient.sendmessage#sendchatmessageoptions}
+     *
      * @param options Options for sending the message.
      * @throws ChatErrorResponseException thrown if the request is rejected by server.
      * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
@@ -762,27 +776,6 @@ public Mono<Response<Void>> sendTypingNotificationWithResponse() {
         }
     }
 
-    /**
-     * Posts a typing event to a thread, on behalf of a user.
-     *
-     * @param options Options for sending the typing notification.
-     * @throws ChatErrorResponseException thrown if the request is rejected by server.
-     * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
-     * @return the completion.
-     */
-    @ServiceMethod(returns = ReturnType.SINGLE)
-    public Mono<Void> sendTypingNotification(TypingNotificationOptions options) {
-        try {
-            Objects.requireNonNull(options, "'options' cannot be null.");
-            return withContext(context -> sendTypingNotification(options, context)
-                .flatMap((Response<Void> res) -> {
-                    return Mono.empty();
-                }));
-        } catch (RuntimeException ex) {
-            return monoError(logger, ex);
-        }
-    }
-
     /**
      * Posts a typing event to a thread, on behalf of a user.
      *

sdk/communication/azure-communication-chat/src/main/java/com/azure/communication/chat/ChatThreadClient.java

@@ -27,6 +27,14 @@
 
 /**
  * Sync Client that supports chat thread operations.
+ *
+ * <p><strong>Instantiating a synchronous Chat Thread Client</strong></p>
+ *
+ * {@codesnippet com.azure.communication.chat.chatthreadclient.instantiation}
+ *
+ * <p>View {@link ChatClientBuilder this} for additional ways to construct the client.</p>
+ *
+ * @see ChatClientBuilder
  */
 @ServiceClient(builder = ChatThreadClientBuilder.class, isAsync = false)
 public final class ChatThreadClient {
@@ -214,6 +222,12 @@ public Response<SendChatMessageResult> sendMessageWithResponse(SendChatMessageOp
     /**
      * Sends a message to a thread.
      *
+     * <p><strong>Code Samples</strong></p>
+     *
+     * <p>Send a chat message based on "options".</p>
+     *
+     * {@codesnippet com.azure.communication.chat.chatthreadclient.sendmessage#sendchatmessageoptions}
+     *
      * @param options Options for sending the message.
      * @throws ChatErrorResponseException thrown if the request is rejected by server.
      * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
@@ -380,18 +394,6 @@ public Response<Void> sendTypingNotificationWithResponse(TypingNotificationOptio
         return this.client.sendTypingNotification(options, context).block();
     }
 
-    /**
-     * Posts a typing event to a thread, on behalf of a user.
-     *
-     * @param options Options for sending the typing notification.
-     * @throws ChatErrorResponseException thrown if the request is rejected by server.
-     * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
-     */
-    @ServiceMethod(returns = ReturnType.SINGLE)
-    public void sendTypingNotification(TypingNotificationOptions options) {
-        this.client.sendTypingNotification(options).block();
-    }
-
     /**
      * Posts a read receipt event to a thread, on behalf of a user.
      *