|
Oracle9i Business Components for Java API Reference Oracle9i Jdeveloper (9.0.4) B10391-01 | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--oracle.jbo.common.NamedObjectImpl | +--oracle.jbo.mom.DefinitionObject | +--oracle.jbo.server.DefObject | +--oracle.jbo.server.ApplicationModuleDefImpl
The base class for all generated ApplicationModule classes.
An Application Module is a container for View Objects, View Links and other Application Modules. This class stores the runtime metadata for Application Modules. Like other Def objects, ApplicationModuleDef objects are stored, by name, in the XML file. This class is needed to load an Application Module and the components it contains from XML metadata. Calling loadXML() on an object instantiated from this class causes its components to be installed.
Field Summary | |
protected boolean |
mClearCacheOnCommit Value determines whether cache should be cleared on a database commit operation. |
protected boolean |
mClearCacheOnRollback Value determines whether cache should be cleared on a database rollback operation. |
protected java.lang.Class |
mComponentClass |
protected com.sun.java.util.collections.ArrayList |
mCompUsageList List of ComponentObject names |
protected com.sun.java.util.collections.HashMap |
mCompUsages Hash table to keep a list of name value pairs for ComponentUsages |
protected com.sun.java.util.collections.HashMap |
mRemoteServers Hash table to keep name value pairs for Platform, RemoteServer pairs. |
protected boolean |
mRequeryOnCommit Value determines whether the database should be requeried after a commit operation. |
protected com.sun.java.util.collections.HashMap |
mValidatorTypes |
protected com.sun.java.util.collections.ArrayList |
mViewLinkUsageList List of ViewLinkUsages. |
protected com.sun.java.util.collections.HashMap |
mViewLinkUsages Hash table to keep a list of name value pairs for ViewLinkUsages. |
protected com.sun.java.util.collections.ArrayList |
mViewUsageList List of View Object names. |
protected com.sun.java.util.collections.HashMap |
mViewUsages Hash table to keep a list of name value pairs for ViewUsages. |
Fields inherited from class oracle.jbo.mom.DefinitionObject |
mBaseDefObject, mExtendedDefObjects, mObjectResolved |
Fields inherited from class oracle.jbo.common.NamedObjectImpl |
mFullName, mObjName, mParent, mProperties |
Constructor Summary | |
protected |
ApplicationModuleDefImpl() Default Constructor. |
Method Summary | |
static ApplicationModuleDefImpl |
findDefObject(java.lang.String name) Finds an ApplicationModuleDefImpl instance, by name, from the statically maintained list of metaobjects. |
static ApplicationModuleDefImpl |
findDefObjectNoSub(java.lang.String name) Finds the named Application Module definition. |
protected void |
finishedLoading() |
oracle.jbo.mom.DefinitionObject |
getBaseDefObject() |
java.lang.String |
getClientProxyClassName(java.lang.String platform) Internal: Applications should not use this method. |
java.lang.Class |
getComponentClass() Internal: Applications should not use this method. |
oracle.jbo.server.PackageDefImpl |
getPackageDef() |
java.lang.String |
getPackageName() |
java.lang.String |
getServerClassName(java.lang.String platform) Internal: Applications should not use this method. |
boolean |
isClearCacheOnCommit() Returns the flag indicating whether all Entity Object caches will be cleared after the transaction is committed. |
boolean |
isClearCacheOnRollback() Returns the flag indicating whether all Entity Object caches will be cleared after the transaction is rolled back. |
boolean |
isRequeryOnCommit() Indicates whether View Objects associated with this Application Module should be marked as needing to be executed after a database commit. |
void |
loadContainees() Internal: Applications should not use this method. |
protected static ApplicationModuleDefImpl |
loadFromXML(oracle.jbo.mom.xml.DefElementImpl xmlElement) Internal: Applications should not use this method. |
protected static ApplicationModuleDefImpl |
loadFromXML(oracle.jbo.mom.xml.DefElementImpl xmlElement, ApplicationModuleDefImpl aInfo) Internal: Applications should not use this method. |
protected void |
loadProperties(oracle.jbo.mom.xml.DefElementImpl xmlElement) |
protected void |
resolveReferences() |
protected void |
setBaseDefObject(oracle.jbo.mom.DefinitionObject baseDefObject) |
protected void |
setName(java.lang.String name) Name this object. |
protected void |
setParent(NamedObjectImpl parent) Sets this object's parent. |
Methods inherited from class oracle.jbo.mom.DefinitionObject |
addExtendedDefObject, getContainerDef, getContainerName, getExtendedDefObjects, isBaseDefFor, isDynamicDefinitionObject, isObjectResolved, setObjectResolved |
Methods inherited from class oracle.jbo.common.NamedObjectImpl |
getFullName, getName, getParent, getProperties, getPropertiesAsStrings, getPropertiesMap, getProperty, refreshProperty, setFullName, setPropertiesMap, setProperty |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
protected boolean mClearCacheOnCommit
protected boolean mClearCacheOnRollback
protected boolean mRequeryOnCommit
protected com.sun.java.util.collections.HashMap mValidatorTypes
protected com.sun.java.util.collections.HashMap mViewUsages
protected com.sun.java.util.collections.ArrayList mViewUsageList
protected com.sun.java.util.collections.HashMap mViewLinkUsages
protected com.sun.java.util.collections.ArrayList mViewLinkUsageList
protected com.sun.java.util.collections.HashMap mRemoteServers
protected com.sun.java.util.collections.HashMap mCompUsages
protected com.sun.java.util.collections.ArrayList mCompUsageList
protected java.lang.Class mComponentClass
Constructor Detail |
protected ApplicationModuleDefImpl()
Method Detail |
public static ApplicationModuleDefImpl findDefObjectNoSub(java.lang.String name)
findDefObject
, except that it does not observe meta-object substitution.name
- The fully qualified name of the ApplicationModuleDefImpl.MetaObjectManager
public static ApplicationModuleDefImpl findDefObject(java.lang.String name)
name
- The fully qualified name of the ApplicationModuleDefImpl.MetaObjectManager
public java.lang.Class getComponentClass()
Gets this instance's class.
getComponentClass
in class oracle.jbo.server.DefObject
public java.lang.String getServerClassName(java.lang.String platform)
Returns the server class name of the remote server.
platform
- the platform to which the Application Module was deployed.public java.lang.String getClientProxyClassName(java.lang.String platform)
Returns the proxy class name of the remote server.
platform
- the platform to which the Application Module was deployed.public boolean isClearCacheOnCommit()
After the transaction is committed, the value of this flag is used to determine whether the Entity Object caches are cleared or not. If this flag value is false
, the cache contents are kept. In this case, the cache may contain data that is stale in that it does not match the newest data (changes made by another user and committed).
If this flag is true
, the caches are cleared after the transaction is committed. When the user brings in data by traversing row collection, the latest data from the database will be brought into Entity caches.
RowSet.executeQuery()
, #setClearCacheOnCommit(boolean val)
, Transaction.isClearCacheOnCommit()
, Transaction.setClearCacheOnCommit(boolean val)
public boolean isClearCacheOnRollback()
After the transaction is rolled back, the value of this flag is used to determine whether the Entity Object caches are cleared or not. If this flag value is false
, the cache contents are kept. In this case, the cache may contain data that is not in sync with database in that uncommitted changes made this by user (before the transaction was rolled back) will be kept.
If this flag is true
, the caches are cleared after the transaction is rolled back. When the user brings in data by traversing row collection, the latest data from the database will be brought into Entity caches.
RowSet.executeQuery()
, #setClearCacheOnRollback(boolean val)
, Transaction.setClearCacheOnRollback(boolean val)
, Transaction.isClearCacheOnRollback()
public boolean isRequeryOnCommit()
If this method returns true, then after a database commit, all View Objects contained by this Application Module will be marked as needing to be executed. Any attempt to retrieve rows from these View Objects or their row sets/row set iterators will cause the query to be re-executed.
protected static ApplicationModuleDefImpl loadFromXML(oracle.jbo.mom.xml.DefElementImpl xmlElement)
Loads the XML for the top-level Application Module and creates an instance of ApplicatioModuleDef for it. This function then recursively traverses all of the containee objects in the top-level Applicaton Module and creates Def objects for them.
This function is almost pivotal from runtime's functional point of view.
xmlElement
- the XMLStream for Business Components for Java Framework.protected static ApplicationModuleDefImpl loadFromXML(oracle.jbo.mom.xml.DefElementImpl xmlElement, ApplicationModuleDefImpl aInfo)
Loads the data from the XML stream. The method calls the MetaObjectManager to create an instance of the specific type of object and adds it to the hashtables that cache all the containees of the Application Module. The containees can be View Objects, View Links and Application Modules. The XMLStream is thus traversed to get the corresponding information about each of the possible children for an ApplicationModule, create these objects and add them to the cache.
aInfo
- instance of the ApplicationModuleDef.public void loadContainees()
Loads all components (View Objects, View Links, and Application Modules) into this Application Module.
The function loops through the list of View Object, View Link and Application Module names and loads the corresponding objects from a static list of metaobjects maintained by the MetaObjectManager. Since these objects are already created and stored for use in the cache, the retrieval is fast and efficient.
public oracle.jbo.server.PackageDefImpl getPackageDef()
public java.lang.String getPackageName()
protected void setName(java.lang.String name)
setName
in class oracle.jbo.mom.DefinitionObject
name
- the name to be given to this object.public oracle.jbo.mom.DefinitionObject getBaseDefObject()
getBaseDefObject
in class oracle.jbo.mom.DefinitionObject
protected void setBaseDefObject(oracle.jbo.mom.DefinitionObject baseDefObject)
setBaseDefObject
in class oracle.jbo.mom.DefinitionObject
protected void resolveReferences()
resolveReferences
in class oracle.jbo.mom.DefinitionObject
protected void finishedLoading()
finishedLoading
in class oracle.jbo.mom.DefinitionObject
protected void setParent(NamedObjectImpl parent)
setParent
in class oracle.jbo.mom.DefinitionObject
parent
- the named object that is to be the parent of this object.protected void loadProperties(oracle.jbo.mom.xml.DefElementImpl xmlElement)
loadProperties
in class oracle.jbo.mom.DefinitionObject
|
Oracle9i Business Components for Java API Reference Oracle9i Jdeveloper (9.0.4) B10391-01 | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright © 1997, 2003, Oracle. All rights reserved.