Red Hat SummitChapter 8. Camel Quarkus transaction guide
8.1. About the transaction guide
This guide provides information and instructions for implementing transactional applications with Red Hat build of Apache Camel for Quarkus.
8.2. JTA dependencies
In order to use camel-quarkus-jta, you need to include the following dependency in your pom.xml
<dependency> <groupId>org.apache.camel.quarkus</groupId> <artifactId>camel-quarkus-jta</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.quarkus</groupId>
<artifactId>camel-quarkus-jta</artifactId>
</dependency>
This leverages quarkus-narayana-jta to provide JTA support in Camel.
8.2.1. Important configurations
There are some important quarkus.transaction-manager configurations you need to be aware of:
| Configuration | Default value | Description | Comment |
|---|---|---|---|
|
|
| Identifes the node. It needs to be unique and stable over both transaction manager and container restarts. | For more information, see Configuring transaction node name identifier in the Quarkus documentation. |
|
|
|
Configures where the transaction logs are stored - either in a directory ( | For a cloud environment without access to persistent volumes, consider using the jdbc object store. For more information, see Configure storing of Quarkus transaction logs in a database section in the Quarkus documentation |
|
|
| Enables recovery of pending transactions in case of a JVM crash or shutdown. |
We recommend that you set it to |
8.3. Configuring transactional resources
8.3.1. JDBC Datasource configuration
To configure the datasource:
- Include the relevant jdbc extension by following the Configure datasources in Quarkus section in the Quarkus datasource guide.
The extensions are integrated with the Quarkus agroal extension to support pooling and XA transactions.
Optional
If you want to use the datasource in a XA transaction, you must enable it:
quarkus.datasource.jdbc.transactions = xaquarkus.datasource.<datasource-name>.jdbc.transactions = xaFor more information, refer to the Narayana transaction manager integration section in the Quarkus datasource guide.
Do not mix using non-XA and XA datasource in a transaction.
It is not a transaction safe.
8.3.2. JMS Configuration
In order to use JMS with distributed transactions, you must do the following:
Use
quarkus-pooled-jmsto support pooling and transaction, by including the following dependency in yourpom.xml:<dependency> <groupId>io.quarkiverse.messaginghub</groupId> <artifactId>quarkus-pooled-jms</artifactId> </dependency><dependency> <groupId>io.quarkiverse.messaginghub</groupId> <artifactId>quarkus-pooled-jms</artifactId> </dependency>Copy to Clipboard Copied! Toggle word wrap Toggle overflow Enable XA support by setting
.transactiontoxa:quarkus.pooled-jms.transaction = xa
For more details, see Support for connection pooling and X/Open XA distributed transactions in the JMS extension documentation.
8.4. Examples
- JPA and JMS
We use Narayana as the standalone JTA Transaction Manager implementation, and Hibernate as the JPA Adapter.
- Message Bridge
A basic REST endpoint is provided for users to dispatch a message to the IBM MQ queue. Messages from the IBM MQ are relayed to an ActiveMQ queue within an XA transaction. This example showcases the transaction functionality with rollback and recovery.
8.5. Transaction policies
There are six transaction policies:
| Policy | Description | Comment |
|---|---|---|
|
| Support a current transaction; throw an exception if no current transaction exists. | |
|
| Do not support a current transaction; throw an exception if a current transaction exists. | |
|
| Do not support a current transaction; rather always execute non-transactionally. | |
|
| Support a current transaction; create a new one if none exists. | Default |
|
| Create a new transaction, suspending the current transaction if one exists. | |
|
| Support a current transaction; execute non-transactionally if none exists. |
For more details, see Using different transaction propagations in the Quarkus Transactional client documentation.
8.6. Known issues
8.6.1. Non-XA datasource compatibility
Since 3.8.4, there is a compatibility break issue when using non-XA datasource. For more information see the pull request 40365
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}