com.bea.wli.config.impl

Class ExecRecordWriter

java.lang.Object

com.bea.wli.config.impl.ExecRecordWriter

All Implemented Interfaces:

TransactionListener

public final class ExecRecordWriter
extends java.lang.Object
implements TransactionListener

generates the execution records - History record and Undo record. limit: if <0, no limit is applied, users will have to purge the history if 0, no records are generated if >0, the number of records is limited

Constructor Summary

Constructors

Constructor and Description
ExecRecordWriter(ConfigServiceImpl configService, int limit)

Method Summary

Modifier and Type	Method and Description
void	afterBegin(Transaction tr) Invoked right after the transaction begins.
void	afterEnd(Transaction tr) Invoked after the transaction ends, namely, after the transaction fully commits or fully rolled back.
void	beforeEnd(Transaction tr) Invoked right before the transaction commits or rollsback.
void	beforePrepare(Transaction tr) Invoked right before the prepare phase starts.
java.lang.String	getId() Unique name for this transactional listener
boolean	rollbackOnFailure() Indicates whether exceptions from TransactionListener.beforePrepare(com.bea.wli.config.transaction.Transaction) methods cause the transaction to rollback.

Methods inherited from class java.lang.Object

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

Constructor Detail

ExecRecordWriter

public ExecRecordWriter(ConfigServiceImpl configService,
                        int limit)

Method Detail

getId

public java.lang.String getId()

Description copied from interface: TransactionListener

Unique name for this transactional listener

Specified by:

getId in interface TransactionListener

rollbackOnFailure

public boolean rollbackOnFailure()

Description copied from interface: TransactionListener

Indicates whether exceptions from TransactionListener.beforePrepare(com.bea.wli.config.transaction.Transaction) methods cause the transaction to rollback.

Specified by:

rollbackOnFailure in interface TransactionListener

Returns:

true if transactions are to be rolled back when call to TransactionListener.beforePrepare(com.bea.wli.config.transaction.Transaction) method raises exceptions; false otherwise

afterBegin

public void afterBegin(Transaction tr)

Description copied from interface: TransactionListener

Invoked right after the transaction begins. A call to this method does not guarantee that beforeEnd method will be called. This call is made at the time is called.

Exception behavior: While the implementations are not supposed to throw exceptions, any unchecked exception will cause the transaction to be abandoned and the caller of the beginTransaction method will get a TransactionException

This method is invoked under the TransactionManager lock.

Specified by:

afterBegin in interface TransactionListener

beforePrepare

public void beforePrepare(Transaction tr)
                   throws java.lang.Exception

Description copied from interface: TransactionListener

Invoked right before the prepare phase starts. At the time the decision is made to call this method, the status of the transaction is Transaction.Status.Active. However it is possible that the transaction may be marked as rollback-only (Transaction.Status.MarkedRollback) after this decision is made and the method is called. Therefore the implementations of this method should not rely on the fact that the transaction status is Transaction.Status.Active.

This method is NOT called if the transaction was marked for rollback only at the time of the decision.

This also implies that if a call to this method fails with an exception and the rollbackOnFailure flag is true for that listener (See TransactionListener.rollbackOnFailure()) , no beforePrepare method is called for the subsequent listeners.

This method is currently invoked outside the TransactionManager lock.

Specified by:

beforePrepare in interface TransactionListener

Throws:

java.lang.Exception

beforeEnd

public void beforeEnd(Transaction tr)

Description copied from interface: TransactionListener

Invoked right before the transaction commits or rollsback. At the time this method is invoked the status of the transaction is either Transaction.Status.Rollingback or Transaction.Status.Committing.

Exception behavior: While the implementations are not supposed to throw exceptions, any unchecked exception will be completely ignored. The remainder of the notifications are delivered normally.

This method is invoked under the TransactionManager lock.

Specified by:

beforeEnd in interface TransactionListener

afterEnd

public void afterEnd(Transaction tr)

Description copied from interface: TransactionListener

Invoked after the transaction ends, namely, after the transaction fully commits or fully rolled back. However any context that is added to the transaction is still available. At the time this method is invoked, the status of the transaction is either Transaction.Status.Rolledback or Transaction.Status.Committed.

This method is invoked under the TransactionManager lock.

Specified by:

afterEnd in interface TransactionListener