oracle.jbo
Class AfterCommitException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.lang.RuntimeException
              oracle.adfnmc.AdfNmcException
                  oracle.jbo.JboWarning
                      oracle.jbo.JboException
                          oracle.jbo.AfterCommitException

All Implemented Interfaces:

JboMessage, MetaObjectBase, Properties

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)

Field Summary

Fields inherited from class oracle.jbo.JboException

mHasPeerException

Fields inherited from class oracle.jbo.JboWarning

mHelper, SEVERITY_ERROR, SEVERITY_RECOVERABLE_ERROR, SEVERITY_VETOABLE_WARNING, SEVERITY_WARNING

Fields inherited from class oracle.adfnmc.AdfNmcException

CLASS_INSTANCE, PRIORITY_HIGH, PRIORITY_LOW, PRIORITY_MEDIUM

Fields inherited from interface oracle.jbo.common.MetaObjectBase

TYP_APP_MODULE, TYP_ATTRIBUTE, TYP_ATTRIBUTE_LIST_WITH_DEF, TYP_COMPONENT_OBJECT, TYP_DATA_CONTROL, TYP_DEF_ANY, TYP_DEF_APP_MODULE, TYP_DEF_ASSOC_END, TYP_DEF_ATTRIBUTE, TYP_DEF_COMPONENT_OBJECT, TYP_DEF_DOMAIN, TYP_DEF_ENTITY_ASSOC, TYP_DEF_ENTITY_OBJECT, TYP_DEF_KEY, TYP_DEF_LIST_BINDING, TYP_DEF_METHOD, TYP_DEF_PACKAGE, TYP_DEF_VIEW_ACCESSOR, 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_PERS_DEF_APP_MODULE, TYP_PERS_DEF_ATTRIBUTE, TYP_PERS_DEF_COMPONENT_OBJECT, TYP_PERS_DEF_DOMAIN, TYP_PERS_DEF_ENTITY_ASSOC, TYP_PERS_DEF_ENTITY_OBJECT, TYP_PERS_DEF_OFFSET, TYP_PERS_DEF_PACKAGE, TYP_PERS_DEF_VIEW_LINK, TYP_PERS_DEF_VIEW_OBJECT, TYP_SORT_CRITERIA, TYP_TRANSACTION, TYP_VALIDATOR_TYPE, TYP_VARIABLE, TYP_VARIABLE_WHERE_CLAUSE, TYP_VIEW_CRITERIA, TYP_VIEW_LINK, TYP_VIEW_OBJECT, TYP_VIEW_ROW, TYP_VIEW_ROW_SET, TYP_VIEW_ROW_SET_ITERATOR

Constructor Summary

AfterCommitException(java.lang.Class callingClass, java.lang.String callingMethod, java.lang.Exception[] exceptionList)
Creates an instance of AfterCommitException.

Method Summary

Methods inherited from class oracle.jbo.JboException

addToExceptions, doEntityToVOMapping, getExceptions, getStringContent, hasPeerExceptions, needsEntityToVOMapping, setExceptions, setNeedsEntityToVOMapping

Methods inherited from class oracle.jbo.JboWarning

addToDetails, getBaseMessage, getCause, getDetailMessage, getDetails, getErrorCode, getErrorParameters, getJboExceptionHelper, getLocalizedBaseMessage, getLocalizedMessage, getMessage, getProductCode, getProperties, getProperty, getProperty, getResourceClass, getResourceName, getSeverity, getTypeNameFromId, isAppendCodes, isLocalizable, isWarning, refreshProperty, setAppendCodes, setDetails, setErrorParameters, setErrorParametersMap, setLocaleContext, setProperty, setSeverity

Methods inherited from class oracle.adfnmc.AdfNmcException

addLogMessage, addLogMessage, getCallerInfo, getPriority, getStringContent, isFatal, printLogMessages, setFatal, setInnerException, setPriority, toLogString, toString

Methods inherited from class java.lang.Throwable

printStackTrace

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

AfterCommitException

public AfterCommitException(java.lang.Class callingClass,
                            java.lang.String callingMethod,
                            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()