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

java.lang.Object
  extended byorg.apache.derby.iapi.store.access.GlobalXact
      extended byorg.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
private static char COLON
          Private Fields of the class
 
Fields inherited from class org.apache.derby.iapi.store.access.GlobalXact
branch_id, format_id, global_id
 
Fields inherited from interface javax.transaction.xa.Xid
MAXBQUALSIZE, MAXGTRIDSIZE
 
Constructor Summary
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
private  void copy_init_xid(int format_id, byte[] global_id, byte[] branch_id)
          initialize by making array copies of appropriate fields.
 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
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Field Detail

COLON

private static final char COLON
Private Fields of the class

See Also:
Constant Field Values
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

copy_init_xid

private void copy_init_xid(int format_id,
                           byte[] global_id,
                           byte[] branch_id)
initialize by making array copies of appropriate fields.


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

Built on Tue 2006-10-10 19:23:47+0200, from revision exported

Apache Derby V10.1 Engine Documentation - Copyright © 1997,2005 The Apache Software Foundation or its licensors, as applicable.