[jboss-svn-commits] JBL Code SVN: r36026 - in labs/jbosstm/trunk/ArjunaJTS/docs: ArjunaJTS_Development_Guide and 3 other directories.
jboss-svn-commits at lists.jboss.org
jboss-svn-commits at lists.jboss.org
Mon Nov 22 23:35:51 EST 2010
Author: misty at redhat.com
Date: 2010-11-22 23:35:50 -0500 (Mon, 22 Nov 2010)
New Revision: 36026
Added:
labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/
labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/
labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/ArjunaJTS_Development_Guide.ent
labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/ArjunaJTS_Development_Guide.xml
labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Author_Group.xml
labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Book_Info.xml
labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Chapter.xml
labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Configuring_JBossTS.xml
labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Constructing_An_OTS_Application.xml
labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Example.xml
labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/IDL_Definitions.xml
labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/JBossTS_Basics.xml
labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/JBossTS_Interface.xml
labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/JTA_And_JTS.xml
labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/ORB_Specific_Configurations.xml
labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/OTS.xml
labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Overview.xml
labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Preface.xml
labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/References.xml
labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Revision_History.xml
labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Tools.xml
labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/images/
labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/images/icon.svg
labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/extras/
labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/images/
labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/images/img-2phase.png
labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/publican.cfg
Log:
Began conversion. Overview chapter done.
Added: labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/ArjunaJTS_Development_Guide.ent
===================================================================
--- labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/ArjunaJTS_Development_Guide.ent (rev 0)
+++ labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/ArjunaJTS_Development_Guide.ent 2010-11-23 04:35:50 UTC (rev 36026)
@@ -0,0 +1,4 @@
+<!ENTITY PRODUCT "Documentation">
+<!ENTITY BOOKID "ArjunaJTS_Development_Guide">
+<!ENTITY YEAR "2010">
+<!ENTITY HOLDER "JBoss, Inc.">
Added: labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/ArjunaJTS_Development_Guide.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/ArjunaJTS_Development_Guide.xml (rev 0)
+++ labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/ArjunaJTS_Development_Guide.xml 2010-11-23 04:35:50 UTC (rev 36026)
@@ -0,0 +1,25 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaJTS_Development_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<book>
+ <xi:include href="Book_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <!-- <xi:include href="Chapter.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />-->
+ <xi:include href="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="OTS.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Constructing_An_OTS_Application.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="JBossTS_Interface.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Example.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="JTA_And_JTS.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Tools.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="ORB_Specific_Configurations.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Configuring_JBossTS.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="IDL_Definitions.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="References.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <index />
+</book>
+
Added: labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Author_Group.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Author_Group.xml (rev 0)
+++ labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Author_Group.xml 2010-11-23 04:35:50 UTC (rev 36026)
@@ -0,0 +1,49 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE authorgroup PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaJTS_Installation_And_Administration_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<authorgroup>
+ <author>
+ <firstname>Mark</firstname>
+ <surname>Little</surname>
+ <affiliation>
+ <orgname>Red Hat</orgname>
+ </affiliation>
+ <email>mlittle at redhat.com</email>
+ </author>
+ <author>
+ <firstname>Jonathan</firstname>
+ <surname>Halliday</surname>
+ <affiliation>
+ <orgname>Red Hat</orgname>
+ </affiliation>
+ <email>jhallida at redhat.com</email>
+ </author>
+ <author>
+ <firstname>Andrew</firstname>
+ <surname>Dinn</surname>
+ <affiliation>
+ <orgname>Red Hat</orgname>
+ </affiliation>
+ <email>adinn at redhat.com</email>
+ </author>
+ <author>
+ <firstname>Kevin</firstname>
+ <surname>Connor</surname>
+ <affiliation>
+ <orgname>Red Hat</orgname>
+ </affiliation>
+ <email>kconnor at redhat.com</email>
+ </author>
+ <editor>
+ <firstname>Misty</firstname>
+ <surname>Stanley-Jones</surname>
+ <affiliation>
+ <orgname>Red Hat</orgname>
+ </affiliation>
+ <email>misty at redhat.com</email>
+ </editor>
+
+</authorgroup>
+
Added: labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Book_Info.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Book_Info.xml (rev 0)
+++ labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Book_Info.xml 2010-11-23 04:35:50 UTC (rev 36026)
@@ -0,0 +1,30 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE bookinfo PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaJTS_Development_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<bookinfo id="book-ArjunaJTS_Development_Guide-ArjunaJTS_Development_Guide">
+ <title>ArjunaJTS Development Guide</title>
+ <subtitle>Developing distributed transactional applications with JBoss Transactions</subtitle>
+ <productname>ArjunaJTS</productname>
+ <productnumber>4.14</productnumber>
+ <edition>0</edition>
+ <pubsnumber>0</pubsnumber>
+ <!--
+ <abstract>
+ <para>
+ A short overview and summary of the book's subject and purpose, traditionally no more than one paragraph long. Note: the abstract will appear in the front matter of your book and will also be placed in the description field of the book's RPM spec file.
+ </para>
+ </abstract>
+ -->
+ <corpauthor>
+ <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="Common_Content/images/title_logo.svg" format="SVG" />
+ </imageobject>
+ </inlinemediaobject>
+ </corpauthor>
+ <xi:include href="Common_Content/Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Author_Group.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+</bookinfo>
+
Added: labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Chapter.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Chapter.xml (rev 0)
+++ labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Chapter.xml 2010-11-23 04:35:50 UTC (rev 36026)
@@ -0,0 +1,9 @@
+<?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" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaJTS_Development_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-ArjunaJTS_Development_Guide-Test_Chapter">
+ <title></title>
+</chapter>
+
Added: labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Configuring_JBossTS.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Configuring_JBossTS.xml (rev 0)
+++ labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Configuring_JBossTS.xml 2010-11-23 04:35:50 UTC (rev 36026)
@@ -0,0 +1,9 @@
+<?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" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaJTS_Development_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-ArjunaJTS_Development_Guide-Test_Chapter">
+ <title></title>
+</chapter>
+
Added: labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Constructing_An_OTS_Application.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Constructing_An_OTS_Application.xml (rev 0)
+++ labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Constructing_An_OTS_Application.xml 2010-11-23 04:35:50 UTC (rev 36026)
@@ -0,0 +1,9 @@
+<?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" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaJTS_Development_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-ArjunaJTS_Development_Guide-Test_Chapter">
+ <title></title>
+</chapter>
+
Added: labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Example.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Example.xml (rev 0)
+++ labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Example.xml 2010-11-23 04:35:50 UTC (rev 36026)
@@ -0,0 +1,9 @@
+<?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" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaJTS_Development_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-ArjunaJTS_Development_Guide-Test_Chapter">
+ <title></title>
+</chapter>
+
Added: labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/IDL_Definitions.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/IDL_Definitions.xml (rev 0)
+++ labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/IDL_Definitions.xml 2010-11-23 04:35:50 UTC (rev 36026)
@@ -0,0 +1,9 @@
+<?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" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaJTS_Development_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-ArjunaJTS_Development_Guide-Test_Chapter">
+ <title></title>
+</chapter>
+
Added: labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/JBossTS_Basics.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/JBossTS_Basics.xml (rev 0)
+++ labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/JBossTS_Basics.xml 2010-11-23 04:35:50 UTC (rev 36026)
@@ -0,0 +1,9 @@
+<?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" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaJTS_Development_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-ArjunaJTS_Development_Guide-Test_Chapter">
+ <title></title>
+</chapter>
+
Added: labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/JBossTS_Interface.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/JBossTS_Interface.xml (rev 0)
+++ labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/JBossTS_Interface.xml 2010-11-23 04:35:50 UTC (rev 36026)
@@ -0,0 +1,9 @@
+<?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" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaJTS_Development_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-ArjunaJTS_Development_Guide-Test_Chapter">
+ <title></title>
+</chapter>
+
Added: labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/JTA_And_JTS.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/JTA_And_JTS.xml (rev 0)
+++ labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/JTA_And_JTS.xml 2010-11-23 04:35:50 UTC (rev 36026)
@@ -0,0 +1,9 @@
+<?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" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaJTS_Development_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-ArjunaJTS_Development_Guide-Test_Chapter">
+ <title></title>
+</chapter>
+
Added: labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/ORB_Specific_Configurations.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/ORB_Specific_Configurations.xml (rev 0)
+++ labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/ORB_Specific_Configurations.xml 2010-11-23 04:35:50 UTC (rev 36026)
@@ -0,0 +1,9 @@
+<?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" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaJTS_Development_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-ArjunaJTS_Development_Guide-Test_Chapter">
+ <title></title>
+</chapter>
+
Added: labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/OTS.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/OTS.xml (rev 0)
+++ labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/OTS.xml 2010-11-23 04:35:50 UTC (rev 36026)
@@ -0,0 +1,9 @@
+<?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" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaJTS_Development_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-ArjunaJTS_Development_Guide-Test_Chapter">
+ <title></title>
+</chapter>
+
Added: labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Overview.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Overview.xml (rev 0)
+++ labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Overview.xml 2010-11-23 04:35:50 UTC (rev 36026)
@@ -0,0 +1,309 @@
+<?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" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaJTS_Development_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-ArjunaJTS_Development_Guide-Test_Chapter">
+ <title>Transaction Processing Overview</title>
+
+ <section>
+ <title>Defining a transaction</title>
+ <formalpara>
+ <title>Practical Example</title>
+ <para>
+ If you subscribe to a newspaper using a credit card, you are using a transactional system. Multiple systems are
+ involved, and each of the systems needs the ability to roll back its work, and cause the entire transaction to
+ roll back if necessary. For instance, if the newspaper's subscription system goes offline halfway through your
+ transaction, you don't want your credit card to be charged. If the credit card is over its limit, the newspaper
+ doesn't want your subscription to go through. In either of these cases, the entire transaction should fail of
+ any part of it fails. Neither you as the customer, nor the newspaper, nor the credit card processor, wants an
+ unpredictable (indeterminate) outcome to the transaction.
+ </para>
+ </formalpara>
+ <para>
+ This ability to roll back an operation if any part of it fails is what JBoss Transactions is all about. This
+ guide assists you in writing transactional applications to protect your data.
+ </para>
+ <para>
+ "Transactions" in this guide refers to atomic transactions, and embody the "all-or-nothing" concept outlined
+ above. Transactions are used to guarantee te consistency of data in the presence of failures. Transactions
+ fulfill the requirements of ACID: Atomicity, Consistency, Isolation, Durability.
+ </para>
+ <variablelist>
+ <title>ACID Properties</title>
+ <varlistentry>
+ <term>Atomicity</term>
+ <listitem>
+ <para>
+ The transaction completes successfully (commits) or if it fails (aborts) all of its effects are undone
+ (rolled back).
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Consistency</term>
+ <listitem>
+ <para>
+ Transactions produce consistent results and preserve application specific invariants.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Isolation</term>
+ <listitem>
+ <para>
+ Intermediate states produced while a transaction is executing are not visible to others. Furthermore
+ transactions appear to execute serially, even if they are actually executed concurrently.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Durability</term>
+ <listitem>
+ <para>
+ The effects of a committed transaction are never lost (except by a catastrophic failure).
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para>
+ A transaction can be terminated in two ways: committed or aborted (rolled back). When a transaction is
+ committed, all changes made within it are made durable (forced on to stable storage, e.g., disk). When a
+ transaction is aborted, all of the changes are undone. Atomic actions can also be nested; the effects of a
+ nested action are provisional upon the commit/abort of the outermost (top-level) atomic action.
+ </para>
+ </section>
+ <section>
+ <title>Commit protocol</title>
+ <para>
+ A two-phase commit protocol guarantees that all of the transactio participants either commit or abort
+ any changes made. <xref linkend="img-commit-protocol" /> illustrates the main aspects of the commit protocol.
+ </para>
+ <procedure>
+ <title>Two-phase commit protocol</title>
+ <step>
+ <para>
+ During phase 1, the action coordinator, C, attempts to communicate with all of the action participants, A and
+ B, to determine whether they will commit or abort.
+ </para>
+ </step>
+ <step>
+ <para>
+ An abort reply from any participant acts as a veto, causing the entire action to abort.
+ </para>
+ </step>
+ <step>
+ <para>
+ Based upon these (lack of) responses, the coordinator chooses to commit or abort the action.
+ </para>
+ </step>
+ <step>
+ <para>
+ If the action will commit, the coordinator records this decision on stable storage, and the protocol enters
+ phase 2, where the coordinator forces the participants to carry out the decision. The coordinator also informs
+ the participants if the action aborts.
+ </para>
+ </step>
+ <step>
+ <para>
+ When each participant receives the coordinator’s phase-one message, it records sufficient information on
+ stable storage to either commit or abort changes made during the action.
+ </para>
+ </step>
+ <step>
+ <para>
+ After returning the phase-one response, each participant who returned a commit response must remain blocked
+ until it has received the coordinator’s phase-two message.
+ </para>
+ </step>
+ <step>
+ <para>
+ Until they receive this message, these resources are unavailable for use by other actions. If the coordinator fails before delivery of this message, these resources remain blocked. However, if crashed machines eventually recover, crash recovery mechanisms can be employed to unblock the protocol and terminate the action.
+ </para>
+ </step>
+ </procedure>
+ <figure id="img-commit-protocol">
+ <title>Two-Pase Commit</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/img-2phase.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <para>2-Phase commit protocol</para>
+ </textobject>
+ </mediaobject>
+ </figure>
+
+ </section>
+
+ <section>
+ <title>Transactional proxies</title>
+ <para>
+ The action coordinator maintains a transaction context where resources taking part in the action need to be
+ registered. Resources must obey the transaction commit protocol to guarantee ACID properties. Typically, the
+ resource provides specific operations which the action can invoke during the commit/abort protocol. However, some
+ resources may not be able to be transactional in this way. This may happen if you have legacy code which cannot be
+ modified. Transactional proxies allow you to use these anomalous resources within an action.
+ </para>
+ <para>
+ The proxy is registered with, and manipulated by, the action as though it were a transactional resource, and the
+ proxy performs implementation specific work to make the resource it represents transactional. The proxy must
+ participate within the commit and abort protocols. Because the work of the proxy is performed as part of the
+ action, it is guaranteed to be completed or undone despite failures of the action coordinator or action
+ participants.
+ </para>
+ </section>
+
+ <section>
+ <title>Nested transactions</title>
+ <para>
+ Given a system that provides transactions for certain operations, you can combine them to
+ form another operation, which is also required to be a transaction. The resulting transaction’s effects are a
+ combination of the effects of its constituent transactions. This paradigm creates the concept of nested
+ subtransactions, and the resulting combined transaction is called the enclosing transaction. The enclosing transaction is sometimes referred to as the parent of a
+ nested (or child) transaction. It can also be viewed as a hierarchical relationship, with a top-level transaction
+ consisting of several subordinate transactions.
+ </para>
+ <para>
+ An important difference exists between nested and
+ top-level transactions.
+ </para>
+ <para>
+ The effect of a nested transaction is provisional upon the commit/roll back of its
+ enclosing transactions. The effects are recovered if the enclosing transaction aborts, even if the
+ nested transaction has committed.
+ </para>
+ <para>
+ Subtransactions are a useful mechanism for two reasons:
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>fault-isolation</term>
+ <listitem>
+ <para>
+ If a subtransaction rolls back, perhaps because an object it is using fails, the enclosing transaction
+ does not need to roll back.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>modularity</term>
+ <listitem>
+ <para>
+ If a transaction is already associated with a call when a new transaction begins, the new transaction is
+ nested within it. Therefore, if you know that an object requires transactions, you can them within the
+ object. If the object’s methods are invoked without a client transaction, then the object’s transactions
+ are top-level. Otherwise, they are nested within the scope of the client's transactions. Likewise, a
+ client does not need to know whether an object is transactional. It can begin its own transaction.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+
+ <section>
+ <title>The Object Transaction Service (OTS)</title>
+ <para>
+ The CORBA architecture, as defined by the OMG, is a standard which promotes the construction of interoperable
+ applications that are based upon the concepts of distributed objects. The architecture principally contains the
+ following components:
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>Object Request Broker (ORB)</term>
+ <listitem>
+ <para>
+ Enables objects to transparently send and receive requests in a distributed, heterogeneous environment. This
+ component is the core of the OMG reference model.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Object Services</term>
+ <listitem>
+ <para>
+ A collection of services that support functions for using and implementing objects. Such services are
+ necessary for the construction of any distributed application. The Object Transaction Service (OTS) is the
+ most relevant to JBossJTS.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Common Facilities</term>
+ <listitem>
+ <para>
+ Other useful services that applications may need, but which are not considered to be fundamental. Desktop
+ management and help facilities fit this category.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para>
+ The CORBA architecture allows both implementation and integration of a wide variety of object systems. In
+ particular, applications are independent of the location of an object and the language in which an object is
+ implemented, unless the interface the object explicitly supports reveals such details. As defined in the OMG CORBA
+ Services documentation, <firstterm>object services</firstterm> are defined as a collection of services (interfaces
+ and objects) that support the basic functions for using and implementing objects. These services are necessary to
+ construct distributed application, and are always independent of an application domain. The standards specify
+ several core services including naming, event management, persistence, concurrency control and transactions.
+ </para>
+ <note>
+ <para>
+ The OTS specification allows, but does not require, nested transactions. JBossTS is a fully compliant version of
+ the OTS version 1.1 draft 5, and support nested transactions.
+ </para>
+ </note>
+ <para>
+ The transaction service provides interfaces that allow multiple distributed objects to cooperate in a transaction,
+ committing or rolling back their changes as a group. However, the OTS does not require all objects to have
+ transactional behavior. An object's support of transactions can be none at all, for some operations, or
+ fully. Transaction information may be propagated between client and server explicitly, or implicitly. You have
+ fine-grained control over an object's support of transactions. If your objects supports partial or complete
+ transactional behavior, it needs interfaces derived from interface
+ <interfacename>TransactionalObject</interfacename>.
+ </para>
+ <para>
+ The Transaction Service specification also distinguishes between recoverable objects and transactional
+ objects. Recoverable objects are those that contain the actual state that may be changed by a transaction and must
+ therefore be informed when the transaction commits or aborts to ensure the consistency of the state changes. This
+ is achieved be registering appropriate objects that support the Resource interface (or the derived
+ SubtransactionAwareResource interface) with the current transaction. Recoverable objects are also by definition
+ transactional objects.
+ </para>
+ <para>
+ In contrast, a simple transactional object does not necessarily need to be recoverable if its state is actually
+ implemented using other recoverable objects. A simple transactional object does not need to participate the commit
+ protocol used to determine the outcome of the transaction since it maintains no state information of its own.
+ </para>
+ <para>
+ The OTS is a protocol engine that guarantees obedience to transactional behavior. It does not directly
+ support all of the transaction properties, but relies on some cooperating services:
+ </para>
+ <informaltable>
+ <tgroup cols="2">
+ <tbody>
+ <row>
+ <entry>Persistence/Recovery Service</entry>
+ <entry>
+ <para>
+ Supports properties of atomicity and durability.
+ </para>
+ </entry>
+ </row>
+ <row>
+ <entry>Concurrency Control Service</entry>
+ <entry>
+ <para>
+ Supports the isolation properties.
+ </para>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ <para>
+ You are responsible for using the appropriate services to ensure that transactional objects have the necessary
+ ACID properties.
+ </para>
+ </section>
+</chapter>
Added: labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Preface.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Preface.xml (rev 0)
+++ labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Preface.xml 2010-11-23 04:35:50 UTC (rev 36026)
@@ -0,0 +1,44 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaJTS_Development_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<preface id="pref-ArjunaJTS_Development_Guide-Preface">
+ <title>Preface</title>
+
+ <section>
+ <title>Audience</title>
+ <para>
+ This guide is specifically intended for service developers using JBoss Transactions. It is also contains useful
+ information about how transactional applications work in general.
+ </para>
+
+ </section>
+
+ <section>
+ <title>Prerequisities</title>
+ <para>
+ To understand this guide, you need a basic familiarity with Java service development and object-oriented
+ programming.
+ </para>
+ <itemizedlist>
+ <title>Other helpful knowledge</title>
+ <listitem>
+ <para>
+ A general understanding of the APIs, components, and objects that are present in Java applications.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ A general understanding of Linux, UNIX, or Microsoft Windows server.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
+
+ <xi:include href="Common_Content/Conventions.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude"><xi:fallback xmlns:xi="http://www.w3.org/2001/XInclude"><xi:include href="Common_Content/Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ </xi:fallback>
+ </xi:include>
+</preface>
+
Added: labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/References.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/References.xml (rev 0)
+++ labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/References.xml 2010-11-23 04:35:50 UTC (rev 36026)
@@ -0,0 +1,9 @@
+<?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" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaJTS_Development_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-ArjunaJTS_Development_Guide-Test_Chapter">
+ <title></title>
+</chapter>
+
Added: labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Revision_History.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Revision_History.xml (rev 0)
+++ labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Revision_History.xml 2010-11-23 04:35:50 UTC (rev 36026)
@@ -0,0 +1,27 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaJTS_Development_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<appendix id="appe-ArjunaJTS_Development_Guide-Revision_History">
+ <title>Revision History</title>
+ <simpara>
+ <revhistory>
+ <revision>
+ <revnumber>0-0</revnumber>
+ <date>Wed Nov 17 2010</date>
+ <author>
+ <firstname>Misty</firstname>
+ <surname>Stanley-Jones</surname>
+ <email>misty at redhat.com</email>
+ </author>
+ <revdescription>
+ <simplelist>
+ <member>Initial conversion to Docbook</member>
+ </simplelist>
+ </revdescription>
+ </revision>
+ </revhistory>
+ </simpara>
+</appendix>
+
Added: labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Tools.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Tools.xml (rev 0)
+++ labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/Tools.xml 2010-11-23 04:35:50 UTC (rev 36026)
@@ -0,0 +1,9 @@
+<?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" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaJTS_Development_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-ArjunaJTS_Development_Guide-Test_Chapter">
+ <title></title>
+</chapter>
+
Added: labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/images/icon.svg
===================================================================
--- labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/images/icon.svg (rev 0)
+++ labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/images/icon.svg 2010-11-23 04:35:50 UTC (rev 36026)
@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg xmlns:svg="http://www.w3.org/2000/svg" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.0" width="32" height="32" id="svg3017">
+ <defs id="defs3019">
+ <linearGradient id="linearGradient2381">
+ <stop id="stop2383" style="stop-color:#ffffff;stop-opacity:1" offset="0"/>
+ <stop id="stop2385" style="stop-color:#ffffff;stop-opacity:0" offset="1"/>
+ </linearGradient>
+ <linearGradient x1="296.4996" y1="188.81061" x2="317.32471" y2="209.69398" id="linearGradient2371" xlink:href="#linearGradient2381" gradientUnits="userSpaceOnUse" gradientTransform="matrix(0.90776,0,0,0.90776,24.35648,49.24131)"/>
+ </defs>
+ <g transform="matrix(0.437808,-0.437808,0.437808,0.437808,-220.8237,43.55311)" id="g5089">
+ <path d="m 8.4382985,-6.28125 c -0.6073916,0 -4.3132985,5.94886271 -4.3132985,8.25 l 0,26.71875 c 0,0.846384 0.5818159,1.125 1.15625,1.125 l 25.5625,0 c 0.632342,0 1.125001,-0.492658 1.125,-1.125 l 0,-5.21875 0.28125,0 c 0.49684,0 0.906249,-0.409411 0.90625,-0.90625 l 0,-27.9375 c 0,-0.4968398 -0.40941,-0.90625 -0.90625,-0.90625 l -23.8117015,0 z" transform="translate(282.8327,227.1903)" id="path5091" style="fill:#5c5c4f;stroke:#000000;stroke-width:3.23021388;stroke-miterlimit:4;stroke-dasharray:none"/>
+ <rect width="27.85074" height="29.369793" rx="1.1414107" ry="1.1414107" x="286.96509" y="227.63805" id="rect5093" style="fill:#032c87"/>
+ <path d="m 288.43262,225.43675 25.2418,0 0,29.3698 -26.37615,0.0241 1.13435,-29.39394 z" id="rect5095" style="fill:#ffffff"/>
+ <path d="m 302.44536,251.73726 c 1.38691,7.85917 -0.69311,11.28365 -0.69311,11.28365 2.24384,-1.60762 3.96426,-3.47694 4.90522,-5.736 0.96708,2.19264 1.83294,4.42866 4.27443,5.98941 0,0 -1.59504,-7.2004 -1.71143,-11.53706 l -6.77511,0 z" id="path5097" style="fill:#a70000;fill-opacity:1;stroke-width:2"/>
+ <rect width="25.241802" height="29.736675" rx="0.89682275" ry="0.89682275" x="290.73544" y="220.92249" id="rect5099" style="fill:#809cc9"/>
+ <path d="m 576.47347,725.93939 6.37084,0.41502 0.4069,29.51809 c -1.89202,-1.31785 -6.85427,-3.7608 -8.26232,-1.68101 l 0,-26.76752 c 0,-0.82246 0.66212,-1.48458 1.48458,-1.48458 z" transform="matrix(0.499065,-0.866565,0,1,0,0)" id="rect5101" style="fill:#4573b3;fill-opacity:1"/>
+ <path d="m 293.2599,221.89363 20.73918,0 c 0.45101,0 0.8141,0.3631 0.8141,0.81411 0.21547,6.32836 -19.36824,21.7635 -22.36739,17.59717 l 0,-17.59717 c 0,-0.45101 0.3631,-0.81411 0.81411,-0.81411 z" id="path5103" style="opacity:0.65536726;fill:url(#linearGradient2371);fill-opacity:1"/>
+ </g>
+</svg>
Added: labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/images/img-2phase.png
===================================================================
(Binary files differ)
Property changes on: labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/images/img-2phase.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/publican.cfg
===================================================================
--- labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/publican.cfg (rev 0)
+++ labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/publican.cfg 2010-11-23 04:35:50 UTC (rev 36026)
@@ -0,0 +1,7 @@
+# Config::Simple 4.59
+# Thu Nov 18 09:01:22 2010
+
+xml_lang: en-US
+type: Book
+brand: JBoss
+
More information about the jboss-svn-commits
mailing list