• Features
• Get Started
• Support
• Community
• Docs
• Blog

RabbitMQ Java Client Library

Overview

The RabbitMQ Java client library allows Java and JVM-based applications to connect to and interact with RabbitMQ nodes.

5.x release series of this library require JDK 8, both for compilation and at runtime. On Android, this means only Android 7.0 or later versions are supported.

4.x release series support JDK 6 and Android versions prior to 7.0.

See the RabbitMQ Java libraries support page for the support timeline.

Licensing

The library is open-source, and is triple-licensed under

• Apache Public License 2.0
• Mozilla Public License 2.0
• GPL 2.0

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

Prerequisites

RabbitMQ Java client connects to RabbitMQ server nodes.

You will need a running RabbitMQ node to use with the client library.

Latest Version

The current release of the RabbitMQ Java client is 5.17.0.

Adding Library Dependency

The recommended way to get started using the RabbitMQ Java client in your project is with a dependency management system.

If you're using Maven, add this dependency to the POM file of your project:

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

If using Gradle:

dependencies {
  compile 'com.rabbitmq:amqp-client:5.17.0'
}

We attempt to upload new versions of the Java client on the day of release; however the Maven servers are sometimes unavailable, so there may be a delay of a few days between a new release and its appearance in the central Maven repository. Please be patient.

Download the library and Documentation

The client and its API reference documentation can be downloaded directly.

The Library

The library is available in compiled form, and as source.

See the Signatures guide for details on how to verify package signatures, and the Java client build guide for instructions on compiling from source-code.

The Documentation

Please refer to the API guide.

The Javadoc documentation is browsable on-line, or you can download it for off-line use:

Javadoc for the latest 4.x series release is available as well.

Other Versions

Consult the archive if you want to download a version of the RabbitMQ Java Client library or documentation other than the above.

OSGi Ready

The RabbitMQ Java client jar comes ready with an OSGi manifest (with bundle version and package dependencies correctly set) so it can be deployed in an OSGi environment. This means it is no longer necessary to bundleise or OSGiefy the jar prior to using it in an OSGi container.

GitHub Repositories

The RabbitMQ Java client depends on the code generation library module. Please see the build page for instructions on compiling from source code.

git clone https://github.com/rabbitmq/rabbitmq-java-client.git

git clone https://github.com/rabbitmq/rabbitmq-server
cd rabbitmq-server/deps/rabbitmq_codegen