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

E17503-02

oracle.jbo
Class RowInconsistentException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by java.lang.RuntimeException
              extended by oracle.adfnmc.AdfNmcException
                  extended by oracle.jbo.JboWarning
                      extended by oracle.jbo.JboException
                          extended by oracle.jbo.RowInconsistentException
All Implemented Interfaces:
JboMessage, MetaObjectBase, Properties

public class RowInconsistentException
extends JboException

Thrown if inconsist data is detected when locking a row. When an application causes a row to be locked the framework retrieves its data from the database table and checks if it is consistent with the data currently in cache. If it is not, this exception is thrown.

Row consistency can be determined in two ways. First, the application can designate a "change indicator" in the attribte's definition. This is a special attribute, such as a timestamp, which the framework considers a indicator of the status of the rest of the row's data. Alternatively, all the the row's values from the database are compared with the cached values.

Note that even if this exception is thrown, the row will stay locked until the end of transaction.

Since:
JDeveloper 3.0

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
RowInconsistentException(java.lang.Class callingClass, java.lang.String callingMethod, Key key)
          Constructs a new instance.
 
Method Summary
 Key getKey()
          Returns the key of the offending row.
 
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

RowInconsistentException

public RowInconsistentException(java.lang.Class callingClass,
                                java.lang.String callingMethod,
                                Key key)
Constructs a new instance.

Parameters:
key - the key identifying the row with inconsistency.
Method Detail

getKey

public Key getKey()
Returns the key of the offending row.

Returns:
the key.

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

E17503-02

Copyright © 2011, Oracle and/or its affiliates. All rights reserved.