org.apache.derby.iapi.store.access.xa

Class XAXactId

java.lang.Object

org.apache.derby.iapi.store.access.GlobalXact

org.apache.derby.iapi.store.access.xa.XAXactId

All Implemented Interfaces:

javax.transaction.xa.Xid

public class XAXactId
extends GlobalXact
implements javax.transaction.xa.Xid

The XAXactId class is a specific implementation of the JTA Xid interface. It is only used by the TransactionTable.restore() interface to return an array of Xid's back to the caller, as part of serving the XAresource.restore() interface.

It is NOT the object that is stored in the log. One reason for this is that the Formattable and Xid interface's define two different return values for the getFormatId() interface.

Field Summary

Fields inherited from interface javax.transaction.xa.Xid

MAXBQUALSIZE, MAXGTRIDSIZE

Constructor Summary

Constructors

Constructor and Description
XAXactId(int format_id, byte[] global_id, byte[] branch_id) Construct from given pieces of an Xid.
XAXactId(java.lang.String xactIdString)
XAXactId(javax.transaction.xa.Xid xid) Construct an Xid using an external Xid.

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object other)
byte[]	getBranchQualifier() Obtain the transaction branch qualifier part of the Xid in a byte array.
int	getFormatId() Obtain the format id part of the Xid.
byte[]	getGlobalTransactionId() Obtain the global transaction identifier part of XID as an array of bytes.
java.lang.String	toHexString()

Methods inherited from class org.apache.derby.iapi.store.access.GlobalXact

hashCode, toString

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

XAXactId

public XAXactId(int format_id,
                byte[] global_id,
                byte[] branch_id)

Construct from given pieces of an Xid. Makes copies of arrays.

XAXactId

public XAXactId(javax.transaction.xa.Xid xid)
         throws javax.transaction.xa.XAException

Construct an Xid using an external Xid.

Throws:

javax.transaction.xa.XAException - invalid external xid

XAXactId

public XAXactId(java.lang.String xactIdString)

Method Detail

toHexString

public java.lang.String toHexString()

getFormatId

public int getFormatId()

Obtain the format id part of the Xid.

Specified by:

getFormatId in interface javax.transaction.xa.Xid

Returns:

Format identifier. O means the OSI CCR format.

getGlobalTransactionId

public byte[] getGlobalTransactionId()

Obtain the global transaction identifier part of XID as an array of bytes.

Specified by:

getGlobalTransactionId in interface javax.transaction.xa.Xid

Returns:

A byte array containing the global transaction identifier.

getBranchQualifier

public byte[] getBranchQualifier()

Obtain the transaction branch qualifier part of the Xid in a byte array.

Specified by:

getBranchQualifier in interface javax.transaction.xa.Xid

Returns:

A byte array containing the branch qualifier of the transaction.

equals

public boolean equals(java.lang.Object other)

Overrides:

equals in class GlobalXact