Project

General

Profile

How to Transaction Management » History » Version 6

Henning Blohm, 07.09.2012 14:26

1 2 Henning Blohm
h1. How to Integrate a Transaction Manager
2 3 Henning Blohm
3
This Wiki is about how to integrate a full-blown transaction manager into Z2. We only consider Atomikos for now, hoping other TMs can be used similarly.
4
5 4 Henning Blohm
Note that the z2-base.base repository contains the JTA 1.1 API and an implementation of it in the module *com.zfabrik.jta*. That is however not a real, full-featured transaction manager - rather just a pseudo-distributed transaction management implementation. There is no 2-phase-commit handling. 
6
7
It is still extremely useful for 90% case where global, distributed transactions are unnecessary overkill. 
8 3 Henning Blohm
9
At times however, you may require a real TM and even if you dont and want to use Atomikos with non-XA data sources, in which case it behaves similarly to *com.zfabrik.jta*, here is how it's done.
10
11
There are two samples related to this page:
12
13 5 Henning Blohm
* *z2-samples.jta-plain*: A sample scenario with just z2-base and Atomikos and no further trickery. This samples explains best what is needed to get going.
14
* *z2-samples.jta-spring*: A sample scenario built on z2-base, z2-addons.spring, and Atomikos. This is the more advanced, Spring-minded case. The underlying mechanics may be harder to grasp though.
15 3 Henning Blohm
16
Please consult [[How_to_Run_a_Sample]] on how to run these samples.
17 6 Henning Blohm
18
h2. References
19
20
* [[How_to_Run_a_Sample]]
21
* [[How_to_Spring]]