Skip to content


Subversion checkout URL

You can clone with
Download ZIP
HornetQ is an open source project to build a multi-protocol, embeddable, very high performance, clustered, asynchronous messaging system.
Java HTML C++ Shell XSLT JavaScript
branch: master

Merge pull request #2024 from TomasHofman/HORNETQ-1479

[HORNETQ-1479] JournalImpl.load() fails if there are truncated files
Failed to load latest commit information.
.settings Delete checked-in Eclipse project files.
distribution Revert "version update"
docs Update using-core.xml
etc getting rid of invalid junit.framework import and adding checkstyle t…
examples Revert "version update"
hornetq-bootstrap Revert "version update"
hornetq-commons - performance fixes
hornetq-core-client Merge pull request #1994 from mtaylor/setClientVersionRecreateSession
hornetq-dto Revert "version update"
hornetq-jms-client Throw runtime exception with problem description when creating durabl…
hornetq-jms-server Adding JMS Queue …
hornetq-journal [HORNETQ-1479] JournalImpl.load() fails if there are truncated files
hornetq-native Revert "version update"
hornetq-protocols - performance fixes
hornetq-ra Revert "version update"
hornetq-rest Revert "version update"
hornetq-selector Revert "version update"
hornetq-server improving print-data on journal
hornetq-service-sar Revert "version update"
hornetq-tools Revert "version update"
integration Revert "version update"
scripts update on script
tests [HORNETQ-1479] JournalImpl.load() fails if there are truncated files
.gitignore Ignore more Eclipse generated files
.project Delete checked-in Eclipse project files.
NOTICE replaced a load of JBoss Messaging references Add new commit msg format to README updating release instructions for upload binaries
hornetq_doap.rdf meta data for project
pom.xml - performance fixes


If you need information about the HornetQ project please go to

This file describes some minimum 'stuff one needs to know' to get started coding in this project.


The project's source code is hosted at:

Git usage:

Pull requests should be merged without fast forwards '--no-ff'. An easy way to achieve that is to use

% git config branch.master.mergeoptions --no-ff


The minimum required Maven version is 3.0.0.

Do note that there are some compatibility issues with Maven 3.X still unsolved 1. This is specially true for the 'site' plugin 2.


To run the unit tests:

% mvn -Phudson-tests test

Generating reports from unit tests:

% mvn install site

Running tests individually

% mvn -Phudson-tests -DfailIfNoTests=false -Dtest=<test-name> test

where <test-name> is the name of the Test class without its package name


To run an example firstly make sure you have run

% mvn -Prelease install

If the project version has already been released then this is unnecessary.

then you will need to set the following maven options, on Linux by

export MAVEN_OPTS="-Xmx1024m -XX:MaxPermSize=512m"

and the finally run the examples by

% mvn verify

You can also run individual examples by running the same command from the directory of which ever example you want to run. NB for this make sure you have installed examples/common.

Recreating the examples

If you are trying to copy the examples somewhere else and modifying them. Consider asking Maven to explicitly list all the dependencies:

# if trying to modify the 'topic' example:
cd examples/jms/topic && mvn dependency:list

To build a release artifact

% mvn -Prelease install

To build the release bundle

% mvn -Prelease package


We recommend using Eclipse Kepler (4.3), due to the built-in support for Maven and Git. Note that there are still some Maven plugins used by sub-projects (e.g. documentation) which are not supported even in Eclipse Kepler (4.3).

Eclipse m2e is already included in "Eclipse IDE for Java Developers", or it can be installed from Eclipse Kepler release repository.

Annotation Pre-Processing

HornetQ uses JBoss Logging and that requires source code generation from Java annotations. In order for it to 'just work' in Eclipse you need to install the Maven Integration for Eclipse JDT Annotation Processor Toolkit m2e-apt. See this JBoss blog post for details.

M2E Connector for Javacc-Maven-Plugin

Eclipse Indigo (3.7) has out-of-the-box support for it.

As of this writing, Eclipse Kepler (4.3) still lacks support for Maven's javacc plugin. The available m2e connector for javacc-maven-plugin requires a downgrade of Maven components to be installed. manual installation instructions (as of this writing you need to use the development update site). See this post for how to do this with Eclipse Juno (4.2).

The current recommended solution for Eclipse Kepler is to mark javacc-maven-plugin as ignored by Eclipse, run Maven from the command line and then modify the project hornetq-core-client adding the folder target/generated-sources/javacc to its build path.

Use Project Working Sets

Importing all HornetQ subprojects will create too many projects in Eclipse, cluttering your Package Explorer and Project Explorer views. One way to address that is to use Eclipse's Working Sets feature. A good introduction to it can be found at a Dzone article on Eclipse Working Sets.

Code Formatting

Eclipse code formatting and (basic) project configuration files can be found at the etc/ folder. You should manually copy them after importing all your projects:

for settings_dir in `find . -type d -name .settings`; do
   \cp -v etc/org.eclipse.jdt.* $settings_dir

Do not use the maven-eclipse-plugin to copy the files as it conflicts with m2e.

Committing Changes


We follow the GitHub workflow for all code changes in HornetQ. For information on the GitHub workflow please see:

Commit Messages

We follow the 50/72 git commit message format. A HornetQ commit message should be formatted in the following manner:

  • Add the HornetQ JIRA or Bugzilla reference (if one exists) followed by a brief description of the change in the first line.
  • Insert a single blank line after the first line.
  • Provide a detailed description of the change in the following lines, breaking paragraphs where needed.
  • The first line should be limited to 50 characters
  • Subsequent lines should be wrapped at 72 characters.

An example correctly formatted commit message:

HORNETQ-1234 Add new commit msg format to README

Adds a description of the new commit message format as well as examples
of well formatted commit messages to the  This is required 
to enable developers to quickly identify what the commit is intended to 
do and why the commit was added.
Something went wrong with that request. Please try again.