Jump To Close Expand all Collapse all Table of contents Transactions Development Guide I. JTA Development Expand section "I. JTA Development" Collapse section "I. JTA Development" 1. An Introduction to the Java Transaction API (JTA) 2. The JBoss JTA Implementation Expand section "2. The JBoss JTA Implementation" Collapse section "2. The JBoss JTA Implementation" 2.1. UserTransaction 2.2. TransactionManager 2.3. Suspending and Resuming a Transaction 2.4. The Transaction Interface 2.5. Resource Enlistment 2.6. Transaction Synchronization 2.7. Transaction Equality 3. The Resource Manager Expand section "3. The Resource Manager" Collapse section "3. The Resource Manager" 3.1. The XAResource Interface Expand section "3.1. The XAResource Interface" Collapse section "3.1. The XAResource Interface" 3.1.1. Extended XAResource Control 3.1.2. Enlisting Multiple One-Phase Aware Resources 3.2. Opening a Resource Manager 3.3. Closing a Resource Manager 3.4. Threads of Control 3.5. Transaction Association 3.6. Externally-Controlled Connections 3.7. Resource Sharing 3.8. Local and Global Transactions 3.9. Transaction Timeouts 3.10. Dynamic Registration 4. Transaction Recovery Expand section "4. Transaction Recovery" Collapse section "4. Transaction Recovery" 4.1. Failure recovery 4.2. Recovering XAConnections 4.3. Alternative to XAResourceRecovery 5. JDBC and Transactions Expand section "5. JDBC and Transactions" Collapse section "5. JDBC and Transactions" 5.1. Using the transactional JDBC driver Expand section "5.1. Using the transactional JDBC driver" Collapse section "5.1. Using the transactional JDBC driver" 5.1.1. Managing Transactions 5.1.2. Restrictions 5.2. Transactional drivers Expand section "5.2. Transactional drivers" Collapse section "5.2. Transactional drivers" 5.2.1. Loading drivers 5.3. Connections Expand section "5.3. Connections" Collapse section "5.3. Connections" 5.3.1. Making the connection 5.3.2. JBossJTA JDBC Driver Properties 5.3.3. XADataSources 6. Examples Expand section "6. Examples" Collapse section "6. Examples" 6.1. JDBC example 6.2. BasicXARecovery Example for Failure Recovery 7. Configuring JBossJTA Expand section "7. Configuring JBossJTA" Collapse section "7. Configuring JBossJTA" 7.1. Configuring options 8. Using JBossJTA with JBoss Enterprise Application Platform Expand section "8. Using JBossJTA with JBoss Enterprise Application Platform" Collapse section "8. Using JBossJTA with JBoss Enterprise Application Platform" 8.1. Service Configuration 8.2. Logging 8.3. The Services 8.4. Ensuring Transactional Context is Propagated to the Server II. JTS Development Expand section "II. JTS Development" Collapse section "II. JTS Development" 9. Overview Expand section "9. Overview" Collapse section "9. Overview" 9.1. Introduction 9.2. JBoss Transaction Service Expand section "9.2. JBoss Transaction Service" Collapse section "9.2. JBoss Transaction Service" 9.2.1. Saving Object States 9.2.2. The Object Store 9.2.3. Recovery and persistence 9.2.4. The Life cycle of a Transactional Object for Java 9.2.5. The Concurrency Controller 9.2.6. The Transaction Protocol Engine 9.2.7. Example 9.2.8. The Class Hierarchy 10. Using JBoss Transaction Service Expand section "10. Using JBoss Transaction Service" Collapse section "10. Using JBoss Transaction Service" 10.1. Introduction 10.2. State management Expand section "10.2. State management" Collapse section "10.2. State management" 10.2.1. Object States 10.2.2. The Object Store 10.2.3. StateManager 10.2.4. Object Models 10.2.5. JBoss Transaction Service Method Reference 10.2.6. Example 10.3. Lock Management and Concurrency Control Expand section "10.3. Lock Management and Concurrency Control" Collapse section "10.3. Lock Management and Concurrency Control" 10.3.1. Selecting a Lock Store Implementation 10.3.2. LockManager 10.3.3. Locking policy 10.3.4. Object construction and destruction 11. General Transaction Issues Expand section "11. General Transaction Issues" Collapse section "11. General Transaction Issues" 11.1. Advanced Transaction Issues with JBoss Transaction Service Expand section "11.1. Advanced Transaction Issues with JBoss Transaction Service" Collapse section "11.1. Advanced Transaction Issues with JBoss Transaction Service" 11.1.1. Checking Transactions 11.1.2. Gathering Statistics 11.1.3. Last resource commit optimization 11.1.4. Nested Transactions 11.1.5. Asynchronously Committing a Transaction 11.1.6. Independent Top-Level Transactions 11.1.7. Transactions Within the save_state and restore_state Methods 11.1.8. Example 11.1.9. Garbage Collecting Objects 11.1.10. Transaction Timeouts 12. Hints and tips Expand section "12. Hints and tips" Collapse section "12. Hints and tips" 12.1. General Tips Expand section "12.1. General Tips" Collapse section "12.1. General Tips" 12.1.1. Using Transactions in Constructors 12.1.2. More on the save_state and restore_state Methods 12.1.3. Packing Objects 12.2. Direct Use of the StateManager Class Expand section "12.2. Direct Use of the StateManager Class" Collapse section "12.2. Direct Use of the StateManager Class" 12.2.1. The activate Method 12.2.2. The deactivate Method 12.2.3. The modified Method 13. Tools Expand section "13. Tools" Collapse section "13. Tools" 13.1. Introduction 13.2. Starting the Transaction Service tools Expand section "13.2. Starting the Transaction Service tools" Collapse section "13.2. Starting the Transaction Service tools" 13.2.1. File Menu 13.2.2. Performance Menu 13.2.3. Window Menu 13.2.4. Help Menu 13.3. Using the Performance Tool 13.4. Using the JMX Browser Expand section "13.4. Using the JMX Browser" Collapse section "13.4. Using the JMX Browser" 13.4.1. Using Attributes and Operations 13.4.2. Using the Object Store Browser 13.4.3. Object State Viewers (OSV) 14. Constructing an Application Using Transactional Objects for Java Expand section "14. Constructing an Application Using Transactional Objects for Java" Collapse section "14. Constructing an Application Using Transactional Objects for Java" 14.1. Application Construction Expand section "14.1. Application Construction" Collapse section "14.1. Application Construction" 14.1.1. Queue description 14.1.2. Constructors and deconstructors 14.1.3. The save_state, restore_state, and type Methods 14.1.4. enqueue/dequeue operations 14.1.5. The queueSize Method 14.1.6. The inspectValue and setValue Methods 14.1.7. The Client 14.1.8. Notes 15. Configuration Options Expand section "15. Configuration Options" Collapse section "15. Configuration Options" 15.1. Options A. Object Store Implementations Expand section "A. Object Store Implementations" Collapse section "A. Object Store Implementations" A.1. The ObjectStore A.2. Persistent Object Stores Expand section "A.2. Persistent Object Stores" Collapse section "A.2. Persistent Object Stores" A.2.1. The Shadowing Store A.2.2. No file-level locking A.2.3. The Hashed Store A.2.4. The JDBC Store A.2.5. The Cached Store B. Class Definitions Expand section "B. Class Definitions" Collapse section "B. Class Definitions" B.1. Introduction B.2. Class library C. Endpoint Implementation Classes III. XTS Development Expand section "III. XTS Development" Collapse section "III. XTS Development" 16. Introduction Expand section "16. Introduction" Collapse section "16. Introduction" 16.1. Managing service-Based Processes 16.2. Servlets 16.3. SOAP 16.4. Web Services Description Language (WDSL) 17. Transactions Overview Expand section "17. Transactions Overview" Collapse section "17. Transactions Overview" 17.1. The Coordinator 17.2. The Transaction Context 17.3. Participants 17.4. ACID Transactions 17.5. Two Phase Commit 17.6. The Synchronization Protocol 17.7. Optimizations to the Protocol 17.8. Non-Atomic Transactions and Heuristic Outcomes 17.9. Interposition 17.10. A New Transaction Protocol Expand section "17.10. A New Transaction Protocol" Collapse section "17.10. A New Transaction Protocol" 17.10.1. Transaction in Loosely Coupled Systems 18. Overview of Protocols Used by XTS Expand section "18. Overview of Protocols Used by XTS" Collapse section "18. Overview of Protocols Used by XTS" 18.1. WS-Coordination Expand section "18.1. WS-Coordination" Collapse section "18.1. WS-Coordination" 18.1.1. Activation 18.1.2. Registration 18.1.3. Completion 18.2. WS-Transaction Expand section "18.2. WS-Transaction" Collapse section "18.2. WS-Transaction" 18.2.1. WS-Transaction Foundations 18.2.2. WS-Transaction Architecture 18.2.3. WS_Transaction Models 18.2.4. Application Messages 18.3. Summary 19. Getting Started Expand section "19. Getting Started" Collapse section "19. Getting Started" 19.1. Installing the XTS Service Archive into JBoss Transaction Service 19.2. Creating Client Applications Expand section "19.2. Creating Client Applications" Collapse section "19.2. Creating Client Applications" 19.2.1. User Transactions 19.2.2. Business Activities 19.2.3. Client-Side Handler Configuration 19.3. Creating Transactional Web Services Expand section "19.3. Creating Transactional Web Services" Collapse section "19.3. Creating Transactional Web Services" 19.3.1. Participants 19.3.2. Service-Side Handler Configuration 19.4. Summary 20. Participants Expand section "20. Participants" Collapse section "20. Participants" 20.1. Overview Expand section "20.1. Overview" Collapse section "20.1. Overview" 20.1.1. Atomic Transaction 20.1.2. Business Activity 20.2. Participant Creation and Deployment Expand section "20.2. Participant Creation and Deployment" Collapse section "20.2. Participant Creation and Deployment" 20.2.1. Implementing Participants 20.2.2. Deploying Participants 21. The XTS API Expand section "21. The XTS API" Collapse section "21. The XTS API" 21.1. API for the Atomic Transaction Protocol Expand section "21.1. API for the Atomic Transaction Protocol" Collapse section "21.1. API for the Atomic Transaction Protocol" 21.1.1. Vote 21.1.2. TXContext 21.1.3. UserTransaction 21.1.4. UserTransactionFactory 21.1.5. TransactionManager 21.1.6. TransactionManagerFactory 21.2. API for the Business Activity Protocol Expand section "21.2. API for the Business Activity Protocol" Collapse section "21.2. API for the Business Activity Protocol" 21.2.1. Compatibility 21.2.2. UserBusinessActivity 21.2.3. UserBusinessActivityFactory 21.2.4. BusinessActivityManager 21.2.5. BusinessActivityManagerFactory 22. Stand-Alone Coordination Expand section "22. Stand-Alone Coordination" Collapse section "22. Stand-Alone Coordination" 22.1. Introduction 22.2. Configuring the Activation Coordinator Expand section "22.2. Configuring the Activation Coordinator" Collapse section "22.2. Configuring the Activation Coordinator" 22.2.1. Command-Line Options Passed with the -D Parameter, Ordered by Priority 23. Participant Crash Recovery Expand section "23. Participant Crash Recovery" Collapse section "23. Participant Crash Recovery" 23.1. WS-AT Recovery Expand section "23.1. WS-AT Recovery" Collapse section "23.1. WS-AT Recovery" 23.1.1. WS-AT Coordinator Crash Recovery 23.1.2. WS-AT Participant Crash Recovery 23.2. WS-BA Recovery Expand section "23.2. WS-BA Recovery" Collapse section "23.2. WS-BA Recovery" 23.2.1. WS-BA Coordinator Crash Recovery 23.2.2. WS-BA Participant Crash Recovery APIs D. Revision History Index Legal Notice Settings Close Language: 日本語 English Language: 日本語 English Format: Multi-page Single-page PDF Format: Multi-page Single-page PDF Language and Page Formatting Options Language: 日本語 English Language: 日本語 English Format: Multi-page Single-page PDF Format: Multi-page Single-page PDF Part II. JTS Development This section gives guidance for using the JBoss implementation of the Java Transaction Service (JTS) API to add transactional support for your enterprise applications. Previous Next