Apache ActiveMQ ™ -- Version 5 Examples
Using ActiveMQ 5 > Version 5 Examples
Since version 5.12.0, Apache ActiveMQ comes with the new tool that can be used to produce and consume messages from the broker.
Prerequisites
Before running the examples you should try running a JMS broker on your machine. Follow the Installation instructions to use a binary distribution of ActiveMQ. To run the broker in a command shell, type:
bin/activemq console
This starts up ActiveMQ.
Running
From the command line you can run
${ACTIVEMQ_HOME}/bin/activemq producer ${ACTIVEMQ_HOME}/bin/activemq consumer
If you have activemq-all jar available you can achieve the same with
java -jar activemq-all-5.x.x.jar producer java -jar activemq-all-5.x.x.jar consumer
If you run inside Karaf, you can run the commands as
activemq:producer activemq:consumer
Options
For all options on the commands, run them with --help parameter. The up to date, options for producer and consumer can be found in the source.
Examples
Here are a couple of examples of more advanced features.
To send a text message with custom text use
bin/activemq producer --message "My message" --messageCount 1
To send byte message of custom length use
bin/activemq producer --messageSize 100 --messageCount 1
To send a text message with content obtained from an url
bin/activemq producer --payloadUrl http://activemq.apache.org/schema/core/activemq-core.xsd --messageCount 1
To consume in transaction use
bin/activemq consumer --transacted true
To use client acknowledgment use
bin/activemq consumer --ackMode CLIENT_ACKNOWLEDGE
To use durable topic subscribers use
bin/activemq consumer --durable true --clientId example --destination topic://TEST
Old examples
In older versions of ActiveMQ, the corresponding examples were located in examples/ or examples/openwire/swissarmy/ directories, where you can do the similar tasks with an ant script.
ant producer ant consumer
Other examples
In examples/ directory (depending on the version) you can find more examples of using the broker with variety of protocols (mqtt, amqp, ...) and clients (Java, Ruby, JavaScript, ...), so it's the good place to start learning. Also, examples/conf/ directory contains a lot of different configuration examples that you can use as a starting point for your deployment.