oracle.tmm.tcc

Class TccClient

java.lang.Object

oracle.tmm.tcc.TccClient

public class TccClient
extends java.lang.Object

TccTransaction - Helper class to execute current tcc transactions

Constructor Summary

Constructors

Constructor and Description
TccClient()

Method Summary

Modifier and Type	Method and Description
static void	addTccParticipant(java.lang.String uri) Add a participant to the current TCC transaction
static CancelResponse	cancel() Cancel the TCC transaction
static CancelResponse	cancel(java.util.List<TccParticipant> participants) Cancel the TCC transaction optionally adding additional participants
static ConfirmResponse	confirm() Confirm the TCC transaction
static ConfirmResponse	confirm(java.util.List<TccParticipant> participants) Confirm the TCC transaction optionally adding additional participants
static long	getTimeLimit() Get the time limit in milliseconds for the current TCC transaction This value overrides the value set via @TCC annotation
static java.lang.String	getTransactionId() Get the current transaction id
static void	setTimeLimit(long timeLimit) Set the time limit in milliseconds for the current transaction.

Methods inherited from class java.lang.Object

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

Constructor Detail

TccClient

public TccClient()

Method Detail

confirm

public static ConfirmResponse confirm()
                               throws TccUnknownTransactionException,
                                      TccHeuristicException,
                                      TccException

Confirm the TCC transaction

This asks the transaction coordinator to confirm all the participants in the transaction.

Returns:

returns the list of participants with their updated state

Throws:

TccException - some failure occurred communicating with the transaction coordinator

TccUnknownTransactionException - transaction not found or unknown error at coordinator side

TccHeuristicException - not all the participants confirmed

confirm

public static ConfirmResponse confirm(java.util.List<TccParticipant> participants)
                               throws TccUnknownTransactionException,
                                      TccHeuristicException,
                                      TccException

Confirm the TCC transaction optionally adding additional participants

This asks the transaction coordinator to confirm all the participants in the transaction including those added by this call.

Parameters:

participants - list of TccParticipants to be included in the confirmation of the transaction

Returns:

returns the list of participants with their updated state

Throws:

TccException - some failure occurred communicating with the transaction coordinator

TccUnknownTransactionException - transaction not found or unknown error at coordinator side

TccHeuristicException - not all the participants confirmed

cancel

public static CancelResponse cancel()
                             throws TccUnknownTransactionException,
                                    TccHeuristicException,
                                    TccException

Cancel the TCC transaction

This asks the transaction coordinator to cancel all the participants.

Returns:

CancelResponse includes participants and transaction status

Throws:

TccException - some failure occurred communicating with the transaction coordinator

TccUnknownTransactionException - transaction not found or unknown error at coordinator side

TccHeuristicException - not all the participants cancelled

cancel

public static CancelResponse cancel(java.util.List<TccParticipant> participants)
                             throws TccUnknownTransactionException,
                                    TccHeuristicException,
                                    TccException

Cancel the TCC transaction optionally adding additional participants

This asks the transaction coordinator to cancel all the participants in the transaction including those added by this call.

Parameters:

participants - optional list of TccParticipants to be included in the cancelling of the transaction

Returns:

CancelResponse includes participants and transaction status

Throws:

TccException - some failure occurred communicating with the transaction coordinator

TccUnknownTransactionException - transaction not found or unknown error at coordinator side

TccHeuristicException - not all the participants cancelled

getTransactionId

public static java.lang.String getTransactionId()
                                         throws TccUnknownTransactionException

Get the current transaction id

Returns:

transaction id

Throws:

TccUnknownTransactionException - TCC transaction is associated to the current thread

addTccParticipant

public static void addTccParticipant(java.lang.String uri)
                              throws TccUnknownTransactionException

Add a participant to the current TCC transaction

Parameters:

uri - the URI of the participant resource

Throws:

TccUnknownTransactionException - TCC transaction is associated to the current thread

setTimeLimit

public static void setTimeLimit(long timeLimit)
                         throws TccUnknownTransactionException

Set the time limit in milliseconds for the current transaction. This will override the time limit set using @TCC annotation

Parameters:

timeLimit - time limit in milliseconds

Throws:

TccUnknownTransactionException - TCC transaction is associated to the current thread

getTimeLimit

public static long getTimeLimit()
                         throws TccUnknownTransactionException

Get the time limit in milliseconds for the current TCC transaction This value overrides the value set via @TCC annotation

Returns:

time limit in milliseconds for the current TCC transaction

Throws:

TccUnknownTransactionException - TCC transaction is associated to the current thread