Menu

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

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.8.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.8.0</version>
</dependency>

If using Gradle:

dependencies {
  compile 'com.rabbitmq:amqp-client:5.8.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.

Description Download Signature
Binary, compiled for JDK 8 (Android 7.0) or newer amqp-client-5.8.0.jar Signature file
Source code amqp-client-5.8.0-sources.jar Signature file

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 browseable on-line, or you can download it for off-line use:

Description Download Signature
A JAR file containing generated Javadoc documentation amqp-client-5.8.0-javadoc.jar Signature file

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.

Snapshot Clone Repository
Java client
git clone https://github.com/rabbitmq/rabbitmq-java-client.git
Repository on GitHub
RabbitMQ Code Generator
git clone https://github.com/rabbitmq/rabbitmq-codegen.git
Repository on GitHub

Getting Help and Providing Feedback

If you have questions about the contents of this guide or any other topic related to RabbitMQ, don't hesitate to ask them on the RabbitMQ mailing list.

Help Us Improve the Docs <3

If you'd like to contribute an improvement to the site, its source is available on GitHub. Simply fork the repository and submit a pull request. Thank you!