oracle.adf.model.dcframe
Interface TransactionHandler

All Known Implementing Classes:

LocalTransactionHandler

public interface TransactionHandler

Since:

11.1.0

Method Summary

void	beginRequest(TransactionHandle transactionHandle, java.util.Collection<DCDataControl> dataControls) Do the proper transactional setup for a new HTTP request, such as resuming a suspended transaction, if necessary.
TransactionHandle	beginTransaction(java.lang.String id, TransactionProperties properties) Begin a new transaction.
void	commit(TransactionHandle transactionHandle, java.util.Collection<DCDataControl> dataControls) Commit the current transaction
SavepointHandle	createSavepoint(TransactionHandle transactionHandle, java.util.Collection<DCDataControl> dataControls) Create a transactional savepoint.
void	endRequest(TransactionHandle transactionHandle, java.util.Collection<DCDataControl> dataControls) Do the proper transactional work before ending a HTTP request, such as suspending the current transaction, if necessary.
void	restoreSavepoint(TransactionHandle transactionHandle, SavepointHandle savepointHandle, BindingContext bindingContext) Undo changes made after the specified savepoint.
void	resumeTransaction(TransactionHandle transactionHandle, java.util.Collection<DCDataControl> dataControls) Resume the suspended transaction.
void	rollback(TransactionHandle transactionHandle, java.util.Collection<DCDataControl> dataControls) Rollback the current transaction
void	suspendTransaction(TransactionHandle transactionHandle, java.util.Collection<DCDataControl> dataControls) Suspend the current transaction.

Method Detail

commit

void commit(TransactionHandle transactionHandle,
            java.util.Collection<DCDataControl> dataControls)

Commit the current transaction

Parameters:

transactionHandle - A handle to the transaction from beginTransaction.

dataControls - A collection containing datacontrols that should be included in the transaction to be committed.

rollback

void rollback(TransactionHandle transactionHandle,
              java.util.Collection<DCDataControl> dataControls)

Rollback the current transaction

Parameters:

transactionHandle - A handle to the transaction from beginTransaction.

dataControls - A collection containing datacontrols that should be included in the transaction to be rolled back.

beginTransaction

TransactionHandle beginTransaction(java.lang.String id,
                                   TransactionProperties properties)

Begin a new transaction.

Parameters:

properties - the transaction properties.

resumeTransaction

void resumeTransaction(TransactionHandle transactionHandle,
                       java.util.Collection<DCDataControl> dataControls)

Resume the suspended transaction.

Parameters:

transactionHandle - A handle to the transaction from beginTransaction.

dataControls - A collection containing datacontrols that should be included in the transaction to be resumed.

suspendTransaction

void suspendTransaction(TransactionHandle transactionHandle,
                        java.util.Collection<DCDataControl> dataControls)

Suspend the current transaction.

Parameters:

transactionHandle - A handle to the transaction from beginTransaction.

dataControls - A collection containing datacontrols that should be included in the transaction to be suspended.

beginRequest

void beginRequest(TransactionHandle transactionHandle,
                  java.util.Collection<DCDataControl> dataControls)

Do the proper transactional setup for a new HTTP request, such as resuming a suspended transaction, if necessary.

Parameters:

transactionHandle - A handle to the transaction from beginTransaction.

dataControls - A collection containing datacontrols that should be included in the transaction if it needs to be resumed.

endRequest

void endRequest(TransactionHandle transactionHandle,
                java.util.Collection<DCDataControl> dataControls)

Do the proper transactional work before ending a HTTP request, such as suspending the current transaction, if necessary.

Parameters:

transactionHandle - A handle to the transaction from beginTransaction.

dataControls - A collection containing datacontrols that should be included in the transaction if it needs to be suspended.

createSavepoint

SavepointHandle createSavepoint(TransactionHandle transactionHandle,
                                java.util.Collection<DCDataControl> dataControls)

Create a transactional savepoint. A savpoint may be used to undo a set of changes in the transactional context.

Parameters:

transactionHandle - a handle to the transaction.

dataControl - a list of the datacontrols that are included in the transaction.

Returns:

a handle to the savepoint that was created.

restoreSavepoint

void restoreSavepoint(TransactionHandle transactionHandle,
                      SavepointHandle savepointHandle,
                      BindingContext bindingContext)

Undo changes made after the specified savepoint. A savepoint may only be restored in the same transaction that it was created, otherwise a RuntimeException will be thrown.

Parameters:

transactionHandle - a handle to the current transaction.

savepointHandle - a handle to the savepoint.

bindingContext - a reference to the bindingContext.