RabbitMQ Java Client

This repository contains source code of the RabbitMQ Java client. The client is maintained by the RabbitMQ team at Broadcom.

This client releases are independent of RabbitMQ server releases and can be used with RabbitMQ server 4.x and 3.x (note that the 3.x series is out of community support).

This library requires Java 8 or higher.

Stable

<dependency>
    <groupId>com.rabbitmq</groupId>
    <artifactId>amqp-client</artifactId>
    <version>5.27.0</version>
</dependency>

compile 'com.rabbitmq:amqp-client:5.27.0'

Snapshots

<dependency>
    <groupId>com.rabbitmq</groupId>
    <artifactId>amqp-client</artifactId>
    <version>5.28.0-SNAPSHOT</version>
</dependency>

<repositories>
  <repository>
    <id>ossrh</id>
    <url>https://central.sonatype.com/repository/maven-snapshots/</url>
    <snapshots>
      <enabled>true</enabled>
    </snapshots>
    <releases>
      <enabled>false</enabled>
    </releases>
  </repository>
</repositories>

compile 'com.rabbitmq:amqp-client:5.28.0-SNAPSHOT'

repositories {
  maven { url 'https://central.sonatype.com/repository/maven-snapshots/' }
  mavenCentral()
}

4.x Series

You can experiment with the client from JShell. This requires Java 9 or more.

Getting the Project and its Dependencies

git clone git@github.com:rabbitmq/rabbitmq-java-client.git
cd rabbitmq-java-client
make deps

Building the JAR File

./mvnw clean package -Dmaven.test.skip

Launching Tests with the Broker Running in a Docker Container

docker run -it --rm --name rabbitmq -p 5672:5672 rabbitmq

./mvnw verify \
    -Drabbitmqctl.bin=DOCKER:rabbitmq \
    -Dit.test=ClientTestSuite,FunctionalTestSuite,ServerTestSuite

./mvnw verify \
    -Drabbitmqctl.bin=DOCKER:rabbitmq \
    -Dit.test=DeadLetterExchange

Launching Tests with a Local Broker

./mvnw verify \
       -Dtest-broker.A.nodename=rabbit@$(hostname) \
       -Drabbitmqctl.bin=/path/to/rabbitmqctl \
       -Dit.test=ClientTestSuite,FunctionalTestSuite,ServerTestSuite

./mvnw verify \
       -Dtest-broker.A.nodename=rabbit@$(hostname) \
       -Drabbitmqctl.bin=/path/to/rabbitmqctl \
       -Dit.test=DeadLetterExchange

See Contributing and How to Run Tests.

This library uses semantic versioning.

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

This package, the RabbitMQ Java client library, is triple-licensed under the Mozilla Public License 2.0 ("MPL"), the GNU General Public License version 2 ("GPL") and the Apache License version 2 ("AL").

This means that the user can consider the library to be licensed under any of the licenses from the list above. For example, you may choose the Apache Public License 2.0 and include this client into a commercial product. Projects that are licensed under the GPLv2 may choose GPLv2, and so on.