Oracle Fusion Middleware Java API Reference for Oracle ADF Model
11g Release 1 (11.1.1)

E10653-04

oracle.adf.model.dcframe
Class LocalTransactionHandler

java.lang.Object
  extended by oracle.adf.model.dcframe.LocalTransactionHandler
All Implemented Interfaces:
TransactionHandler

public class LocalTransactionHandler
extends java.lang.Object
implements 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.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

createSavepoint

public SavepointHandle createSavepoint(TransactionHandle transactionHandle,
                                       java.util.Collection<DCDataControl> dataControls)
Description copied from interface: TransactionHandler
Create a transactional savepoint. A savpoint may be used to undo a set of changes in the transactional context.

Specified by:
createSavepoint in interface TransactionHandler
Parameters:
transactionHandle - a handle to the transaction.
Returns:
a handle to the savepoint that was created.

restoreSavepoint

public void restoreSavepoint(TransactionHandle transactionHandle,
                             SavepointHandle savepointHandle,
                             BindingContext bindingContext)
Description copied from interface: TransactionHandler
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.

Specified by:
restoreSavepoint in interface TransactionHandler
Parameters:
transactionHandle - a handle to the current transaction.
savepointHandle - a handle to the savepoint.
bindingContext - a reference to the bindingContext.

commit

public void commit(TransactionHandle transactionHandle,
                   java.util.Collection<DCDataControl> dataControls)
Commit the current transaction

Specified by:
commit in interface TransactionHandler
Parameters:
transactionHandle - The transaction to be committed.
dataControls - A collection containing datacontrols that should be included in the transaction to be committed.

rollback

public void rollback(TransactionHandle transactionHandle,
                     java.util.Collection<DCDataControl> dataControls)
Rollback the current transaction

Specified by:
rollback in interface TransactionHandler
Parameters:
transactionHandle - The transaction to be rolled back.
dataControls - A collection containing datacontrols that should be included in the transaction to be rolled back.

beginTransaction

public TransactionHandle beginTransaction(java.lang.String id,
                                          TransactionProperties properties)
Begin a new transaction.

Specified by:
beginTransaction in interface TransactionHandler
Parameters:
properties - the transaction properties.
Returns:
a transaction handle representing the new transaction.

resumeTransaction

public void resumeTransaction(TransactionHandle transactionHandle,
                              java.util.Collection<DCDataControl> dataControls)
Resume the suspended transaction.

Specified by:
resumeTransaction in interface TransactionHandler
Parameters:
transactionHandle - The transaction to be resumed.
dataControls - A collection containing datacontrols that should be included in the transaction to be resumed.

suspendTransaction

public void suspendTransaction(TransactionHandle transactionHandle,
                               java.util.Collection<DCDataControl> dataControls)
Suspend the current transaction.

Specified by:
suspendTransaction in interface TransactionHandler
Parameters:
transactionHandle - The transaction to be resumed.
dataControls - A collection containing datacontrols that should be included in the transaction to be suspended.

beginRequest

public 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.

Specified by:
beginRequest in interface TransactionHandler
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

public 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.

Specified by:
endRequest in interface TransactionHandler
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.

Oracle Fusion Middleware Java API Reference for Oracle ADF Model
11g Release 1 (11.1.1)

E10653-04

Copyright © 1997, 2010, Oracle. All rights reserved.