update

spelluru · spelluru · commit f11eac6a01b2 · 2025-01-28T17:48:55.000-05:00
diff --git a/learn-pr/azure/enable-reliable-messaging-for-big-data-apps-using-event-hubs/includes/5-exercise-configure-applications-to-send-or-receive-messages-through-an-event-hub.md b/learn-pr/azure/enable-reliable-messaging-for-big-data-apps-using-event-hubs/includes/5-exercise-configure-applications-to-send-or-receive-messages-through-an-event-hub.md
@@ -1,6 +1,6 @@
 You're now ready to configure your publisher and consumer applications for your event hub.
 
-In this unit, you configure applications to send or receive messages through your event hub. One application acts as the message sender (**SimpleSend**), the other as the message receiver (**EventProcessorSample**). Because these applications are written in Java, you can do all developing, test, and management in your browser. However, the same configuration must be used for each platform, such as .NET. The applications are stored in a GitHub repository.
+In this unit, you configure applications to send or receive messages through your event hub. One application acts as the message sender (**SimpleSend**), the other as the message receiver (**EventProcessorSample**). The applications are stored in a GitHub repository.
 
 ## Create a general-purpose, standard storage account
 
@@ -28,7 +28,7 @@ In the previous exercise, we defined default values for resource group and locat
     ```
 
     > [!TIP]
-    > It may take a moment to create this storage account. If storage account creation fails, change your environment variable, and try again.
+    > It can take a moment to create this storage account. If storage account creation fails, change your environment variable, and try again.
 
 1. Run the following command to obtain the access keys associated with your storage account.
 
@@ -57,69 +57,44 @@ In the previous exercise, we defined default values for resource group and locat
     ```
 
 ## Clone the event hubs GitHub repository
