rabbitmq-server/deps/rabbitmq_jms_topic_exchange

RabbitMQ JMS Topic Exchange Plugin

Overview

This plugin adds server-side support for RabbitMQ JMS client. This plugin provides support for JMS topic routing and selection based on JMS SQL selection rules.

This implementation is based upon the Java Messaging Service Specification Version 1.1.

Project Maturity

RabbitMQ JMS-related projects are several years old and can be considered reasonably mature. They have been first open sourced in June 2016. Some related projects (e.g. a compliance test suite) and documentation are yet to be open sourced.

Supported RabbitMQ Versions

This plugin targets RabbitMQ 3.6.0 and later versions.

Installation

This plugin ships with RabbitMQ starting with 3.6.3. Enable it with

[sudo] rabbitmq-plugins enable rabbitmq_jms_topic_exchange

Design

The plugin this generates is a user-written exchange type for RabbitMQ client use. The exchange type name is "x_jms_topic" but this is not a topic exchange. Instead it works together with a standard topic exchange to provide the JMS topic selection function.

When JMS Selectors are used on a Topic Destination consumer, the destination (queue) is bound to an exchange of type x_jms_topic, with arguments that indicate what the selection criteria are. The x_jms_topic exchange is, in turn, bound to the standard Topic Exchange used by JMS messaging (this uses the RabbitMQ exchange-to-exchange binding extension to the AMQP 0-9-1 protocol).

In this way, normal topic routing can occur, with the overhead of selection only applying when selection is used, and after the routing and filtering implied by the topic name.

Building From Source

Building is no different from building other RabbitMQ plugins.

TL;DR:

git clone https://github.com/rabbitmq/rabbitmq-jms-topic-exchange.git
cd rabbitmq-jms-topic-exchange
make -j dist
ls plugins/*

Copyright and License

(c) 2007-2020 VMware, Inc. or its affiliates.

See LICENSE for license information.