Creating a Queue
After Creating Your First Messaging Service and Trying Out Your Messaging Service, you may want to create a queue so you can send and receive some guaranteed messages. This tutorial walks you through creating a queue. You will also make sure the queue is working by connecting a publisher and publishing a matching message to that queue.
The goal of this tutorial is to demonstrate how to create a queue and confirm that it is working. This tutorial will show you how to:
- create a queue
- map a topic to a queue
- publish a message a queue
- confirm that the message appears in the queue
Step 1: Create a Queue
To create a queue, do the following:
- On the left-hand menu, click Messaging Services.
- Click your messaging service to navigate to messaging service details.
- On the service details page, click the Manage tab.
The Manage page displays, providing access to tools for managing your messaging service.
- On the Manage page, click the Queues tile.
The Queues page opens in a new browser tab.
- Click the +Queue button.
- Enter a name for your queue and click Create. You can use most characters in your queue name, including spaces. Some punctuation marks ('<>*?&;) are not allowed. If you use a slash (/) in the name, it cannot be the first character.
- On the Edit Queue Settings page, click Apply to accept all the default settings.
- Your new queue is displayed on the summary page. The queue is empty, so you will see zeros (0) in both the Messages Queued columns.
Step 2: Map a topic to queue
While it is possible to publish directly to a queue by its name, it is common to map a topic to a queue for more flexibility. In this case, mapping a topic to a queue will allow us to use the Try Me! tab to publish a message to our queue to test it out.
To map a topic to a queue, do the following.
- From the queue summary, click anywhere in the row describing the queue to open the queue detail view.
- From the queue detail view, click the Subscriptions tab.
On the Subscriptions tab, click the +Subscription button.
- Enter the topic "try-me" as the subscription and click the Create button. This is the default topic of the Try Me! tab.
- The topic "try-me" is now mapped to the queue. Messages published to that topic will go into the queue.
Step 3: Publish a message to the queue
We will use the publisher CodePen project on the Try Me! tab to publish a message into our queue. We are not going to use a subscriber connection.
To publish a message to the queue, follow the steps below.
- Return to the main Solace Cloud browser tab and click the Try Me! tab.
- In the Publisher CodePen, click Connect.
- Validate that the publisher is connected.
- In the Publisher CodePen, under step 2, publish a message with try-me as the topic name.
Step 4: Confirm the message is in the queue
- On the Queues page (in the other browser tab), click Queues in the left-hand menu.
Your queue is listed on the summary page.
- Verify that the the Messages Queued column shows 1 message, and that a non-zero value is shown in the Messages Queued Quota (MB) column.
Congratulations! Your queue is working.
- To see more details about the message in the queue, click anywhere in the row describing the queue, then click the Messages Queued tab.
For example, you can see the message ID assigned to the message and the time when it was published.
Step 5: Learn more
Well done. You have now created a queue in your messaging service and published a message to it. Want to learn more?