This lab demonstrates a simple WebLogic JMS messaging flow using two ready-to-run Java applications:
- A standalone Java sender that sends a message to a WebLogic JMS queue.
- A Helidon SE 4 consumer that listens to the queue and receives the message.
The Helidon consumer also provides HTTP endpoints to check its health and view the last message received. The release packages are ready to run, so there is no need to download, compile, or build the source code.
GitHub repository:
https://github.com/puneethbuilds-helidon/weblogic-jms-helidon-consumer-demo
What the Lab Demonstrates
Standalone JMS Sender → WebLogic JMS Queue → Helidon JMS ConsumerThe sender connects to WebLogic Server through T3 and sends a message to the configured JMS queue. The Helidon application connects to the same queue, receives the message asynchronously, and makes it available through a simple HTTP endpoint.
What to Create in WebLogic Server
Before running the release JARs, create the following JMS resources in WebLogic Server:
| Resource | Value |
|---|---|
| JMS Server | TestJMSServer |
| JMS Module | TestJMSModule |
| Subdeployment | TestSubdeployment |
| Connection Factory | TestConnectionFactory |
| Connection Factory JNDI name | jms/TestConnectionFactory |
| Queue | TestQueue |
| Queue JNDI name | jms/TestQueue |
Target the JMS Server, connection factory, and queue to a running WebLogic Server. The queue must be assigned to the JMS Server through the subdeployment.
The demo uses the following default WebLogic T3 address:
t3://localhost:7001Replace this value if your WebLogic Server runs on a different host or port.
Download the Release Packages
Open the GitHub Releases page and download the latest release:
https://github.com/puneethbuilds-helidon/weblogic-jms-helidon-consumer-demo/releases
The latest release is v1.0.2 and contains:
helidon-jms-consumer-1.0.2.zip
weblogic-jms-sender-1.0.2.zipExtract both ZIP files.
Add the WebLogic Client JAR
The release packages do not include Oracle’s WebLogic Thin T3 client JAR. Copy it from your licensed WebLogic Server installation into the lib folder of both extracted packages.
Typical source location:
$ORACLE_HOME/wlserver/server/lib/wlthint3client.jarCopy it to:
helidon-consumer/lib/wlthint3client.jar
wls-sender/lib/wlthint3client.jarSet Your WebLogic Connection Details
Set the WebLogic connection details in your terminal:
export WLS_URL="t3://localhost:7001"
export WLS_USER="weblogic"
export WLS_PASSWORD='MySecretPassword'Start the Helidon JMS Consumer
Go to the extracted consumer package and start the application:
cd helidon-consumer
java -jar helidonconsumer.jar "$WLS_URL" "$WLS_USER" "$WLS_PASSWORD"The consumer listens to jms/TestQueue and starts an HTTP service on port 8080.
Send a Test Message
Open a second terminal, go to the extracted sender package, and run:
cd wls-sender
java -jar wlssender.jar "$WLS_URL" "$WLS_USER" "$WLS_PASSWORD" 'Hello from WebLogic JMS'The sender publishes the message to jms/TestQueue.
Verify the Consumer
After starting the consumer, verify these endpoints on port 8080:
http://localhost:8080/health
http://localhost:8080/last-message
More Details
This post focuses only on downloading and running the release packages. For the detailed WebLogic JMS setup and complete walkthrough, refer to the Medium article: