RabbitMQ Messaging & Async Systems · Lesson

Fanout Exchange for Pub/Sub

Understand and implement the Fanout exchange to broadcast messages to all bound queues. This is ideal for simple publish/subscribe scenarios.

Fanout Exchange for Pub/Sub 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.

Pub/Sub & Fanout Explained

Imagine you want to broadcast a message to everyone interested, without knowing who they are. This is the idea behind the Publish/Subscribe (Pub/Sub) messaging pattern.

In RabbitMQ, the Fanout exchange is perfect for this. It acts like a megaphone, shouting your message to all connected listeners.

How Fanout Exchanges Work

A Fanout exchange is the simplest type of exchange. When a message arrives at a Fanout exchange, it doesn't care about routing keys.

It takes the message.
It duplicates it for every queue that is bound to it.
Then, it sends a copy of the message to each of those bound queues.

Think of it as a broadcast to all subscribers.

Key Components

Let's quickly recap the main players:

Producer: Sends the message.
Exchange: Receives messages from producers and routes them to queues. Fanout is one type.
Queue: A buffer that stores messages until a consumer picks them up.
Consumer: Receives messages from queues and processes them.

With Fanout, the exchange ensures all bound queues get the message.

Routing Keys Are Ignored

A crucial detail about Fanout exchanges: they completely ignore routing keys!

When a producer sends a message to a Fanout exchange, it might still provide a routing key (often an empty string), but the exchange simply disregards it.

Its only job is to broadcast to all queues bound to it, regardless of any key.

Setting Up the Fanout Exchange

First, our producer needs to declare the Fanout exchange. This tells RabbitMQ to create or ensure this exchange exists.

Notice the "fanout" type parameter. Try running this code to declare your exchange!

import com.rabbitmq.client.Channel;
import com.rabbitmq.client.Connection;
import com.rabbitmq.client.ConnectionFactory;

public class FanoutProducerSetup {
    private final static String EXCHANGE_NAME = "fanout_logs";

    public static void main(String[] argv) throws Exception {
        ConnectionFactory factory = new ConnectionFactory();
        factory.setHost("localhost");

        try (Connection connection = factory.newConnection();
             Channel channel = connection.createChannel()) {

            // Declare a fanout exchange
            channel.exchangeDeclare(EXCHANGE_NAME, "fanout");
            System.out.println("Fanout exchange '" + EXCHANGE_NAME + "' declared.");
        }
    }
}

Binding a Queue to Fanout

Consumers don't receive directly from exchanges. They receive from queues. Each consumer needs its own queue, and that queue must be bound to the Fanout exchange.

queueDeclare() with no arguments creates a unique, exclusive, auto-delete queue. The routing key for binding is an empty string, as it's ignored by Fanout.

import com.rabbitmq.client.Channel;
import com.rabbitmq.client.Connection;
import com.rabbitmq.client.ConnectionFactory;

public class FanoutConsumerSetup {
    private final static String EXCHANGE_NAME = "fanout_logs";

    public static void main(String[] argv) throws Exception {
        ConnectionFactory factory = new ConnectionFactory();
        factory.setHost("localhost");

        Connection connection = factory.newConnection();
        Channel channel = connection.createChannel();

        channel.exchangeDeclare(EXCHANGE_NAME, "fanout");
        String queueName = channel.queueDeclare().getQueue(); // A unique, auto-delete queue
        channel.queueBind(queueName, EXCHANGE_NAME, ""); // Bind with empty routing key

        System.out.println("Queue '" + queueName + "' declared and bound to '" + EXCHANGE_NAME + "'.");
        System.out.println("Ready for messages (but not consuming yet).");
    }
}

Publishing to Fanout Exchange

Once the exchange is declared, the producer can send messages to it. Notice how the basicPublish method specifies the exchange name, but the routing key is an empty string.

Run this code after you've set up your exchange. It will publish one message.

import com.rabbitmq.client.Channel;
import com.rabbitmq.client.Connection;
import com.rabbitmq.client.ConnectionFactory;
import java.nio.charset.StandardCharsets;

public class FanoutPublisher {
    private final static String EXCHANGE_NAME = "fanout_logs";

    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.exchangeDeclare(EXCHANGE_NAME, "fanout"); // Ensure exchange exists

            String message = "Hello everyone, this is a broadcast!";
            // Publish to the exchange, routing key is ignored for fanout
            channel.basicPublish(EXCHANGE_NAME, "", null, message.getBytes(StandardCharsets.UTF_8));
            System.out.println(" [x] Sent '" + message + "'");
        }
    }
}

Consuming Broadcasts

Now, let's make our consumer actually receive messages. The DeliverCallback defines what happens when a message arrives. Remember, each consumer has its own queue!

To see the broadcast in action, first run two separate instances of this consumer code. Then, run the publisher code from the previous scene. Both consumers should receive the message!

import com.rabbitmq.client.Channel;
import com.rabbitmq.client.Connection;
import com.rabbitmq.client.ConnectionFactory;
import com.rabbitmq.client.DeliverCallback;
import java.nio.charset.StandardCharsets;

public class FanoutSubscriber {
    private final static String EXCHANGE_NAME = "fanout_logs";

    public static void main(String[] argv) throws Exception {
        ConnectionFactory factory = new ConnectionFactory();
        factory.setHost("localhost");

        Connection connection = factory.newConnection();
        Channel channel = connection.createChannel();

        channel.exchangeDeclare(EXCHANGE_NAME, "fanout");
        String queueName = channel.queueDeclare().getQueue(); // Exclusive, auto-delete queue
        channel.queueBind(queueName, EXCHANGE_NAME, ""); // Bind to fanout exchange

        System.out.println(" [*] Waiting for messages in queue '" + queueName + "'. To exit press CTRL+C");

        DeliverCallback deliverCallback = (consumerTag, delivery) -> {
            String message = new String(delivery.getBody(), StandardCharsets.UTF_8);
            System.out.println(" [x] Received '" + message + "'");
        };
        // Auto-ack set to true for simplicity in this example
        channel.basicConsume(queueName, true, deliverCallback, consumerTag -> {});
    }
}

Fanout in Action

When you ran two consumers and then the publisher, you observed the core concept of Fanout: every active consumer received a copy of the message.

This is because each consumer had its own unique queue, and both queues were bound to the same fanout_logs exchange. The exchange simply duplicated the message to all bound queues.

This makes Fanout ideal for scenarios like real-time logging, notifications, or broadcasting updates.

Test Your Knowledge

Time for a quick check on Fanout exchanges!

Fanout Recap

You've successfully learned about the Fanout exchange!

It implements the Pub/Sub pattern.
It broadcasts messages to all bound queues.
It ignores routing keys when distributing messages.
It's perfect for scenarios where multiple consumers need to receive the same message.

Next, we'll explore the Direct exchange, which uses routing keys for more precise message delivery!

Frequently asked questions

Is the “Fanout Exchange for Pub/Sub” lesson free?

Yes — the full text of “Fanout Exchange for Pub/Sub” 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 “Fanout Exchange for Pub/Sub”?

Understand and implement the Fanout exchange to broadcast messages to all bound queues. This is ideal for simple publish/subscribe scenarios. 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 “Fanout Exchange for Pub/Sub” 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.

All lessons in this course

← Back to RabbitMQ Messaging & Async Systems