[jboss-svn-commits] JBL Code SVN: r31949 - labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US.
jboss-svn-commits at lists.jboss.org
jboss-svn-commits at lists.jboss.org
Thu Mar 4 17:23:48 EST 2010
Author: misty at redhat.com
Date: 2010-03-04 17:23:48 -0500 (Thu, 04 Mar 2010)
New Revision: 31949
Added:
labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/JTS_Basics.xml
Modified:
labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/JTS_Programmers_Guide.xml
Log:
Added JTS Basics chapter
Added: labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/JTS_Basics.xml
===================================================================
--- labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/JTS_Basics.xml (rev 0)
+++ labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/JTS_Basics.xml 2010-03-04 22:23:48 UTC (rev 31949)
@@ -0,0 +1,100 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+<chapter id="chap-JTS_Programmers_Guide-JTS_Basics">
+ <title>JBossTS Basics</title>
+ <para>
+ <application>JBossTS</application> is based upon the original <application>Arjuna</application> system developed at the University of Newcastle between 1986 and 1995. <application>Arjuna</application> predates the OTS specification and includes many features not found in the OTS. <application>JBossTS</application> is a superset of the OTS: applications written using the standard OTS interfaces will be portable across OTS implementations.
+ </para>
+ <para>
+ In terms of the OTS specfiication, <application>JBossTS</application> provides:
+ <itemizedlist>
+ <listitem>
+ <para>full draft 5 compliance, with support for Synchronization objects and PropagationContexts.</para>
+ </listitem>
+ <listitem>
+ <para>support for subtransactions.</para>
+ </listitem>
+ <listitem>
+ <para>implicit context propagation where support from the <application>ORB</application> is available.</para>
+ </listitem>
+ <listitem>
+ <para>support for multi-threaded applications.</para>
+ </listitem>
+ <listitem>
+ <para>fully distributed transaction managers, i.e., there is no central transaction manager, and the creator of a top-level transaction is responsible for its termination. Separate transaction manager support is also available, however.</para>
+ </listitem>
+ <listitem>
+ <para>transaction interposition.</para>
+ </listitem>
+ <listitem>
+ <para>X/Open compliance, including checked transactions. This checking can optionally be disabled.</para>
+ <note>
+ <title>Note:</title>
+ <para>Checked transactions are disabled by default, i.e., any thread can terminate a transaction.</para>
+ </note>
+ </listitem>
+ <listitem>
+ <para><application>JDBC</application> 1.0 and 2.0 support.</para>
+ </listitem>
+ <listitem>
+ <para>Full JTA 1.1 support.</para>
+ </listitem>
+ </itemizedlist>
+ </para>
+
+ <para>
+ There are effectively three different levels at which a programmer can approach using <application>JBossTS</application>. These will be briefly described in the following sections, and in more detail in subsequent chapters.
+ </para>
+
+ <note>
+ <title>Note:</title>
+ <para>
+ Because of differences in ORB implementations, JBossTS has been written with a separate ORB Portability library which hides these differences; many of the examples used throughout this manual have also been written using this library, and it is therefore recommended that the ORB Portability Manual is read first.
+ </para>
+ </note>
+
+ <section id="sect-JTS_Programmers_Guide-JTS_Basics-Raw_OTS">
+ <title>Raw OTS</title>
+ <para>
+ The OTS is actually only a protocol engine for driving registered resources through a two-phase commit protocol. Application programmers are responsible for building and registering the Resource objects which take care of persistence and concurrency control to ensure ACID properties for transactional application objects. The programmer must ensure that Resources are registered at appropriate times, and that a given Resource is only registered within a single transaction. Therefore, programming at the raw OTS level is extremely basic: the programmer is responsible for many things, including managing persistence and concurrency control on behalf of every transactional object.
+ </para>
+
+ </section>
+
+ <section id="sect-JTS_Programmers_Guide-JTS_Basics-Enhanced_OTS_Functionality">
+ <title>Enhanced OTS Functionality</title>
+ <para>
+ The OTS implementation of nested transactions is extremely limited, and can lead to the generation of heuristic-like results: a subtransaction coordinator discovers part way through committing that some resources cannot commit; however, it cannot tell the committed resources to abort. <application>JBossTS</application> allows nested transactions to execute a full two-phase commit protocol, thus removing the possibility that some resources will have been committed whereas others will have been rolled back.
+ </para>
+ <para>
+ When resources are registered with a transaction the programmer has no control over the order in which these resources will be invoked during the commit/abort protocol, or whether previously registered resources should be replaced with newly registered resources, for example, then resources registered with a subtransaction are merged with its parent. <application>JBossTS</application> provides an additional Resource subtype which gives programmers this control.
+ </para>
+ </section>
+
+ <section id="sect-JTS_Programmers_Guide-JTS_Basics-Advanced_API">
+ <title>Advanced Application Programmer Interface</title>
+ <para>
+ </para>
+ </section>
+
+ <section id="sect-JTS_Programmers_Guide-JTS_Basics-JBossTS_And_OTS_Specification">
+ <title><application>JBossTS</application> and the OTS Specification</title>
+ <para>
+ </para>
+ </section>
+
+ <section id="sect-JTS_Programmers_Guide-JTS_Basics-Thread_Class">
+ <title>Thread Class</title>
+ <para>
+ </para>
+ </section>
+
+ <section id="sect-JTS_Programmers_Guide-JTS_Basics-ORB_Portability_Issues">
+ <title>ORB Portability Issues</title>
+ <para>
+ </para>
+ </section>
+
+</chapter>
+
Modified: labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/JTS_Programmers_Guide.xml
===================================================================
--- labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/JTS_Programmers_Guide.xml 2010-03-04 22:22:59 UTC (rev 31948)
+++ labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/JTS_Programmers_Guide.xml 2010-03-04 22:23:48 UTC (rev 31949)
@@ -7,6 +7,7 @@
<xi:include href="Transaction_Processing_Overview.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="JBossTS_basics.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="JTS_Basics.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<index />
</book>
More information about the jboss-svn-commits
mailing list