software.amazon.jdbc.ds.xa

Class XAResourceWrapper

java.lang.Object

software.amazon.jdbc.ds.xa.XAResourceWrapper

All Implemented Interfaces:

javax.transaction.xa.XAResource

public class XAResourceWrapper
extends java.lang.Object
implements javax.transaction.xa.XAResource

A pass-through XAResource that delegates every operation to the target driver's XAResource while tracking the XA-active state of the wrapper's connection.

The XA-active flag is maintained around the transaction branch, not per method: start(javax.transaction.xa.Xid, int) marks the connection XA-active; prepare(javax.transaction.xa.Xid) does not clear it (the branch is still live between prepare and commit/rollback); the terminal commit(javax.transaction.xa.Xid, boolean) and rollback(javax.transaction.xa.Xid) clear it. This flag is what causes voluntary connection switches to be skipped and failover to fail fast for the duration of the branch.

This wrapper is a plain delegator and is not routed through the plugin pipeline (XA control calls do not need per-call plugin interception).

Field Summary

Fields inherited from interface javax.transaction.xa.XAResource

TMENDRSCAN, TMFAIL, TMJOIN, TMNOFLAGS, TMONEPHASE, TMRESUME, TMSTARTRSCAN, TMSUCCESS, TMSUSPEND, XA_OK, XA_RDONLY

Constructor Summary

Constructors

Constructor and Description
XAResourceWrapper(javax.transaction.xa.XAResource target, XaTransactionStateCallback stateCallback)

Method Summary

Modifier and Type	Method and Description
void	commit(javax.transaction.xa.Xid xid, boolean onePhase)
void	end(javax.transaction.xa.Xid xid, int flags)
void	forget(javax.transaction.xa.Xid xid)
int	getTransactionTimeout()
boolean	isSameRM(javax.transaction.xa.XAResource xares)
int	prepare(javax.transaction.xa.Xid xid)
javax.transaction.xa.Xid[]	recover(int flag)
void	rollback(javax.transaction.xa.Xid xid)
boolean	setTransactionTimeout(int seconds)
void	start(javax.transaction.xa.Xid xid, int flags)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

XAResourceWrapper

public XAResourceWrapper(javax.transaction.xa.XAResource target,
                         XaTransactionStateCallback stateCallback)

Method Detail

start

public void start(javax.transaction.xa.Xid xid,
                  int flags)
           throws javax.transaction.xa.XAException

Specified by:

start in interface javax.transaction.xa.XAResource

Throws:

javax.transaction.xa.XAException

end

public void end(javax.transaction.xa.Xid xid,
                int flags)
         throws javax.transaction.xa.XAException

Specified by:

end in interface javax.transaction.xa.XAResource

Throws:

javax.transaction.xa.XAException

prepare

public int prepare(javax.transaction.xa.Xid xid)
            throws javax.transaction.xa.XAException

Specified by:

prepare in interface javax.transaction.xa.XAResource

Throws:

javax.transaction.xa.XAException

commit

public void commit(javax.transaction.xa.Xid xid,
                   boolean onePhase)
            throws javax.transaction.xa.XAException

Specified by:

commit in interface javax.transaction.xa.XAResource

Throws:

javax.transaction.xa.XAException

rollback

public void rollback(javax.transaction.xa.Xid xid)
              throws javax.transaction.xa.XAException

Specified by:

rollback in interface javax.transaction.xa.XAResource

Throws:

javax.transaction.xa.XAException

recover

public javax.transaction.xa.Xid[] recover(int flag)
                                   throws javax.transaction.xa.XAException

Specified by:

recover in interface javax.transaction.xa.XAResource

Throws:

javax.transaction.xa.XAException

forget

public void forget(javax.transaction.xa.Xid xid)
            throws javax.transaction.xa.XAException

Specified by:

forget in interface javax.transaction.xa.XAResource

Throws:

javax.transaction.xa.XAException

isSameRM

public boolean isSameRM(javax.transaction.xa.XAResource xares)
                 throws javax.transaction.xa.XAException

Specified by:

isSameRM in interface javax.transaction.xa.XAResource

Throws:

javax.transaction.xa.XAException

getTransactionTimeout

public int getTransactionTimeout()
                          throws javax.transaction.xa.XAException

Specified by:

getTransactionTimeout in interface javax.transaction.xa.XAResource

Throws:

javax.transaction.xa.XAException

setTransactionTimeout

public boolean setTransactionTimeout(int seconds)
                              throws javax.transaction.xa.XAException

Specified by:

setTransactionTimeout in interface javax.transaction.xa.XAResource

Throws:

javax.transaction.xa.XAException