This was migrated to https://github.com/rabbitmq/rabbitmq-server
This repository has been moved to the main unified RabbitMQ "monorepo", including all open issues. You can find the source under /deps/rabbitmq_jms_topic_exchange. All issues have been transferred.
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.
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.
This plugin targets RabbitMQ 3.6.0 and later versions.
This plugin ships with RabbitMQ starting with 3.6.3. Enable it with
[sudo] rabbitmq-plugins enable rabbitmq_jms_topic_exchange
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 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/*
(c) 2007-2020 VMware, Inc. or its affiliates.
See LICENSE for license information.