Java JMS Client for RabbitMQ

Overview

This is a JMS 1.1 client library for RabbitMQ, working in concert with rabbitmq-jms-topic-exchange, a RabbitMQ server plugin.

Installation

With Maven or Gradle

This package is published to several Maven package repositories:

• Maven Central
• RabbitMQ Maven Release repository on Bintray
• RabbitMQ Maven Milestones repository on Bintray
• Sonatype OSS snapshot repository for snapshots

Add the following to pom.xml for Maven:

<dependency>
  <groupId>com.rabbitmq.jms</groupId>
  <artifactId>rabbitmq-jms</artifactId>
  <version>2.1.1</version>
</dependency>

Or the following to build.gradle for Gradle:

compile 'com.rabbitmq.jms:rabbitmq-jms:2.1.1'

Building from Source

This project is managed by Maven, so use

./mvnw clean install

to build it from source and install into the local repository.

Running Tests

See CONTRIBUTING.md for an overview of the development process.

Unit Tests

./mvnw clean test

Integration Tests

The integration tests assume a RabbitMQ node with rabbitmq-jms-topic-exchange listening on localhost:5672 (the default settings).

Connection recovery tests need rabbitmqctl to control the running node.

Maven will start this node with the appropriate configuration by default when launching the verify command:

./mvnw clean verify

You can also provide your own broker node. To disable the automatic test node setup, disable the setup-test-node Maven profile:

./mvn clean verify -P '!setup-test-node'

The easiest way to run a test node is to clone rabbitmq-jms-topic-exchange and use make run-broker.

JMS 1.1 Compliance Test Suite

JMS 1.1 compliance test suite for this client is available in a separate repository.

Versioning

This library uses semantic versioning.

Support

See the RabbitMQ Java libraries support page for the support timeline of this library.

License and Copyright

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

This package, the RabbitMQ JMS client library, is double-licensed under the Apache License version 2 ("ASL") and the Mozilla Public License 2.0 ("MPL").

See LICENSE.