oracle.jbo

Class AfterPostException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

oracle.jbo.JboWarning

oracle.jbo.JboException

oracle.jbo.AfterPostException

All Implemented Interfaces:

java.io.Serializable, JboMessage, MetaObjectBase, Properties, ExprWrappable

public class AfterPostException
extends JboException

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

When the user asks to post changes to database, the Transaction object walks through its TransactionPostListener (oracle.jbo.server.TransactionPostListener) list.

A TransactionPostListener may be "transient" or "persistent." A transient post listener is one which is added to the list until the changes are posted. After the changes are posted, it is removed from the post listener list. A persistent post listener is one which is kept on the list even after the changes are posted.

Entities (oracle.jbo.server.EntityImpl are transient post listener and View Objects (oracle.jbo.server.ViewObjectImpl) are persistent post listeners.

Among TransactionPostListeners, the Transaction object calls postChanges() each Entity to make it post changes to database.

Once this posting phase completes, Transaction walks through the TransactionPostListener list again performing after-post operation on each of them.

For Entity, this operation consists mainly of removing the Entity frmo the transaction post manager, which may be the Transaction object or the parent Entity if this Entity was a child object in a composition association.

For View Object, this operation consists mainly of closing result sets that are not used by any Row Sets.

While performing these after-post operations, error may be found and thrown by TransactionPostListeners. The Transaction object collects these objects in a list. After after-post processing completes for all TransactionPostListeners, Transaction checks to see if this list is empty. If not (some TransactionPostListeners threw exceptions), it creates an AfterPostException whose details (which may be retrieved by calling to getExceptions()) contain those exceptions thrown during the after-post processing.

Since:

JDevloper 3.0

See Also:

JboException, JboException.getExceptions(), Transaction, TransactionPostListener, Serialized Form

Field Summary

Fields inherited from class oracle.jbo.JboException

mHasPeerException

Fields inherited from class oracle.jbo.JboWarning

HIDE_DETAIL_EXCEPTIONS_HINT, mHelper, SEVERITY_ERROR, SEVERITY_INFORMATION, SEVERITY_RAC_RECOVERABLE_ERROR, SEVERITY_RECOVERABLE_ERROR, SEVERITY_VETOABLE_WARNING, SEVERITY_WARNING, SYSTEM_ERROR

Fields inherited from interface oracle.jbo.common.MetaObjectBase

TYP_APP_MODULE, TYP_ATTRIBUTE, TYP_ATTRIBUTE_LIST_WITH_DEF, TYP_CATEGORY, 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_EXPRWHITELIST, TYP_DEF_KEY, TYP_DEF_LIST_BINDING, TYP_DEF_METHOD, TYP_DEF_OPERATION, TYP_DEF_OPERATION_PARAM, TYP_DEF_OPERATIONS, TYP_DEF_PACKAGE, TYP_DEF_ROWFINDER, TYP_DEF_VIEW_ACCESSOR, TYP_DEF_VIEW_ANNOT, TYP_DEF_VIEW_LINK, TYP_DEF_VIEW_LINK_END, 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_ITERATOR_BINDING, 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_OPERATION, TYP_PERS_DEF_PACKAGE, TYP_PERS_DEF_VARIABLE, TYP_PERS_DEF_VIEW_LINK, TYP_PERS_DEF_VIEW_OBJECT, TYP_SERVICE_VIEW_USAGE, TYP_SORT_CRITERIA, TYP_SORT_CRITERIA_LIST, TYP_TRANSACTION, TYP_TRIGGER_TYPE, TYP_VALIDATOR_TYPE, TYP_VARIABLE, TYP_VARIABLE_WHERE_CLAUSE, TYP_VIEW_CRITERIA, TYP_VIEW_CRITERIA_ITEM, TYP_VIEW_CRITERIA_ROW, TYP_VIEW_LINK, TYP_VIEW_OBJECT, TYP_VIEW_ROW, TYP_VIEW_ROW_SET, TYP_VIEW_ROW_SET_ITERATOR, TYP_VIEW_USAGE

Constructor Summary

Constructors

Constructor and Description
AfterPostException(java.lang.Exception[] exceptionList) Creates an instance of AfterPostException.

Method Summary

Methods inherited from class oracle.jbo.JboException

addToDetails, addToExceptions, cacheMessage, containsException, doEntityToVOMapping, getExceptions, hasPeerExceptions, needsEntityToVOMapping, printStackTrace, printStackTrace, printStackTrace, setApplicationModule, setDetails, setExceptions, setNeedsEntityToVOMapping

Methods inherited from class oracle.jbo.JboWarning

adjustRowSpecificHints, getBaseMessage, getDetailMessage, getDetails, getErrorCode, getErrorParameters, getErrorParametersMap, getJboExceptionHelper, getLocalizedBaseMessage, getLocalizedMessage, getMessage, getProductCode, getProperties, getProperty, getProperty, getResourceClass, getResourceName, getSeverity, getSource, getTypeNameFromId, isAppendCodes, isExceptionInNonUIContext, isInformation, isLocalizable, isShowDetailExceptions, isWarning, processHelper, refreshProperty, setAppendCodes, setErrorParameters, setErrorParametersMap, setLocaleContext, setProperty, setSeverity, setShowDetailExceptions, setSource

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

Constructor Detail

AfterPostException

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

Creates an instance of AfterPostException. This constructor uses EXC_AFTER_POST error message in oracle.jbo.CSMessageBundle.

Parameters:

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

See Also:

JboException.getExceptions()