JBoss.orgCommunity Documentation

JBossJTS Development Guide

Developing distributed transactional applications with JBossJTS

by Mark Red Hat Little, Jonathan Red Hat Halliday, Andrew Red Hat Dinn, and Kevin Red Hat Connor
edited by Misty Red Hat Stanley-Jones
Preface
1. Audience
2. Prerequisites
3. Document Conventions
3.1. Typographic Conventions
3.2. Pull-quote Conventions
3.3. Notes and Warnings
4. We Need Feedback!
1. Transaction Processing Overview
1.1. Defining a transaction
1.2. Commit protocol
1.3. Transactional proxies
1.4. Nested transactions
1.5. The Object Transaction Service (OTS)
2. JBossTS Basics
2.1. Introduction
2.1.1. Raw OTS
2.1.2. Enhanced OTS functionality
2.1.3. Advanced API
2.2. JBossTS and the OTS implementation
2.3. Thread class
2.4. ORB portability issues
3. Introduction to the OTS
3.1. Defining the OTS
3.2. Action programming models
3.3. Interfaces
3.4. Transaction factory
3.4.1. OTS configuration file
3.4.2. Name service
3.4.3. resolve_initial_references
3.4.4. Overriding the default location mechanisms
3.5. Transaction timeouts
3.6. Transaction contexts
3.6.1. Nested transactions
3.6.2. Transaction propagation
3.6.3. Examples
3.7. Transaction controls
3.7.1. JBossTS specifics
3.8. The Terminator interface
3.8.1. JBossTS specifics
3.9. The Coordinator interface
3.9.1. JBossTS specifics
3.10. Heuristics
3.11. Current
3.11.1. JBossTS specifics
3.12. Resource
3.13. SubtransactionAwareResource
3.13.1. JBossTS specifics
3.14. The Synchronization interface
3.14.1. JBossTS specifics
3.15. Transactions and registered resources
3.16. The TransactionalObject interface
3.17. Interposition
3.18. RecoveryCoordinator
3.19. Checked transaction behavior
3.19.1. JBossTS specifics
3.20. Summary of JBossTS implementation decisions
4. Constructing an OTS application
4.1. Important notes for JBossTS
4.1.1. Initialization
4.1.2. Implicit context propagation and interposition
4.2. Writing applications using the raw OTS interfaces
4.3. Transaction context management
4.3.1. A transaction originator: indirect and implicit
4.3.2. Transaction originator: direct and explicit
4.4. Implementing a transactional client
4.5. Implementing a recoverable server
4.5.1. Transactional object
4.5.2. Resource object
4.5.3. Reliable servers
4.5.4. Examples
4.6. Failure models
4.6.1. Transaction originator
4.6.2. Transactional server
4.7. Summary
5. JBossTS interfaces for extending the OTS
5.1. Nested transactions
5.2. Extended resources
5.3. AtomicTransaction
5.4. Context propagation issues
6. Example
6.1. The basic example
6.1.1. Example implementation of the interface
6.2. Default settings
7. Failure Recovery
7.1. Configuring the failure recovery subsystem for your ORB
7.2. JTS specific recovery
7.2.1. XA resource recovery
7.2.2. Recovery behavior
7.2.3. Expired entry removal
7.2.4. Recovery domains
7.3. Transaction status and replay_comparison
8. JTA and JTS
8.1. Distributed JTA
9. Tools
9.1. Introduction
9.2. RMIC Extensions
9.2.1. Command Line Usage
9.2.2. ANT Usage
10. ORB-specific configuration
10.1. JacORB
A. IDL definitions
References
B. Revision History