Struct dist_tx::tm::XaTransactionId

pub struct XaTransactionId { /* private fields */ }

The ID of a distributed transaction, in analogy to the X/Open XA standard.

Implementations

impl XaTransactionId

pub fn try_new(
    format_id: i32,
    global_tid: Vec<u8>,
    branch_qualifier: Vec<u8>
) -> XaResult<XaTransactionId>

Creates an instance of XaTransactionId from the three components format_id, global_tid, and branch_qualifier.

Note that the lengths of the binary parameters must not exceed 64.

XA uses a signed int for the format_id, but recommends using only -1, 0, and positive values, where -1 is used to represent the NULL value.

pub fn null_ta() -> XaTransactionId

Creates an instance of XaTransactionId that represents NULL.

pub fn get_format_id(&self) -> i32

Returns the format_id.

pub fn get_global_tid(&self) -> &Vec<u8>

Returns a reference to the global transaction id.

pub fn get_branch_qualifier(&self) -> &Vec<u8>

Returns a reference to the branch qualifier.

pub fn as_bytes(&self, padding: bool) -> Result<Vec<u8>>

Provides a binary representation. If padding is true, and the combined length of the binary fields is below 128 bytes, the missing number of zero bytes are appended to make the byte pattern compatible with the XA structure in C.

pub fn parse(
    bytes: &[u8],
    count: u64,
    padding: bool
) -> XaResult<Vec<XaTransactionId>>

Reads a Vec of instances from a binary representation. If padding is true, and the combined length of the binary fields is below 128 bytes, the missing number of bytes are skipped to make the byte pattern compatible with the XA structure in C.

Trait Implementations

impl Clone for XaTransactionId

fn clone(&self) -> XaTransactionId

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for XaTransactionId

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.