messaginghub / pooled-jms

A JMS Connection pool for messaging applications supporting JMS 1.1 and 2.0 and Jakarta JMS clients
Apache License 2.0
50 stars 24 forks source link

PooledJMS

JMS Connection pool for messaging applications that provides pooling for JMS Connections, Sessions and MessageProducers.

This project was forked from the ActiveMQ JMS Pool and enhanced to provide JMS 2.0 functionality.

Following the 3.0 release this project has transitioned to the Jakarta JMS API. For those still using JMS 2.0 or 1.1 based clients the previous 2.x release series should be used.

Below are some quick pointers you might find useful.

Using the PooledJMS library

To use the PooledJMS library in your projects you can include the maven dependency in your project pom file:

<dependency>
  <groupId>org.messaginghub</groupId>
  <artifactId>pooled-jms</artifactId>
  <version>${pooled-jms-version}</version>
</dependency>

Building the code

The project requires Maven 3. Some example commands follow.

Clean previous builds output and install all modules to local repository without running the tests:

mvn clean install -DskipTests

Install all modules to the local repository after running all the tests:

mvn clean install

Perform a subset tests on the packaged release artifacts without installing:

mvn clean verify -Dtest=TestNamePattern*

Execute the tests and produce code coverage report:

mvn clean test jacoco:report

Examples

First build and install all the modules as detailed above (if running against a source checkout/release, rather than against released binaries) and then consult the README in the pooled-jms-examples module itself.

Documentation

There is some basic documentation in the pooled-jms-docs module.

Continuous Integration

Build