org.jboss.tm.usertx.interfaces
Interface UserTransactionSession

All Superinterfaces:

Remote

All Known Implementing Classes:

UserTransactionSessionImpl, UserTransactionSessionImpl_Stub

public interface UserTransactionSession
extends Remote

The RMI remote UserTransaction session interface.

Version:

$Revision: 1.4.6.1 $

Author:

Ole Husgaard

Method Summary

Object	begin(int timeout) Start a new transaction, and return its TPC.
void	commit(Object tpc) Commit the transaction.
void	destroy() Destroy this session.
int	getStatus(Object tpc) Return status of the transaction.
void	rollback(Object tpc) Rollback the transaction.
void	setRollbackOnly(Object tpc) Mark the transaction for rollback only.

Method Detail

destroy

void destroy()
             throws RemoteException

Destroy this session.

Throws:

RemoteException

begin

Object begin(int timeout)
             throws RemoteException,
                    NotSupportedException,
                    SystemException

Start a new transaction, and return its TPC.

Parameters:

timeout - The timeout value for the new transaction, in seconds.

Returns:

The transaction propagation context for the new transaction.

Throws:

RemoteException

NotSupportedException

SystemException

commit

void commit(Object tpc)
            throws RemoteException,
                   RollbackException,
                   HeuristicMixedException,
                   HeuristicRollbackException,
                   SecurityException,
                   IllegalStateException,
                   SystemException

Commit the transaction.

Parameters:

tpc - The transaction propagation context for the transaction.

Throws:

RemoteException

RollbackException

HeuristicMixedException

HeuristicRollbackException

SecurityException

IllegalStateException

SystemException

rollback

void rollback(Object tpc)
              throws RemoteException,
                     SecurityException,
                     IllegalStateException,
                     SystemException

Rollback the transaction.

Parameters:

tpc - The transaction propagation context for the transaction.

Throws:

RemoteException

SecurityException

IllegalStateException

SystemException

setRollbackOnly

void setRollbackOnly(Object tpc)
                     throws RemoteException,
                            IllegalStateException,
                            SystemException

Mark the transaction for rollback only.

Parameters:

tpc - The transaction propagation context for the transaction.

Throws:

RemoteException

IllegalStateException

SystemException

getStatus

int getStatus(Object tpc)
              throws RemoteException,
                     SystemException

Return status of the transaction.

Parameters:

tpc - The transaction propagation context for the transaction.

Throws:

RemoteException

SystemException