I would start by studying the JBoss Web Services Transactions Guide

http://www.redhat.com/docs/manuals/jboss/jboss-eap-4.2/doc/jbossts/Web_Services_Programmers_Guide.pdf

and gaining a full perspective on XTS.

Then, I would build/deploy/exercise the XTS demo application that comes with JBoss TS. Then study the XTS demo's source code to see exactly how the WS-BA example is implemented.

Details for those steps are here: http://www.jboss.org/index.html?module=bb&op=viewtopic&t=154081

Ben is right to recommend this course of action. However, you would be much better off using a later version of JBossAS and JBossTS/XTS.

I recommend that you download JBossAS 5.1.0.GA and the corresponding transaction code in JBossTS 4.6.0.GA from the JBoss svn repository. The programmer's guide in this version includes full documentation of both the WSAT and WSBA APIs. The implementation of XTS in this version includes full support for WSAT and WSBA crash recovery.

After download you need to build the AS, then TS and finally XTS as follows

-- build AS

cd <AStree>/build
bash build.sh (or run build.bat for windows)

export JBOSS_HOME=<ASdir>/build/output/jboss-5.1.0.GA//

cd <TStree>
ant jbossjta

cd <TStree>/XTS
ant install
cp xts-install/sar/jbossxts.sar $JBOSS_HOME/server/default/deploy

cd <TSTree>/XTS/demo
bash build.sh jboss

cd <TSTree>/XTS/xts-install/demo
-- edit file jboss.properties and replace HOSTNAME etc as directed
bash build.sh jboss clean build

cp <TSTree>/XTS/xts-install/xts-demo.ear $JBOSS_HOME/server/default/deploy

I have a problem building AS. When I execute build.bat some errors appears:

Error building POM (may not be this project´s POM)
Project ID: org.jboss.jbossas:jboss-as-component-matrix:5.1.0.GA
Reason: Cannot find parent: org.jboss:jboss-parent for project: org.jboss.jbossas: jboss-as-component-matrix:pom:5.1.0.GA

JBossTS definitely does have an XTS directory. So if you correctly/fully checked out JBossTS from SVN (svn co http://anonsvn.jboss.org/repos/labs/labs/jbosstm/tags/JBOSSTS_4_6_1_GA/), and you correctly built the TS, proceed with the next step in Andrew's instructions:

cd XTS
ant install

Once you get the XTS demo running on your local JBoss build, start to exercise *all* the different ways you can use XTS to do

1) Atomic Transactions (been around decades. 2 outcomes: commit/rollback)
2) Business Activty (been around less than a decade and introduces "compensate" as a 3rd possible transaction outcome)

Atomic Transactions are very familiar and the XTS demo treats them exactly as you would expect. Drive the demo in "Atomic" mode and see how the XTS plumbing "calls back" the Taxi, Restaurant, and Theater participants to co-ordinate that they can all "commit" to a night on the town. Then ... try to "pull the plug" on one of the participants (e.g. maybe the Theater is sold-out) and XTS will roll-back the entire "night on the town" ... i.e. both your taxi transportation plans and dinner reservations will not be booked.

Business Activity is a (relatively) new transaction standard. It was born out of Oasis BTP and evolved (down a long road) into the WS-BA standard. Drive the XTS demo in "Business Activity" mode, and you will be introduced to the "compensate" outcome potential ... which can give you a potentially much more flexible way of managin transactions than the "all or nothing" strictness of Atomic Transactions. Business Activity is a "relaxation" of the Atomic Transaction protocol, and XTS is the very best place to learn this hands on.

You might be interested to attach via a remote debugger (i.e. Eclipse) to your JBoss XTS demo code and single-step through the exact APIs used by XTS to drive the demos. These kind of single-step sessions I find to be most informative re: learning XTS internals.

If you are seriously interested to be a student of the history of how XTS supported standards evolved (i.e. why does XTS implement WS-AT and WS-BA?), you might want to study the literature of the causes and effects that motivated use transitions from OMG/OTS/CorbaIDL-API to JCP/JTS/JTA-API and onto WS-T/XTS/JSR-156-API.

The history is relevant (IMHO). Also, if reading all these TX standards' white papers gets you a little too bogged down in verbage, take a break and visit a video presentation from this guy: http://www.infoq.com/interviews/mark-little-qcon08. (He had another video presentation on www.theserverside.com -- but I can't find that one anymore).

Of course, continue to subscribe to this specific forum (and also JBoss Transactions User forum). These forums I find to be the best single possible places to learn about the state-of-the-art in transaction technology, and its implementation of same - JBossTS.

What I have to do to start a empty project in Eclipse and uses XTS? Thanks again :)

"ryden13" wrote:
Do you know if is there any more example to download?

> Can somebody help me?

If you can't figure out how to add jars to the wsgen classpath on your own, you are probably beyond help, or at least in need of a remedial introduction to java software development, since it uses the same fundamental -cp/-classpath mechanism as java and javac. You have done java programming before, right?