alexshvedoff / rabbitmq-jms-client

RabbitMQ JMS client

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

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 dependency to pom.xml:

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

Building from Source

This project is managed by Maven, so use

mvn 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

mvn 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:

mvn 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.

License and Copyright

(c) Pivotal Software, Inc., 2007-2017.

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

See LICENSE.