Oracle Fusion Middleware interMedia Domains Java API Reference for Oracle ADF Business Components
11g Release 1 (11.1.1.0.0)

E10656-01

oracle.ord.im
Class NotConnectedException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by java.lang.RuntimeException
              extended by oracle.jbo.JboWarning
                  extended by oracle.jbo.JboException
                      extended by oracle.ord.im.OrdJboException
                          extended by oracle.ord.im.NotConnectedException
All Implemented Interfaces:
java.io.Serializable, oracle.jbo.common.JboMessage, oracle.jbo.common.MetaObjectBase, oracle.jbo.Properties

public class NotConnectedException
extends OrdJboException

Signals the method requires a JDBC connection to the database but the interMedia domain object is not yet connected to the database.

Many of the methods of the interMedia domain classes require a database connection. For example: deleteContent and loadDataFromFile both require a connection.

While the domain object instantiated by the Business Components for Java (BC4J) framework to represent the interMedia database object has a database connection, the domain object created by the Java program does not have one. Users should first set a database connection into non-BC4J created domain objects before invoking methods requiring a connection.

To get a connection for the newly created domain object, the user needs to call the postChanges method.

        OrdImageDomain imgDomain = new OrdImageDomain();
        Row row = vo.createRow();
        row.setAttribute("Image", imgDomain);
        viewObject.insertRow(row);
        appModule.getTransaction().postChanges();
        // From this point on, the imgDomain object gets the connection
 

Note the postChanges posts the row into the database, then the row gets selected back, finally the image object gets selected back with the JDBC connection.

Since:
JDev5.0
Version:
JDev5.0
See Also:
Serialized Form

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 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_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_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_VARIABLE, 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
NotConnectedException(java.lang.String methodName, java.lang.String className)
          Constructs a NotConnectedException instance.
 
Method Summary
 
Methods inherited from class oracle.ord.im.OrdJboException
getProductCode, getResourceName
 
Methods inherited from class oracle.jbo.JboException
addToDetails, addToExceptions, containsException, doEntityToVOMapping, getExceptions, getSource, hasPeerExceptions, needsEntityToVOMapping, printStackTrace, printStackTrace, printStackTrace, setApplicationModule, setDetails, setExceptions, setNeedsEntityToVOMapping, setSource
 
Methods inherited from class oracle.jbo.JboWarning
getBaseMessage, getDetailMessage, getDetails, getErrorCode, getErrorParameters, getErrorParametersMap, getJboExceptionHelper, getLocalizedBaseMessage, getLocalizedMessage, getMessage, getProperties, getProperty, getProperty, getResourceClass, getSeverity, getTypeNameFromId, isAppendCodes, isLocalizable, isWarning, refreshProperty, setAppendCodes, setErrorParameters, setErrorParametersMap, setLocaleContext, setProperty, setSeverity
 
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

NotConnectedException

public NotConnectedException(java.lang.String methodName,
                             java.lang.String className)
Constructs a NotConnectedException instance.

Parameters:
methodName - the name of the method requiring the database connection
className - the class name of the domain object

Oracle Fusion Middleware interMedia Domains Java API Reference for Oracle ADF Business Components
11g Release 1 (11.1.1.0.0)

E10656-01

Copyright © 1997, 2008, Oracle. All rights reserved.