com.sun.xml.ws.tx.at.internal
Class WSATGatewayRM

java.lang.Object
  extended by com.sun.xml.ws.tx.at.internal.WSATGatewayRM
All Implemented Interfaces:
WSATRuntimeConfig.RecoveryEventListener, XAResource

public class WSATGatewayRM
extends Object
implements XAResource, WSATRuntimeConfig.RecoveryEventListener

Gateway XAResource for managing outbound WS-AT transaction branches.


Field Summary
static boolean isReadyForRuntime
           
static String txlogdir
           
 
Fields inherited from interface javax.transaction.xa.XAResource
TMENDRSCAN, TMFAIL, TMJOIN, TMNOFLAGS, TMONEPHASE, TMRESUME, TMSTARTRSCAN, TMSUCCESS, TMSUSPEND, XA_OK, XA_RDONLY
 
Method Summary
 void afterRecovery(boolean success, boolean delegated, String instance)
          Indicate to the listener that recovery is over.
 void beforeRecovery(boolean delegated, String instance)
          Indicate to the listener that recovery for a specific instance is about to start.
 void commit(Xid xid, boolean onePhase)
           
static WSATGatewayRM create()
          Called during tube/web service init
 boolean detectedUnavailable()
          Return true as WSATGatewayRM is always available, health should not change.
 void end(Xid xid, int flags)
           
 void forget(Xid xid)
           
 int getDelistFlag()
          Always returns TMSUCCESS, avoids unnecessary suspend
static WSATGatewayRM getInstance()
          called by transaction services for enlistment and used by HA delegation
 int getTransactionTimeout()
          Not applicable
 boolean isSameRM(XAResource xares)
          There is only one WSATGatewayRM per server for active transactions and isSameRM should not be called for any migrated WSATGatewayRM instances
 int prepare(Xid xid)
           
 void recover()
          Used for lazy/automatic-recovery="false"
 Xid[] recover(int flag)
          Call for local recover/server specified by null instance value
 Xid[] recover(int flag, String instance)
          Call for delegated recovery specified by non-null instance
 Xid registerWSATResource(Xid xid, XAResource wsatResource, Transaction tx)
          Enlist a foreign WS-AT resource in the current transaction.
 void rollback(Xid xid)
           
 boolean setTransactionTimeout(int seconds)
          Not applicable
 void start(Xid xid, int flags)
          Implementation of Subordinate/ServerXAResource called in reaction to registerWSATResource enlistResource call This should be the only use/patch of this method NOTE: lock on currentBQual must be obtained before calling this method as it is in
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

isReadyForRuntime

public static boolean isReadyForRuntime

txlogdir

public static String txlogdir
Method Detail

getInstance

public static WSATGatewayRM getInstance()
called by transaction services for enlistment and used by HA delegation

Returns:

create

public static WSATGatewayRM create()
Called during tube/web service init

Returns:

registerWSATResource

public Xid registerWSATResource(Xid xid,
                                XAResource wsatResource,
                                Transaction tx)
                         throws IllegalStateException,
                                RollbackException,
                                SystemException
Enlist a foreign WS-AT resource in the current transaction. It is assumed that the XAResource parameter wraps a WS-AT endpoint. Invoked in the outbound case.

Parameters:
xid - The current, superior transaction id.
wsatResource - The foreign WS-AT resource.
Returns:
Xid xid
Throws:
SystemException - from enlistResource
RollbackException - from enlistResource
IllegalStateException - from enlistResource

start

public void start(Xid xid,
                  int flags)
           throws XAException
Implementation of Subordinate/ServerXAResource called in reaction to registerWSATResource enlistResource call This should be the only use/patch of this method NOTE: lock on currentBQual must be obtained before calling this method as it is in

Specified by:
start in interface XAResource
Parameters:
xid - Xid
flags - flags
Throws:
XAException - xaException

end

public void end(Xid xid,
                int flags)
         throws XAException
Specified by:
end in interface XAResource
Throws:
XAException

prepare

public int prepare(Xid xid)
            throws XAException
Specified by:
prepare in interface XAResource
Throws:
XAException

commit

public void commit(Xid xid,
                   boolean onePhase)
            throws XAException
Specified by:
commit in interface XAResource
Throws:
XAException

rollback

public void rollback(Xid xid)
              throws XAException
Specified by:
rollback in interface XAResource
Throws:
XAException

recover

public void recover()
Used for lazy/automatic-recovery="false"


recover

public Xid[] recover(int flag)
              throws XAException
Call for local recover/server specified by null instance value

Specified by:
recover in interface XAResource
Parameters:
flag -
Returns:
Xid[] indoubt Xids
Throws:
XAException

recover

public Xid[] recover(int flag,
                     String instance)
              throws XAException
Call for delegated recovery specified by non-null instance

Parameters:
flag -
instance -
Returns:
Xid[] indoubt Xids
Throws:
XAException

forget

public void forget(Xid xid)
            throws XAException
Specified by:
forget in interface XAResource
Throws:
XAException

getTransactionTimeout

public int getTransactionTimeout()
                          throws XAException
Not applicable

Specified by:
getTransactionTimeout in interface XAResource
Returns:
int -1 as not applicable
Throws:
XAException

setTransactionTimeout

public boolean setTransactionTimeout(int seconds)
                              throws XAException
Not applicable

Specified by:
setTransactionTimeout in interface XAResource
Parameters:
seconds - int
Returns:
boolean always false as not applicable
Throws:
XAException - xaException

isSameRM

public boolean isSameRM(XAResource xares)
                 throws XAException
There is only one WSATGatewayRM per server for active transactions and isSameRM should not be called for any migrated WSATGatewayRM instances

Specified by:
isSameRM in interface XAResource
Parameters:
xares - XAResource
Returns:
boolean if is same RM which in this WSATGatewayRM case means means the same instance
Throws:
XAException

detectedUnavailable

public boolean detectedUnavailable()
Return true as WSATGatewayRM is always available, health should not change.

Returns:
boolean

getDelistFlag

public int getDelistFlag()
Always returns TMSUCCESS, avoids unnecessary suspend

Returns:
int TMSUCCESS delist flag

beforeRecovery

public void beforeRecovery(boolean delegated,
                           String instance)
Description copied from interface: WSATRuntimeConfig.RecoveryEventListener
Indicate to the listener that recovery for a specific instance is about to start.

Specified by:
beforeRecovery in interface WSATRuntimeConfig.RecoveryEventListener
Parameters:
delegated - identifies whether it is part of a delegated transaction recovery
instance - the instance name for which transaction recovery is performed, null if unknown

afterRecovery

public void afterRecovery(boolean success,
                          boolean delegated,
                          String instance)
Description copied from interface: WSATRuntimeConfig.RecoveryEventListener
Indicate to the listener that recovery is over.

Specified by:
afterRecovery in interface WSATRuntimeConfig.RecoveryEventListener
Parameters:
success - true if the recovery operation finished successfully
delegated - identifies whether it is part of a delegated transaction recovery
instance - the instance name for which transaction recovery is performed, null if unknown


Copyright © 2005-2015 Oracle Corporation. All Rights Reserved.