Mailing-List: contact jackrabbit-dev-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: jackrabbit-dev@incubator.apache.org
Received-SPF: pass (hermes.apache.org: domain of stefan.guggisberg@gmail.com
 designates 64.233.170.202 as permitted sender)
DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws;
        s=beta; d=gmail.com;
        h=received:message-id:date:from:reply-to:to:subject:mime-version:content-type:content-transfer-encoding;
        b=tJaHC67bIiwdsbwxQlVTLgT9q25oSAfpzQNT552QfKjwGnFVvtJWiMhS7iwydK09+/1Tv1xRRqgGCgSA1Ip4MT3u1ODbLRBaQ4Ip2D1V4hquhLI+YWyVwO5At8xabsTRpaZrmwdcvpv7zwRmDC1NJCht5FeT66FfSwaMZUfPkCE=
Message-ID: <90a8d1c004102110494839cdaf@mail.gmail.com>
Date: Thu, 21 Oct 2004 19:49:00 +0200
From: Stefan Guggisberg <stefan.guggisberg@gmail.com>
Reply-To: Stefan Guggisberg <stefan.guggisberg@gmail.com>
To: jackrabbit-dev@incubator.apache.org
Subject: JTA support
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit

folks,
as you might have noticed i have just committed a large chunk
of code. this is the first implementation of transaction support (JTA)
in jackrabbit!

the code has been contributed by dominique pfister and i think
he has done a great job :)

dominique is lurking in the jackrabbit-dev list and i'm sure that
he'll be happy to answer all tx related questions that might come up.

jta support is exposed via the XASession, i.e. Repository.login()
returns a XASession instance instead of the regular Session.

if you want to get your hands dirty and test the tx support,
you can use code like this:

<code_snippet>

    Credentials creds = new SimpleCredentials("anonymous", "".toCharArray());
    XASession session = (XASession) r.login(creds, null);
    // get XAResource
    XAResource xares = session.getXAResource();

    // create dummy Xid
    Xid xid = new Xid() {
        public byte[] getBranchQualifier() {
            return new byte[0];
        }

        public int getFormatId() {
            return 0;
        }

        public byte[] getGlobalTransactionId() {
            return new byte[0];
        }
    };

    xares.start(xid, XAResource.TMNOFLAGS);

     // .... add new nodes & properties and save them

    xares.end(xid, XAResource.TMSUCCESS);

    xares.prepare(xid);
    xares.commit(xid, false);

</code_snippet>

cheers
stefan