Java IBM MQ Example

An example SpringBoot application showcasing using a request/response queue pattern with a REST API.

Getting Started

IBM MQ Server

Install IBM MQ Queue Manager (Windows and Linux)

Follow these instructions to run an IBM MQ Queue Manager locally using Docker.

For MacOS Apple Silicon

You'll first need to run the following instructions to build a custom Docker image for IBM MQ Server. This is necessary because the official IBM MQ Server image does not support MacOS Apple Silicon.

Essentially the commands are:

git clone https://github.com/ibm-messaging/mq-container.git

cd mq-container

make build-devserver

Once done, you should have an IBM MQ server image in your local Docker image repository.

Run IBM MQ Server

You can run the IBM MQ Server using Docker Compose:

docker-compose up

Or manually run the container using the following command:

docker run --volume qm1data:/mnt/mqm --publish 1414:1414 --publish 9443:9443 --detach --env LICENSE=accept --env MQ_QMGR_NAME=QM1 --env MQ_APP_PASSWORD=passw0rd --env MQ_ADMIN_PASSWORD=passw0rd --name QM1 ibm-mqadvanced-server-dev:9.3.5.0-arm64

Reference Documentation

For further reference, please consider the following sections:

• Official Gradle documentation
• Spring Boot Gradle Plugin Reference Guide
• Create an OCI image
• Spring Web
• WebSocket
• Spring for Apache ActiveMQ Artemis

Guides

The following guides illustrate how to use some features concretely:

• Building a RESTful Web Service
• Serving Web Content with Spring MVC
• Building REST services with Spring
• Using WebSocket to build an interactive web application
• Messaging with JMS

Additional Links

These additional references should also help you:

• Gradle Build Scans – insights for your project's build