-
Language:
English
-
Language:
English
Chapter 3. Getting started
This chapter guides you through a simple exercise to help you get started using AMQ Core Protocol JMS.
3.1. Prerequisites
- The example programs are located in the AMQ Broker zip file. To get started, you must install the zip file.
- To build the example, Maven must be configured to use the Red Hat repository or a local repository.
3.2. Preparing the broker
The example programs require a running broker with a queue named exampleQueue
. Follow these steps to define the queue and start the broker:
Procedure
- Install the broker.
- Create a broker instance. Enable anonymous access.
Start the broker instance and check the console for any critical errors logged during startup.
$ <broker-instance-dir>/bin/artemis run ... 14:43:20,158 INFO [org.apache.activemq.artemis.integration.bootstrap] AMQ101000: Starting ActiveMQ Artemis Server ... 15:01:39,686 INFO [org.apache.activemq.artemis.core.server] AMQ221020: Started Acceptor at 0.0.0.0:5672 for protocols [AMQP] ... 15:01:39,691 INFO [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
Use the
artemis queue
command to create a queue calledexampleQueue
.<broker-instance-dir>/bin/artemis queue create --name exampleQueue --auto-create-address --anycast
You are prompted to answer a series of questions. For yes or no questions, type
N
. Otherwise, press Enter to accept the default value.
3.3. Running your first example
Procedure
Use Maven to build the examples by running the following command in the
<install-dir>/examples/features/standard/queue
directory.mvn clean package dependency:copy-dependencies -DincludeScope=runtime -DskipTests
The addition of
dependency:copy-dependencies
results in the dependencies being copied into thetarget/dependency
directory.Use the
java
command to run the example.On Linux or UNIX:
java -cp "target/classes:target/dependency/*" org.apache.activemq.artemis.jms.example.QueueExample
On Windows:
java -cp "target\classes;target\dependency\*" org.apache.activemq.artemis.jms.example.QueueExample
The example creates a consumer and producer for a queue named exampleQueue
. It sends a text message and then receives it back, printing the received message to the console.
Running it on Linux results in the following output.
$ java -cp "target/classes:target/dependency/*" org.apache.activemq.artemis.jms.example.QueueExample Sent message: This is a text message Received message: This is a text message
The source code for the example is in the <install-dir>/examples/features/standard/queue/src
directory. Additional examples are available in the <install-dir>/examples/features/standard
directory.