org.omg.CosTransactions
Interface CurrentOperations

All Known Subinterfaces:

Current

All Known Implementing Classes:

_CurrentStub, CurrentPOA

public interface CurrentOperations

The Current interface defines operations that allow a client of the Tranaction Service to explicitly manage the association between threads and transactions.

Method Summary

void	begin() Create a new transaction and associate it with the current thread.
void	commit(boolean report_heuristics) Complete the transaction associated with the current thread by committing all operations.
Control	get_control() The Control object that represents the transaction associated with the current thread.
Status	get_status() The Status of the transaction associated with the current thread.
int	get_timeout()
String	get_transaction_name() The printable string describing the transaction associated with the current thread.
void	resume(Control which) The current tread is associated with the transaciton represented by the Control object in the parameter.
void	rollback_only() The transaction associated with the current thread is modified so that the only posible outcome is to rollback the transaction.
void	rollback() Complete the transaction associated with the current thread by rolling back all operations.
void	set_timeout(int seconds) Set the time-out period in seconds of the transaction associated with the current thread
Control	suspend() If there is a tread associated with the current thread, it is disassociated with current thread and a Control object representing the transaction is returned.

Method Detail

begin

public void begin()
           throws SubtransactionsUnavailable

Create a new transaction and associate it with the current thread.

Throws:

SubtransactionsUnavailable

commit

public void commit(boolean report_heuristics)
            throws NoTransaction,
                   HeuristicMixed,
                   HeuristicHazard

Complete the transaction associated with the current thread by committing all operations.

Throws:

NoTransaction

HeuristicMixed

HeuristicHazard

rollback

public void rollback()
              throws NoTransaction

Complete the transaction associated with the current thread by rolling back all operations.

Throws:

NoTransaction

rollback_only

public void rollback_only()
                   throws NoTransaction

The transaction associated with the current thread is modified so that the only posible outcome is to rollback the transaction.

Throws:

NoTransaction

get_status

public Status get_status()

The Status of the transaction associated with the current thread.

get_transaction_name

public String get_transaction_name()

The printable string describing the transaction associated with the current thread.

set_timeout

public void set_timeout(int seconds)

Set the time-out period in seconds of the transaction associated with the current thread

get_timeout

public int get_timeout()

get_control

public Control get_control()

The Control object that represents the transaction associated with the current thread.

suspend

public Control suspend()

If there is a tread associated with the current thread, it is disassociated with current thread and a Control object representing the transaction is returned. Otherwise, a null pointer is returned.

resume

public void resume(Control which)
            throws InvalidControl

The current tread is associated with the transaciton represented by the Control object in the parameter.

Throws:

InvalidControl