Merge pull request #301223 from TimShererWithAquent/us439212-02

prmerger-automator[bot] · web-flow · commit 643757c7922e · 2025-06-12T16:01:19.000Z
Freshness Edit: Azure Messaging Service (2 of 10)
diff --git a/articles/service-bus-messaging/service-bus-java-how-to-use-queues.md b/articles/service-bus-messaging/service-bus-java-how-to-use-queues.md
@@ -1,31 +1,35 @@
 ---
-title: Get started with Azure Service Bus queues (Java)
+title: 'Quickstart: Get Started with Azure Service Bus Queues (Java)'
 description: This tutorial shows you how to send messages to and receive messages from Azure Service Bus queues using the Java programming language.
-ms.date: 02/28/2024
+ms.date: 06/12/2025
 ms.topic: quickstart
 ms.devlang: java
 ms.custom: passwordless-java, devx-track-extended-java
+#customer intent: As a developer, I want to learn how to send and receive messages with Azure Service Bus queues by using the Java.
 ---
 
 # Send messages to and receive messages from Azure Service Bus queues (Java)
+
 > [!div class="op_single_selector" title1="Select the programming language:"]
 > * [C#](service-bus-dotnet-get-started-with-queues.md)
 > * [Java](service-bus-java-how-to-use-queues.md)
 > * [JavaScript](service-bus-nodejs-how-to-use-queues.md)
 > * [Python](service-bus-python-how-to-use-queues.md)
 
-In this quickstart, you create a Java app to send messages to and receive messages from an Azure Service Bus queue.
-
-> [!NOTE]
-> This quick start provides step-by-step instructions for a simple scenario of sending messages to a Service Bus queue and receiving them. You can find pre-built Java samples for Azure Service Bus in the [Azure SDK for Java repository on GitHub](https://github.com/azure/azure-sdk-for-java/tree/main/sdk/servicebus/azure-messaging-servicebus/src/samples).
+This quickstart provides step-by-step instructions for a simple scenario of sending messages to a Service Bus queue and receiving them. You create a Java app to send messages to and receive messages from an Azure Service Bus queue. You can find prebuilt Java samples for Azure Service Bus in the [Azure SDK for Java repository on GitHub](https://github.com/azure/azure-sdk-for-java/tree/main/sdk/servicebus/azure-messaging-servicebus/src/samples).
 
 > [!TIP]
-> If you're working with Azure Service Bus resources in a Spring application, we recommend that you consider [Spring Cloud Azure](/azure/developer/java/spring-framework/) as an alternative. Spring Cloud Azure is an open-source project that provides seamless Spring integration with Azure services. To learn more about Spring Cloud Azure, and to see an example using Service Bus, see [Spring Cloud Stream with Azure Service Bus](/azure/developer/java/spring-framework/configure-spring-cloud-stream-binder-java-app-with-service-bus).
+> If you're working with Azure Service Bus resources in a Spring application, we recommend that you consider [Spring Cloud Azure](/azure/developer/java/spring-framework/). Spring Cloud Azure is an open-source project that provides seamless Spring integration with Azure services. To learn more about Spring Cloud Azure, and to see an example using Service Bus, see [Spring Cloud Stream with Azure Service Bus](/azure/developer/java/spring-framework/configure-spring-cloud-stream-binder-java-app-with-service-bus).
 
 ## Prerequisites
-- An Azure subscription. To complete this tutorial, you need an Azure account. You can activate your [MSDN subscriber benefits](https://azure.microsoft.com/pricing/member-offers/credit-for-visual-studio-subscribers/?WT.mc_id=A85619ABF) or sign up for a [free account](https://azure.microsoft.com/free/?WT.mc_id=A85619ABF).
-- Install [Azure SDK for Java][Azure SDK for Java]. If you're using Eclipse, you can install the [Azure Toolkit for Eclipse][Azure Toolkit for Eclipse] that includes the Azure SDK for Java. You can then add the **Microsoft Azure Libraries for Java** to your project. If you're using IntelliJ, see [Install the Azure Toolkit for IntelliJ](/azure/developer/java/toolkit-for-intellij/installation).
 
+- An Azure subscription. To complete this quickstart, you need an Azure account. You can activate your [Monthly Azure credits for Visual Studio subscribers](https://azure.microsoft.com/pricing/member-offers/credit-for-visual-studio-subscribers/?WT.mc_id=A85619ABF) or sign up for a [free account](https://azure.microsoft.com/free/?WT.mc_id=A85619ABF).
+
+- Install [Azure SDK for Java][Azure SDK for Java].
+
+  - If you're using Eclipse, you can install the [Azure Toolkit for Eclipse][Azure Toolkit for Eclipse] that includes the Azure SDK for Java. You can then add the **Microsoft Azure Libraries for Java** to your project. 
+  - If you're using IntelliJ, see [Install the Azure Toolkit for IntelliJ](/azure/developer/java/toolkit-for-intellij/installation).
+ 
 [!INCLUDE [service-bus-create-namespace-portal](./includes/service-bus-create-namespace-portal.md)]
 
 [!INCLUDE [service-bus-create-queue-portal](./includes/service-bus-create-queue-portal.md)]
@@ -34,16 +38,18 @@ In this quickstart, you create a Java app to send messages to and receive messag
 
 
 ## Send messages to a queue
-In this section, you'll create a Java console project, and add code to send messages to the queue that you created earlier.
+
+In this section, you create a Java console project, and add code to send messages to the queue that you created earlier.
 
 ### Create a Java console project
+
 Create a Java project using Eclipse or a tool of your choice.
 
 ### Configure your application to use Service Bus
-Add references to Azure Core and Azure Service Bus libraries.
 
-If you're using Eclipse and created a Java console application, convert your Java project to a Maven: right-click the project in the **Package Explorer** window, select **Configure** -> **Convert to Maven project**. Then, add dependencies to these two libraries as shown in the following example.
+Add references to Azure Core and Azure Service Bus libraries.
 
+If you're using Eclipse and created a Java console application, convert your Java project to a Maven: right-click the project in the **Package Explorer** window. Select **Configure** > **Convert to Maven project**. Then, add dependencies to these two libraries as shown in the following example.
 
 ### [Passwordless (Recommended)](#tab/passwordless)
 Update the `pom.xml` file to add dependencies to Azure Service Bus and Azure Identity packages.
@@ -101,7 +107,8 @@ Update the `pom.xml` file to add a dependency to the Azure Service Bus package.
     import java.util.List;
     ```
     ---
-2. In the class, define variables to hold connection string and queue name.
+
+1. In the class, define variables to hold the connection string and queue name.
 
     ### [Passwordless (Recommended)](#tab/passwordless)
 
@@ -123,7 +130,8 @@ Update the `pom.xml` file to add a dependency to the Azure Service Bus package.
     > Replace `<NAMESPACE CONNECTION STRING>` with the connection string to your Service Bus namespace, and `<QUEUE NAME>` with the name of the queue.
 
     ---
-3. Add a method named `sendMessage` in the class to send one message to the queue.
+
+1. Add a method named `sendMessage` in the class to send one message to the queue.
 
     ### [Passwordless (Recommended)](#tab/passwordless)
 
@@ -169,7 +177,8 @@ Update the `pom.xml` file to add a dependency to the Azure Service Bus package.
     }
     ```
     ---
-4. Add a method named `createMessages` in the class to create a list of messages. Typically, you get these messages from different parts of your application. Here, we create a list of sample messages.
+
+1. Add a method named `createMessages` in the class to create a list of messages. Typically, you get these messages from different parts of your application. In this example, you use a list of sample messages.
 
     ```java
     static List<ServiceBusMessage> createMessages()
@@ -183,7 +192,8 @@ Update the `pom.xml` file to add a dependency to the Azure Service Bus package.
         return Arrays.asList(messages);
     }
     ```
-5. Add a method named `sendMessageBatch` method to send messages to the queue you created. This method creates a `ServiceBusSenderClient` for the queue, invokes the `createMessages` method to get the list of messages, prepares one or more batches, and sends the batches to the queue.
+
+1. Add a method named `sendMessageBatch` method to send messages to the queue you created. This method creates a `ServiceBusSenderClient` for the queue, invokes the `createMessages` method to get the list of messages, prepares one or more batches, and sends the batches to the queue.
 
     ### [Passwordless (Recommended)](#tab/passwordless)
 
@@ -294,6 +304,7 @@ Update the `pom.xml` file to add a dependency to the Azure Service Bus package.
     ---
 
 ## Receive messages from a queue
+
 In this section, you add code to retrieve messages from the queue.
 
 1. Add a method named `receiveMessages` to receive messages from the queue. This method creates a `ServiceBusProcessorClient` for the queue by specifying a handler for processing messages and another one for handling errors. Then, it starts the processor, waits for few seconds, prints the messages that are received, and then stops and closes the processor.
@@ -302,7 +313,6 @@ In this section, you add code to retrieve messages from the queue.
 
     > [!IMPORTANT]
     > - Replace `NAMESPACENAME` with the name of your Service Bus namespace.
-    > - Replace `QueueTest` in `QueueTest::processMessage` in the code with the name of your class.
 
     ```java
     // handles received messages
@@ -356,7 +366,8 @@ In this section, you add code to retrieve messages from the queue.
     }
     ```
     ---
-2. Add the `processMessage` method to process a message received from the Service Bus subscription.
+
+1. Add the `processMessage` method to process a message received from the Service Bus subscription.
 
     ```java
     private static void processMessage(ServiceBusReceivedMessageContext context) {
@@ -365,7 +376,8 @@ In this section, you add code to retrieve messages from the queue.
             message.getSequenceNumber(), message.getBody());
     }
     ```
-3. Add the `processError` method to handle error messages.
+
+1. Add the `processError` method to handle error messages.
 
     ```java
     private static void processError(ServiceBusErrorContext context) {
@@ -400,7 +412,8 @@ In this section, you add code to retrieve messages from the queue.
         }
     }
     ```
-2. Update the `main` method to invoke `sendMessage`, `sendMessageBatch`, and `receiveMessages` methods and to throw `InterruptedException`.
+
+1. Update the `main` method to invoke `sendMessage`, `sendMessageBatch`, and `receiveMessages` methods and to throw `InterruptedException`.
 
     ```java
     public static void main(String[] args) throws InterruptedException {
@@ -415,19 +428,21 @@ In this section, you add code to retrieve messages from the queue.
 ### [Passwordless (Recommended)](#tab/passwordless)
 
 1. If you're using Eclipse, right-click the project, select **Export**, expand **Java**, select **Runnable JAR file**, and follow the steps to create a runnable JAR file.
-1. If you're signed into the machine using a user account that's different from the user account added to the **Azure Service Bus Data Owner** role, follow these steps. Otherwise, skip this step and move on to run the Jar file in the next step.
+1. If you're signed under a user account that's different from the one that you added to the **Azure Service Bus Data Owner** role, follow these steps. Otherwise, move on to run the Jar file in the next step.
+
+   1. [Install Azure CLI](/cli/azure/install-azure-cli-windows) on your machine.
+   1. Run the following CLI command to sign in to Azure. Use the same user account that you added to the **Azure Service Bus Data Owner** role.
 
-    1. [Install Azure CLI](/cli/azure/install-azure-cli-windows) on your machine.
-    1. Run the following CLI command to sign in to Azure. Use the same user account that you added to the **Azure Service Bus Data Owner** role.
+      ```azurecli
+      az login
+      ```
 
-        ```azurecli
-        az login
-        ```
 1. Run the Jar file using the following command.
 
     ```java
     java -jar <JAR FILE NAME>
     ```
+
 1. You see the following output in the console window.
 
     ```console
@@ -458,15 +473,14 @@ Stopping and closing the processor
 
 On the **Overview** page for the Service Bus namespace in the Azure portal, you can see **incoming** and **outgoing** message count. Wait for a minute or so and then refresh the page to see the latest values.
 
-:::image type="content" source="./media/service-bus-java-how-to-use-queues/overview-incoming-outgoing-messages.png" alt-text="Incoming and outgoing message count" lightbox="./media/service-bus-java-how-to-use-queues/overview-incoming-outgoing-messages.png":::
-
-Select the queue on this **Overview** page to navigate to the **Service Bus Queue** page. You see the **incoming** and **outgoing** message count on this page too. You also see other information such as the **current size** of the queue, **maximum size**, **active message count**, and so on.
+:::image type="content" source="./media/service-bus-java-how-to-use-queues/overview-incoming-outgoing-messages.png" alt-text="Screenshot shows the incoming and outgoing message count." lightbox="./media/service-bus-java-how-to-use-queues/overview-incoming-outgoing-messages.png":::
 
-:::image type="content" source="./media/service-bus-java-how-to-use-queues/queue-details.png" alt-text="Queue details" lightbox="./media/service-bus-java-how-to-use-queues/queue-details.png":::
+Select the queue on this **Overview** page to navigate to the **Service Bus Queue** page. You see the **incoming** and **outgoing** message count on this page too. You also see other information such as the **current size** of the queue, and **maximum size**, **active message count**.
 
+:::image type="content" source="./media/service-bus-java-how-to-use-queues/queue-details.png" alt-text="Screenshot shows the queue details for the messages for this queue." lightbox="./media/service-bus-java-how-to-use-queues/queue-details.png":::
 
+## Related content
 
-## Next Steps
 See the following documentation and samples:
 
 - [Azure Service Bus client library for Java - Readme](https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/servicebus/azure-messaging-servicebus/README.md)
