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 unMessageConverter(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 unMessageConverteradapté 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-exchangeest défini sur la queue.
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.