+The source files for the applications that you build in this unit are located in a [GitHub repository](https://github.com/Azure/azure-event-hubs). 
 
-In Cloud Shell, clone the event hubs GitHub repository with `git`. The source files for the applications that you build in this unit are located in a [GitHub repository](https://github.com/Azure/azure-event-hubs). 
-
-1. Run the following commands to make sure that you are in your home directory in Cloud Shell, and then to clone this repository.
+1. Launch GitBash on your computer. 
+1. Run the following command to clone the Git project solution:
 
     ```bash
     cd ~
     git clone https://github.com/Azure/azure-event-hubs.git
     ```
+1. Launch VS Code on your computer. 
 
-The repository is cloned to your home folder.
-
-## Edit SimpleSend.java
-
-In this exercise, you use the built-in Cloud Shell editor to modify the SimpleSend application. You need to add your Event Hubs namespace, event hub name, shared access policy name, and primary key.
-
-1. Change to the **SimpleSend** folder.
-
-    ```bash
-    cd ~/azure-event-hubs/samples/Java/Basic/SimpleSend/src/main/java/com/microsoft/azure/eventhubs/samples/SimpleSend
-    ```
-
-1. Open Cloud Shell editor in the current folder.
-
-    ```bash
-    code .
-    ```
 
-    The files in the current folder are listed in the left-hand menu, and the editor space on the right side displays the contents of the filename listed in the title bar.
+## Edit SimpleSend.java that sends events to the event hub
 
-1. If not already open, open **SimpleSend.java** by selecting it from the file list.
+In this exercise, you use Visual Studio Code (VS Code) to modify the SimpleSend application. You need to add your Event Hubs namespace, event hub name, shared access policy name, and primary key.
 
+1. Launch VS Code. 
+1. Select **File** -> **Open Folder**, and select the **SimpleSend** folder under c:/users/USERID/azure-event-hubs/samples/java/basic. 
+1. In the Code Explorer in the left pane, double-click **SimpleSend.java** to open it in the editor. 
 1. In the editor, locate and replace the following strings under `ConnectionStringBuilder``:
 
-    - `"Your Event Hubs namespace name"` with the name of your Event Hubs namespace.
-    - `"Your Event Hub"` with the name of your event hub.
-    - `"Your policy name"` with **RootManageSharedAccessKey**.
-    - `"Your primary SAS key"` with the value of the **primaryKey** key for your Event Hubs namespace that you saved earlier.
-
-    If you forget these values, you can switch to the terminal window below the editor and run the `echo` command to list the environment variables. For example:
-
-    ```bash
-    echo $NS_NAME
-    echo $HUB_NAME
-    echo $STORAGE_NAME
-    ```
+    - `<EVENT HUBS NAMESPACE - CONNECTION STRING>` with the connection string to your Event Hubs namespace. 
+    - `<EVENT HUB NAME>` with the name of your event hub.
 
      For your primary SAS key, when you create an Event Hubs namespace, a 256-bit SAS key called **RootManageSharedAccessKey** is created and includes primary and secondary keys that grant send, listen, and manage rights to the namespace. Earlier in this exercise, you obtained the key by running an Azure CLI command; however, you can also find the keys and connection strings by selecting your Event Hubs namespace in the Azure portal, and then in the menu under the **Settings**, select **Shared access policies**; now select the policy name **RootManageSharedAccessKey** to display the SAS Policy keys. 
+1. Save the **SimpleSend.java** file. 
 
-1. Save the **SimpleSend.java** file, and then close the editor. Select in the upper right corner of the editor, and use the **Save** and **Close Editor** menu items. 
-
-    :::image type="content" source="../media/5-save-and-close-editor.png" alt-text="Screenshot showing menu items to save the file and close the editor.":::
 
 ## Use Maven to build SimpleSend.java
 
 Now, you build the Java application by running **mvn** commands.
 
-1. In the Cloud Shell, enter the following command to navigate to the main **SimpleSend** folder.
+1. In the Code Explorer, right-click **SimpleSend.java**, and select **Open in Integrated Terminal**. 
+1. Enter the following command to navigate to the main **SimpleSend** folder.
 
     ```bash
     cd ~/azure-event-hubs/samples/Java/Basic/SimpleSend
     ```
-
 1. Build the Java SimpleSend application. This command builds your application using the connection details for your event hub.
 
     ```bash
@@ -130,57 +105,34 @@ Now, you build the Java application by running **mvn** commands.
 
     ![Build results for sender application.](../media/5-sender-build.png)
 
-## Edit EventProcessorSample.java
+## Edit EventProcessorSample.java that receives events to the event hub
 
 You now configure a **receiver** (also known as a **subscriber** or **consumer**) application to ingest data from your event hub.
 
-For the receiver application, two classes are available: **EventHubReceiver** and **EventProcessorHost**. EventProcessorHost is built on top of EventHubReceiver, but provides a simpler programmatic interface than EventHubReceiver. EventProcessorHost can automatically distribute message partitions across multiple instances of EventProcessorHost using the same storage account.
-
-In this procedure, you use the `EventProcessorHost` method. You edit the EventProcessorSample application to add the following values: Your Event Hubs namespace, event hub name, shared access policy name and primary key, storage account name, connection string, and container name.
+For the receiver application, two classes are available: **EventHubReceiver** and **EventProcessorClient**. EventProcessorClient is built on top of EventHubReceiver, but provides a simpler programmatic interface than EventHubReceiver. EventProcessorClient can automatically distribute message partitions across multiple instances of EventProcessorClient using the same storage account.
 
-1. Change to the **EventProcessorSample** folder by running the following command.
+In this procedure, you use the `EventProcessorClient` method. You edit the EventProcessorSample application to add the following values: Your Event Hubs namespace, event hub name, shared access policy name and primary key, storage account name, connection string, and container name.
 
-    ```bash
-    cd ~/azure-event-hubs/samples/Java/Basic/EventProcessorSample/src/main/java/com/microsoft/azure/eventhubs/samples/eventprocessorsample
-    ```
-
-1. Open Cloud Shell editor.
-
-    ```bash
-    code .
-    ```
+1. Launch another instance of the VS Code. 
+1. Select **File** -> **Open Folder**, and select the **EventProcessorSample** folder under c:/users/USERID/azure-event-hubs/samples/java/basic. 
+1. In the Code Explorer in the left pane, double-click **EventProcessorSample.java** to open it in the editor. 
+1. In the editor, locate and replace the following strings in the editor:
 
-1. Select the **EventProcessorSample.java** file in the file explorer to the left. 
+    - `<EVENT HUBS NAMESPACE - CONNECTION STRING>` - connection string to the Event Hubs namespace.
+    - `<EVENT HUB NAME>` - name of the event hub.
+    - `<AZURE STORAGE - CONNECTION STRING>` - connection string to the Azure Storage account.
+    - Confirm that the blob container name is **messages**. If you're using a different name for the container, use that name. 
+1. Save **EventProcessorSample.java**.
 
-1. Locate and replace the following strings in the editor:
-
-    - `----EventHubNamespaceName----` with the name of your Event Hubs namespace.
-    - `----EventHubName----` with the name of your event hub.
-    - `----SharedAccessSignatureKeyName----` with **RootManageSharedAccessKey**.
-    - `----SharedAccessSignatureKey----` with the value of the **primaryKey** key for your Event Hubs namespace that you saved earlier.
-    - `----AzureStorageConnectionString----` with your storage account connection string that you saved earlier.
-    - `----StorageContainerName----` with **messages**.
-    - `----HostNamePrefix----` with the name of your storage account.
-
-    If you forget these values, you can switch to the terminal window below the editor and run the `echo` command to list the environment variables. For example:
-
-    ```bash
-    echo $NS_NAME
-    echo $HUB_NAME
-    echo $STORAGE_NAME
-    ```
-1. Save **EventProcessorSample.java** either with the "..." menu, or the accelerator key (<kbd>Ctrl+S</kbd> on Windows and Linux, <kbd>Cmd+S</kbd> on macOS).
-
-1. Close the editor.
 
 ## Use Maven to build EventProcessorSample.java
 
+1. In the Code Explorer, right-click **EventProcessorSample.java**, and select **Open in Integrated Terminal**. 
 1. Change to the main **EventProcessorSample** folder by running the following command.
 
     ```bash
     cd ~/azure-event-hubs/samples/Java/Basic/EventProcessorSample
     ```
-
 1. Build the Java SimpleSend application by running the following command to ensure that your application uses the connection details for your event hub.
 
     ```bash
@@ -190,17 +142,21 @@ In this procedure, you use the `EventProcessorHost` method. You edit the EventPr
     The build process can take several minutes to complete. Ensure that you see a **[INFO] BUILD SUCCESS** message before continuing.
 
     :::image type="content" source="../media/5-receiver-build.png" alt-text="Build results for receiver application." loc-scope="other"::: <!-- no-loc -->
-
 ## Start the sender and receiver apps
 
-1. Run the Java application from the command line by running the following `java` command, and specifying a .jar package. Run the following commands to start the SimpleSend application.
+1. Start the EventProcessorSample application by running the following command.
+
+    ```bash
+    cd ~/azure-event-hubs/samples/Java/Basic/EventProcessorSample
+    java -jar ./target/eventprocessorsample-1.0.0-jar-with-dependencies.jar
+    ```
+1. Switch to the VS Code window that has the sending application (SimpleSend) code open. In the integrated terminal, run the Java application from the command line by running the following `java` command, and specifying a .jar package. 
 
     ```bash
     cd ~/azure-event-hubs/samples/Java/Basic/SimpleSend
     java -jar ./target/simplesend-1.0.0-jar-with-dependencies.jar
     ```
-
-1. When you see **Send Complete...**, press <kbd>Enter</kbd>.
+1. When you see **Send Complete...**, <kbd>Enter</kbd> to stop the application.
 
     ```output
     jar-with-dependencies.jar
@@ -209,15 +165,7 @@ In this procedure, you use the `EventProcessorHost` method. You edit the EventPr
     SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.
     2018-09-18T19:42:15.146Z: Send Complete...
     ```
-
-1. Start the EventProcessorSample application by running the following command.
-
-    ```bash
-    cd ~/azure-event-hubs/samples/Java/Basic/EventProcessorSample
-    java -jar ./target/eventprocessorsample-1.0.0-jar-with-dependencies.jar
-    ```
-
-1. When messages stop appearing on the console, press <kbd>Enter</kbd> or press <kbd>CTRL+C</kbd> to end the program.
+1. In the VS Code with the receiver application running, verify that you see messages. Press <kbd>Enter</kbd> or press <kbd>CTRL+C</kbd> to end the program.
 
     ```output
     ...
