Overview  Package   Class  Tree  Deprecated  Index  Help 
 PREV CLASS (src)    NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

org.jboss.test.jca.adapter
Class TestXAResource

java.lang.Object
  extended byorg.jboss.test.jca.adapter.TestXAResource
All Implemented Interfaces:
XAResource (src)
public class TestXAResource
extends java.lang.Object
implements XAResource (src)

TestXAResource.java Created: Mon Dec 31 19:55:31 2001

Field Summary
 
Fields inherited from interface javax.transaction.xa.XAResource (src)
TMENDRSCAN, TMFAIL, TMJOIN, TMNOFLAGS, TMONEPHASE, TMRESUME, TMSTARTRSCAN, TMSUCCESS, TMSUSPEND, XA_OK, XA_RDONLY
 
Constructor Summary
TestXAResource()
           
 
Method Summary
 void commit(Xid (src)  param1, boolean param2)
          Commit the work done on this resource in the given transaction.
 void end(Xid (src)  param1, int param2)
          Called to disassociate the resource from a transaction.
 void forget(Xid (src)  param1)
          Tells the resource manager to forget about a heuristic decision.
 int getTransactionTimeout()
          Get the current transaction timeout value for this resource.
 boolean isSameRM(XAResource (src)  param1)
          Tells the caller if this resource has the same resource manager as the argument resource.
 int prepare(Xid (src)  param1)
          Prepare to commit the work done on this resource in the given transaction.
 Xid (src) [] recover(int param1)
          Return a list of transactions that are in a prepared or heuristically state.
 void rollback(Xid (src)  param1)
          Roll back the work done on this resource in the given transaction.
 boolean setTransactionTimeout(int param1)
          Set the transaction timeout value for this resource.
 void start(Xid (src)  param1, int param2)
          Called to associate the resource with a transaction.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

TestXAResource

public TestXAResource()
Method Detail

start

public void start(Xid (src)  param1,
                  int param2)
           throws XAException (src)
Description copied from interface: XAResource (src)
Called to associate the resource with a transaction. If the flags argument is XAResource.TMNOFLAGS, the transaction must not previously have been seen by this resource manager, or an XAException (src) with error code XAER_DUPID will be thrown. If the flags argument is XAResource.TMJOIN, the resource will join a transaction previously seen by tis resource manager. If the flags argument is XAResource.TMRESUME the resource will resume the transaction association that was suspended with end(TMSUSPEND).

Specified by:
start in interface XAResource (src)
Parameters:
param1 -
param2 -
Throws:
XAException (src) -

end

public void end(Xid (src)  param1,
                int param2)
         throws XAException (src)
Description copied from interface: XAResource (src)
Called to disassociate the resource from a transaction. If the flags argument is XAResource.TMSUCCESS, the portion of work was done sucessfully. If the flags argument is XAResource.TMFAIL, the portion of work failed. The resource manager may mark the transaction for rollback only to avoid the transaction being committed. If the flags argument is XAResource.TMSUSPEND the resource will temporarily suspend the transaction association. The transaction must later be re-associated by giving the XAResource.TMRESUME flag to the start method.

Specified by:
end in interface XAResource (src)
Parameters:
param1 -
param2 -
Throws:
XAException (src) -

commit

public void commit(Xid (src)  param1,
                   boolean param2)
            throws XAException (src)
Description copied from interface: XAResource (src)
Commit the work done on this resource in the given transaction. If the onePhase argument is true, one-phase optimization is being used, and the prepare method must not have been called for this transaction. Otherwise, this is the second phase of the two-phase commit protocol.

Specified by:
commit in interface XAResource (src)
Parameters:
param1 -
param2 -
Throws:
XAException (src) -

rollback

public void rollback(Xid (src)  param1)
              throws XAException (src)
Description copied from interface: XAResource (src)
Roll back the work done on this resource in the given transaction.

Specified by:
rollback in interface XAResource (src)
Parameters:
param1 -
Throws:
XAException (src) -

prepare

public int prepare(Xid (src)  param1)
            throws XAException (src)
Description copied from interface: XAResource (src)
Prepare to commit the work done on this resource in the given transaction. This method cannot return a status indicating that the transaction should be rolled back. If the resource wants the transaction to be rolled back, it should throw an XAException at the caller.

Specified by:
prepare in interface XAResource (src)
Parameters:
param1 -
Returns:
Throws:
XAException (src) -

forget

public void forget(Xid (src)  param1)
            throws XAException (src)
Description copied from interface: XAResource (src)
Tells the resource manager to forget about a heuristic decision.

Specified by:
forget in interface XAResource (src)
Parameters:
param1 -
Throws:
XAException (src) -

recover

public Xid (src) [] recover(int param1)
              throws XAException (src)
Description copied from interface: XAResource (src)
Return a list of transactions that are in a prepared or heuristically state. This method looks not only at the resource it is invoked on, but also on all other resources managed by the same resource manager. It is intended to be used by the application server when recovering after a server crash.

A recovery scan is done with one or more calls to this method. At the first call, XAResource.TMSTARTRSCAN must be in the flag argument to indicate that the scan should be started. During the recovery scan, the resource manager maintains an internal cursor that keeps track of the progress of the recovery scan. To end the recovery scan, the XAResource.TMENDRSCAN must be passed in the flag argument.

Specified by:
recover in interface XAResource (src)
Parameters:
param1 -
Returns:
Throws:
XAException (src) -

isSameRM

public boolean isSameRM(XAResource (src)  param1)
                 throws XAException (src)
Description copied from interface: XAResource (src)
Tells the caller if this resource has the same resource manager as the argument resource. The transaction manager needs this method to be able to decide if the start method should be given the XAResource.TMJOIN flag.

Specified by:
isSameRM in interface XAResource (src)
Parameters:
param1 -
Returns:
Throws:
XAException (src) -

getTransactionTimeout

public int getTransactionTimeout()
                          throws XAException (src)
Description copied from interface: XAResource (src)
Get the current transaction timeout value for this resource.

Specified by:
getTransactionTimeout in interface XAResource (src)
Returns:
Throws:
XAException (src) -

setTransactionTimeout

public boolean setTransactionTimeout(int param1)
                              throws XAException (src)
Description copied from interface: XAResource (src)
Set the transaction timeout value for this resource. If the seconds argument is 0, the timeout value is set to the default timeout value of the resource manager. Not all resource managers support setting the timeout value. If the resource manager does not support setting the timeout value, it should return false.

Specified by:
setTransactionTimeout in interface XAResource (src)
Parameters:
param1 -
Returns:
Throws:
XAException (src) -
Overview  Package   Class  Tree  Deprecated  Index  Help 
 PREV CLASS (src)    NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD