JavaStandalone

Java Message Service (JMS) Producer / Consumer Example

JMS producer and consumer example for Oracle AI Database Transactional Event Queues.

TxEventQTestcontainers#Java#JMS#Testcontainers#TxEventQ
What this sample helps you learn

This example module demonstrates how to write pub/sub applications using the JDBC JMS API for [Oracle AI Database Transactional Event Queues](https://docs.oracle.com/en/database/oracle/oracle-database/26/adque/aq-introduction.html). If you're unfamiliar with Transactional Event Queues (TxEventQ), it is a high-throughput, distributed, asynchronous messaging system built into Oracle AI Database. TxEventQ's JMS APIs provide a simple, familiar interface for developing applications with service-to-service messaging capabilities.

What this sample demonstrates

TxEventQ

Transactional queues for database-backed events and messaging.

Use when event delivery and data changes need the same transaction boundary.

Testcontainers

Disposable Oracle AI Database Free containers for repeatable local and integration tests.

Use when tests need real database behavior without sharing a long-lived development instance.

Highlights

  • Java 21+, Maven
  • Docker compatible environment