Name		Name	Last commit message	Last commit date
Latest commit History 6,063 Commits
.github		.github
.mvn		.mvn
ci		ci
doc/channels		doc/channels
src		src
.git-blame-ignore-revs		.git-blame-ignore-revs
.gitignore		.gitignore
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
LICENSE-APACHE2		LICENSE-APACHE2
LICENSE-GPL2		LICENSE-GPL2
LICENSE-MPL-RabbitMQ		LICENSE-MPL-RabbitMQ
Makefile		Makefile
README.adoc		README.adoc
RUNNING_TESTS.md		RUNNING_TESTS.md
codegen.py		codegen.py
deploy-javadoc.sh		deploy-javadoc.sh
generate-observation-documentation.sh		generate-observation-documentation.sh
mvnw		mvnw
mvnw.cmd		mvnw.cmd
pom.xml		pom.xml
release-versions.txt		release-versions.txt

Repository files navigation

RabbitMQ Java Client

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

RabbitMQ Server Compatibility

This client releases are independent of RabbitMQ server releases and can be used with RabbitMQ server4.x and3.x (note that the3.x series isout of community support).

Minimum Supported JDK Version

This library requires Java 8 or higher.

Dependency (Maven Artifact)

Stable

Maven

pom.xml

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

Gradle

build.gradle

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

Snapshots

Maven

pom.xml

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

Snapshots are available on the central portal snapshot repository:

pom.xml

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

Gradle

build.gradle

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

Snapshots are available on the central portal snapshot repository:

build.gradle

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

4.x Series

As of 1 January 2021 the 4.x branch is no longer supported.

Experimenting with JShell

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

git clone https://github.com/rabbitmq/rabbitmq-java-client.gitcd rabbitmq-java-client./mvnw test-compile jshell:run...import com.rabbitmq.client.*ConnectionFactory cf = newConnectionFactory()Connection c =cf.newConnection()...c.close()/exit

Building from Source

Getting the Project and its Dependencies

git clone git@github.com:rabbitmq/rabbitmq-java-client.gitcd rabbitmq-java-clientmake deps

Building the JAR File

./mvnw clean package -Dmaven.test.skip

Launching Tests with the Broker Running in a Docker Container

Run the broker:

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

Launch "essential" tests (takes about 10 minutes):

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

Launch a single test:

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

Launching Tests with a Local Broker

The tests can run against a local broker as well. Therabbitmqctl.binsystem property must point to therabbitmqctl program:

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

To launch a single test:

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

Contributing

SeeContributing andHow to Run Tests.

Versioning

This library usessemantic versioning.

Support

See theRabbitMQ Java libraries support pagefor the support timeline of this library.

License

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

This means that the user can consider the library to be licensed underany 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.