com.arjuna.ats.internal.jta.resources.jts.orbspecific

Class XAResourceRecord

java.lang.Object

org.omg.PortableServer.Servant

com.arjuna.ArjunaOTS.OTSAbstractRecordPOA

com.arjuna.ats.internal.jta.resources.jts.orbspecific.XAResourceRecord

All Implemented Interfaces:

ArjunaSubtranAwareResourceOperations, OTSAbstractRecordOperations, InvokeHandler, ResourceOperations, SubtransactionAwareResourceOperations

Direct Known Subclasses:

LastResourceRecord, XARecoveryResourceImple, XAResourceRecordBean.JTSXAResourceRecordWrapper

public class XAResourceRecord
extends OTSAbstractRecordPOA

Field Summary

Fields

Modifier and Type	Field and Description
protected XAResource	_theXAResource
static int	XACONNECTION

Constructor Summary

Constructors

Modifier	Constructor and Description
	XAResourceRecord()
	XAResourceRecord(TransactionImple tx, XAResource res, Xid xid, Object[] params) The params represent specific parameters we need to recreate the connection to the database in the event of a failure.
protected	XAResourceRecord(Uid u)

Method Summary

Modifier and Type	Method and Description
void	alter(OTSAbstractRecord record)
void	commit_one_phase() For commit_one_phase we can do whatever we want since the transaction outcome is whatever we want.
void	commit_subtransaction(Coordinator parent)
void	commit()
void	forget()
Uid	get_uid()
RecoveryCoordinator	getRecoveryCoordinator() Deprecated. Only used in tests
Resource	getResource()
Xid	getXid()
void	merge(OTSAbstractRecord record)
protected boolean	notAProblem(XAException ex, boolean commit) Is the XAException a non-error when received in reply to commit or rollback? It normally is, but may be overridden in recovery.
Vote	prepare_subtransaction()
Vote	prepare()
boolean	propagateOnAbort()
boolean	propagateOnCommit()
protected int	recover()
boolean	restoreState(InputObjectState os)
void	rollback_subtransaction()
void	rollback()
boolean	saveRecord()
boolean	saveState(OutputObjectState os)
void	setRecoveryCoordinator(RecoveryCoordinator recCoord)
protected void	setXAResource(XAResource res) For those objects where the original XAResource could not be saved.
boolean	shouldAdd(OTSAbstractRecord record)
boolean	shouldAlter(OTSAbstractRecord record)
boolean	shouldMerge(OTSAbstractRecord record)
boolean	shouldReplace(OTSAbstractRecord record)
String	toString()
int	type_id()
String	type()
static String	typeName()
String	uid()

Methods inherited from class com.arjuna.ArjunaOTS.OTSAbstractRecordPOA

_all_interfaces, _invoke, _this, _this

Methods inherited from class org.omg.PortableServer.Servant

_default_POA, _get_delegate, _get_interface_def, _is_a, _non_existent, _object_id, _orb, _poa, _set_delegate, _this_object, _this_object

Methods inherited from class java.lang.Object

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

Field Detail

XACONNECTION

public static final int XACONNECTION

See Also:

Constant Field Values

_theXAResource

protected XAResource _theXAResource

Constructor Detail

XAResourceRecord

public XAResourceRecord(TransactionImple tx,
                        XAResource res,
                        Xid xid,
                        Object[] params)

The params represent specific parameters we need to recreate the connection to the database in the event of a failure. If they're not set then recovery is out of our control. Could also use it to pass other information, such as the readonly flag.

XAResourceRecord

public XAResourceRecord()

XAResourceRecord

protected XAResourceRecord(Uid u)

Method Detail

get_uid

public final Uid get_uid()

getResource

public final Resource getResource()

getXid

public final Xid getXid()

prepare

public Vote prepare()
             throws HeuristicMixed,
                    HeuristicHazard,
                    SystemException

Throws:

HeuristicMixed

HeuristicHazard

SystemException

rollback

public void rollback()
              throws SystemException,
                     HeuristicCommit,
                     HeuristicMixed,
                     HeuristicHazard

Throws:

SystemException

HeuristicCommit

HeuristicMixed

HeuristicHazard

commit

public void commit()
            throws SystemException,
                   NotPrepared,
                   HeuristicRollback,
                   HeuristicMixed,
                   HeuristicHazard

Throws:

SystemException

NotPrepared

HeuristicRollback

HeuristicMixed

HeuristicHazard

prepare_subtransaction

public Vote prepare_subtransaction()
                            throws SystemException

Throws:

SystemException

commit_subtransaction

public void commit_subtransaction(Coordinator parent)
                           throws SystemException

Throws:

SystemException

rollback_subtransaction

public void rollback_subtransaction()
                             throws SystemException

Throws:

SystemException

type_id

public int type_id()
            throws SystemException

Throws:

SystemException

uid

public String uid()
           throws SystemException

Throws:

SystemException

propagateOnAbort

public boolean propagateOnAbort()
                         throws SystemException

Throws:

SystemException

propagateOnCommit

public boolean propagateOnCommit()
                          throws SystemException

Throws:

SystemException

saveRecord

public boolean saveRecord()
                   throws SystemException

Throws:

SystemException

merge

public void merge(OTSAbstractRecord record)
           throws SystemException

Throws:

SystemException

alter

public void alter(OTSAbstractRecord record)
           throws SystemException

Throws:

SystemException

shouldAdd

public boolean shouldAdd(OTSAbstractRecord record)
                  throws SystemException

Throws:

SystemException

shouldAlter

public boolean shouldAlter(OTSAbstractRecord record)
                    throws SystemException

Throws:

SystemException

shouldMerge

public boolean shouldMerge(OTSAbstractRecord record)
                    throws SystemException

Throws:

SystemException

shouldReplace

public boolean shouldReplace(OTSAbstractRecord record)
                      throws SystemException

Throws:

SystemException

notAProblem

protected boolean notAProblem(XAException ex,
                              boolean commit)

Is the XAException a non-error when received in reply to commit or rollback? It normally is, but may be overridden in recovery.

commit_one_phase

public void commit_one_phase()
                      throws HeuristicHazard,
                             SystemException

For commit_one_phase we can do whatever we want since the transaction outcome is whatever we want. Therefore, we do not need to save any additional recoverable state, such as a reference to the transaction coordinator, since it will not have an intentions list anyway.

Throws:

HeuristicHazard

SystemException

forget

public void forget()
            throws SystemException

Throws:

SystemException

saveState

public boolean saveState(OutputObjectState os)

restoreState

public boolean restoreState(InputObjectState os)

type

public String type()

typeName

public static String typeName()

setRecoveryCoordinator

public final void setRecoveryCoordinator(RecoveryCoordinator recCoord)

getRecoveryCoordinator

public final RecoveryCoordinator getRecoveryCoordinator()

Deprecated. Only used in tests

toString

public String toString()

Overrides:

toString in class Object

setXAResource

protected void setXAResource(XAResource res)

For those objects where the original XAResource could not be saved.

recover

protected int recover()