GitHub - rabbitmq/rabbitmq-java-client: RabbitMQ Java client (original) (raw)

• README
• Code of conduct
• Contributing
• License
• Apache-2.0 license
• GPL-2.0 license
• License
• Security

RabbitMQ Server Compatibility

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

Minimum Supported JDK Version

This library requires Java 8 or higher.

Dependency (Maven Artifact)

Stable

Maven

pom.xml

Gradle

build.gradle

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

Snapshots

Maven

pom.xml

Snapshots are available on the central portal snapshot repository:

pom.xml

Gradle

build.gradle

compile 'com.rabbitmq:amqp-client:5.31.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.git cd rabbitmq-java-client ./mvnw test-compile jshell:run ... import com.rabbitmq.client.* ConnectionFactory cf = new ConnectionFactory() 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.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

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. The rabbitmqctl.binsystem property must point to the rabbitmqctl 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

Versioning

Support

License

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.