oracle.jbo
Class AfterCommitException

java.lang.Object
  |
  +--java.lang.Throwable
        |
        +--java.lang.Exception
              |
              +--java.lang.RuntimeException
                    |
                    +--oracle.jbo.JboException
                          |
                          +--oracle.jbo.AfterCommitException

All Implemented Interfaces:

JboMessage, MetaObjectBase, java.io.Serializable

public class AfterCommitException

extends JboException

Indicates failure during the after-commit phase of the transaction cycle.

When the transaction is committed in BC4J, all pending changes are first posted to database, followed by a database commit. After that, the Transaction object walks through its TransactionListener (oracle.jbo.server.TransactionListener) list.

For each TransactionListener, a transaction-committed "message" is sent through a call to the afterCommit(). (afterCommit() is a method on the TransactionListener interface.)

While in afterCommit(), the TransactionListener may find problems and throw an exception. The Transaction object collects these objects in a list. After all TransactionListeners are notified, Transaction checks to see if this list is empty. If not (some TransactionListeners threw exceptions), it creates an AfterCommitException whose details (which may be retrieved by calling getExceptions()) contain those exceptions thrown during this notification process.

Since:

JDevloper 3.0

See Also:

JboException, JboException.getExceptions(), Transaction, TransactionListener, TransactionListener.afterCommit(TransactionEvent), Serialized Form

Field Summary

Fields inherited from class oracle.jbo.JboException

mHasPeerException

Fields inherited from interface oracle.jbo.common.MetaObjectBase

TYP_APP_MODULE, TYP_ATTRIBUTE, TYP_COMPONENT_OBJECT, TYP_DEF_ANY, TYP_DEF_APP_MODULE, TYP_DEF_ATTRIBUTE, TYP_DEF_COMPONENT_OBJECT, TYP_DEF_DOMAIN, TYP_DEF_ENTITY_ASSOC, TYP_DEF_ENTITY_OBJECT, TYP_DEF_PACKAGE, TYP_DEF_VIEW_LINK, TYP_DEF_VIEW_OBJECT, TYP_DOMAIN, TYP_ENTITY_ASSOC, TYP_ENTITY_OBJECT, TYP_ENTITY_ROW, TYP_ENTITY_ROW_SET, TYP_ENTITY_ROW_SET_ITERATOR, TYP_ENTITY_USAGE, TYP_PACKAGE, TYP_VALIDATOR_TYPE, TYP_VIEW_LINK, TYP_VIEW_OBJECT, TYP_VIEW_ROW, TYP_VIEW_ROW_SET, TYP_VIEW_ROW_SET_ITERATOR

Constructor Summary

AfterCommitException(java.lang.Exception[] exceptionList)
Creates an instance of AfterCommitException.

Methods inherited from class oracle.jbo.JboException

addToDetails, addToExceptions, doEntityToVOMapping, getBaseMessage, getDetailMessage, getDetails, getErrorCode, getErrorParameters, getExceptions, getJboExceptionHelper, getLocalizedBaseMessage, getLocalizedMessage, getMessage, getProductCode, getResourceClass, getResourceName, getTypeNameFromId, hasPeerExceptions, isAppendCodes, isLocalizable, needsEntityToVOMapping, printStackTrace, printStackTrace, printStackTrace, setAppendCodes, setApplicationModule, setDetails, setErrorParameters, setExceptions, setNeedsEntityToVOMapping

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, initCause, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

AfterCommitException

public AfterCommitException(java.lang.Exception[] exceptionList)

Creates an instance of AfterCommitException. This constructor uses EXC_AFTER_COMMIT error message in oracle.jbo.CSMessageBundle.

Parameters:

exceptionList - an Array of exception thrown by TransactionListeners. Exceptions from this array are added as "details" of this exception. Details may be retrieved by calling getExceptions.

See Also:

JboException.getExceptions()