Formations — 1 037 leçons en français

Accueil › Spring Boot › RabbitMQ avec Spring AMQP

RabbitMQ avec Spring AMQP

Événements et messagerieavance

RabbitMQ implémente le modèle AMQP : un producteur publie sur un exchange, qui route le message vers une ou plusieurs queues selon les bindings déclarés et la routing key du message. Contrairement à Kafka, une queue est une vraie file d'attente : un message consommé et acquitté en disparaît.

@Configuration
public class RabbitConfig {

    @Bean
    public Queue queueCommandes() {
        return new Queue("commandes.a-traiter");
    }

    @Bean
    public TopicExchange exchangeCommandes() {
        return new TopicExchange("commandes.evenements");
    }

    @Bean
    public Binding binding() {
        return BindingBuilder.bind(queueCommandes())
                .to(exchangeCommandes())
                .with("commandes.*.creee");
    }
}

Publier avec RabbitTemplate :

rabbitTemplate.convertAndSend("commandes.evenements", "commandes.fr.creee", commande);

Consommer avec @RabbitListener :

@RabbitListener(queues = "commandes.a-traiter")
public void traiter(CommandeDto commande) {
    facturationService.traiter(commande);
}

Quatre types d'exchange couvrent la plupart des besoins de routage : direct (correspondance exacte), topic (motifs avec */#), fanout (diffusion à tous, routing key ignorée) et headers (routage sur des attributs). Le choix du type dépend de la façon dont on veut filtrer les destinataires d'un message.

Les termes à connaître

Exchange

Point d'entrée auquel un producteur publie un message. L'exchange ne stocke rien : il route le message vers zéro, une ou plusieurs queues selon son type et les bindings déclarés.

Queue

File où les messages routés par un exchange s'accumulent jusqu'à leur consommation. C'est la queue, pas l'exchange, que consomme @RabbitListener.

Binding

Lien déclaré entre un exchange et une queue, éventuellement accompagné d'une routing key (ou de critères d'en-têtes pour un exchange headers). Sans binding, un message publié sur un exchange n'atteint aucune queue.

Routing key

Étiquette fournie par le producteur au moment de la publication. L'exchange la compare aux clés des bindings pour décider vers quelle(s) queue(s) livrer le message ; son interprétation dépend du type d'exchange.

Types d'exchange

direct : correspondance exacte routing key / binding key. topic : correspondance par motif (* = un mot, # = zéro ou plusieurs mots). fanout : diffusion à toutes les queues liées, routing key ignorée. headers : routage sur des attributs d'en-tête plutôt que sur la routing key.

RabbitTemplate

Client Spring AMQP pour publier (convertAndSend(exchange, routingKey, message)) et, plus rarement, consommer de façon synchrone. Utilise un MessageConverter (par défaut Java natif, en pratique presque toujours remplacé par du JSON) pour convertir l'objet Java en message AMQP.

@RabbitListener

Annotation posée sur une méthode pour en faire un consommateur d'une ou plusieurs queues (queues = "..."). Le message est désérialisé automatiquement si un MessageConverter adapté est configuré.

Dead letter exchange (DLX)

Exchange vers lequel une queue republie un message rejeté (acquittement négatif sans reprise), expiré (TTL) ou refusé faute de place, quand l'argument x-dead-letter-exchange est défini sur la queue.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.