tyrex.tm.xid
Class ExternalXid

java.lang.Object
  tyrex.tm.xid.BaseXid
      tyrex.tm.xid.ExternalXid

All Implemented Interfaces:

javax.transaction.xa.Xid

public final class ExternalXid

extends BaseXid

External transaction identifier. Used for all distributed transactions and branches created externally.

Version:

$Revision: 1.2 $

Author:

Assaf Arkin

Field Summary

Fields inherited from class tyrex.tm.xid.BaseXid

_string, EMPTY_ARRAY, FORMAT_ID, HEX_DIGITS, XID_PREFIX

Fields inherited from interface javax.transaction.xa.Xid

MAXBQUALSIZE, MAXGTRIDSIZE

Constructor Summary

	ExternalXid(int formatId, byte[] global, byte[] branch) Construct a new transaction identifier.
(package private)	ExternalXid(java.lang.String identifier, int formatId, byte[] global, byte[] branch) Used by XidUtils.
	ExternalXid(javax.transaction.xa.Xid xid) Constructs a new transaction identifier from an existing transaction identifier.

Method Summary

boolean	equals(java.lang.Object other)
byte[]	getBranchQualifier()
int	getFormatId()
byte[]	getGlobalTransactionId()
javax.transaction.xa.Xid	newBranch() Creates a new transaction branch.

Methods inherited from class tyrex.tm.xid.BaseXid

createPrefix, hashCode, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ExternalXid

public ExternalXid(int formatId,
                   byte[] global,
                   byte[] branch)

Construct a new transaction identifier. The format identifier must not be -1, this value is reserved for the null transaction.

Parameters:

global - The global transaction identifier

branch - The branch qualifier

ExternalXid

public ExternalXid(javax.transaction.xa.Xid xid)

Constructs a new transaction identifier from an existing transaction identifier. This constructor is used when importing external transaction identiiers.

Parameters:

xid - The existing transaction identifier

ExternalXid

ExternalXid(java.lang.String identifier,
            int formatId,
            byte[] global,
            byte[] branch)

Used by XidUtils.

Method Detail

getFormatId

public int getFormatId()

getGlobalTransactionId

public byte[] getGlobalTransactionId()

getBranchQualifier

public byte[] getBranchQualifier()

equals

public boolean equals(java.lang.Object other)

newBranch

public javax.transaction.xa.Xid newBranch()

Description copied from class: BaseXid

Creates a new transaction branch. A transaction branch has the same format and global transaction identifier as this transaction identifier, but a new unique branch qualifier (never empty).

Specified by:

newBranch in class BaseXid

Returns:

A new transaction branch