Hello World: Simple Queue
Create your first RabbitMQ producer and consumer to send and receive messages through a basic queue. Understand the 'Hello World' of message brokering.
Hello World: Simple Queue is a free RabbitMQ Messaging & Async Systems lesson on CoddyKit — lesson 1 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the RabbitMQ Messaging & Async Systems learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.
Your First Message Queue!
Welcome to your first hands-on lesson with RabbitMQ! We're going to create a simple 'Hello World' example, which is the foundational step for understanding message queues.
This lesson focuses on the absolute basics: sending a message to a queue and receiving it.
The Core Trio: P, C, Q
Every simple message queue system has three main parts:
- Producer: The application that sends messages.
- Queue: A buffer that stores messages. Think of it as a mailbox.
- Consumer: The application that receives and processes messages from the queue.
In our 'Hello World', a Producer will send 'Hello World!' to a Queue, and a Consumer will pick it up.
Basic Message Flow
The process is straightforward:
- The Producer connects to RabbitMQ.
- It sends a message to a named Queue.
- The Consumer also connects to RabbitMQ.
- It listens to the same named Queue.
- When a message arrives, the Consumer receives and processes it.
This decouples the sender from the receiver, allowing them to operate independently.
Connecting to RabbitMQ
Before sending or receiving, our applications need to connect to the RabbitMQ server. We use a ConnectionFactory to establish this link.
A Connection represents a TCP connection to the broker. From this connection, we create a Channel, which is where most of the API operations are performed.
Declaring a Queue
Both the producer and consumer need to agree on which queue to use. We declare a queue using channel.queueDeclare(). Declaring a queue is idempotent, meaning you can call it multiple times without issues.
If the queue doesn't exist, it will be created. If it already exists, it will do nothing.
Producer: Sending 'Hello World!'
Here's a simple Java program that acts as a producer. It connects to RabbitMQ, declares a queue named "hello", and sends a single message.
Remember, RabbitMQ needs to be running on localhost for this to work (as set up in a previous lesson).
import com.rabbitmq.client.Channel;
import com.rabbitmq.client.Connection;
import com.rabbitmq.client.ConnectionFactory;
public class Producer {
private final static String QUEUE_NAME = "hello";
public static void main(String[] argv) throws Exception {
ConnectionFactory factory = new ConnectionFactory();
factory.setHost("localhost");
try (Connection connection = factory.newConnection();
Channel channel = connection.createChannel()) {
channel.queueDeclare(QUEUE_NAME, false, false, false, null);
String message = "Hello World!";
channel.basicPublish("", QUEUE_NAME, null, message.getBytes("UTF-8"));
System.out.println(" [x] Sent '" + message + "'");
}
}
}Consumer: Receiving Messages
Now, let's create the consumer. This program also connects to RabbitMQ, declares the same "hello" queue, and then continuously waits for messages.
When a message arrives, it will print it to the console. The true in basicConsume means messages are automatically acknowledged.
import com.rabbitmq.client.Channel;
import com.rabbitmq.client.Connection;
import com.rabbitmq.client.ConnectionFactory;
import com.rabbitmq.client.DeliverCallback;
public class Consumer {
private final static String QUEUE_NAME = "hello";
public static void main(String[] argv) throws Exception {
ConnectionFactory factory = new ConnectionFactory();
factory.setHost("localhost");
Connection connection = factory.newConnection();
Channel channel = connection.createChannel();
channel.queueDeclare(QUEUE_NAME, false, false, false, null);
System.out.println(" [*] Waiting for messages. To exit press CTRL+C");
DeliverCallback deliverCallback = (consumerTag, delivery) -> {
String message = new String(delivery.getBody(), "UTF-8");
System.out.println(" [x] Received '" + message + "'");
};
channel.basicConsume(QUEUE_NAME, true, deliverCallback, consumerTag -> { });
}
}Running the Example
To see it in action, you would typically:
- Ensure RabbitMQ is running (e.g., via Docker).
- Run the Consumer application first. It will start waiting.
- Run the Producer application. It will send the message.
- Observe the Consumer's output: it should print " [x] Received 'Hello World!'".
Congratulations, you've just sent your first message through RabbitMQ!
Key Takeaways of Simple Queue
The 'Hello World' simple queue demonstrates:
- One-to-one messaging: One producer, one queue, one consumer (though multiple consumers can compete for messages, as we'll see later).
- Basic message buffering: Messages are stored in the queue until a consumer is ready.
- Decoupling: Producer and consumer don't need to be running at the same time.
This is the simplest form of messaging, perfect for getting started.
Quick Check: Message Flow
Consider the basic 'Hello World' setup. What is the correct order of components for a message to be successfully delivered and processed?
Recap: Your First Message!
You've successfully created your first RabbitMQ 'Hello World'!
- You learned about the core components: Producer, Queue, and Consumer.
- You saw how to connect to RabbitMQ and declare a queue.
- You implemented simple Java code to send and receive a message.
This foundational understanding will serve you well as we explore more complex messaging patterns!
Frequently asked questions
Is the “Hello World: Simple Queue” lesson free?
Yes — the full text of “Hello World: Simple Queue” is free to read here on the web, and the RabbitMQ Messaging & Async Systems course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the RabbitMQ Messaging & Async Systems course, upgrade to CoddyKit PRO.
What will I learn in “Hello World: Simple Queue”?
Create your first RabbitMQ producer and consumer to send and receive messages through a basic queue. Understand the 'Hello World' of message brokering. You practise RabbitMQ Messaging & Async Systems with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.
Do I need any experience to start RabbitMQ Messaging & Async Systems?
No prior experience is required. RabbitMQ Messaging & Async Systems on CoddyKit is structured for beginners through advanced learners; this is — lesson 1 of 4, so you can start here or from the beginning and move at your own pace.
How long does the “Hello World: Simple Queue” lesson take?
Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.
Can I write and run code in this RabbitMQ Messaging & Async Systems lesson?
Yes. Every RabbitMQ Messaging & Async Systems lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.