Skip navigation links

Oracle Fusion Middleware Java API Reference for Oracle ADF Model
11g Release 1 (11.1.1.9.0)

E52932-01


oracle.jbo.mom
Class DefinitionManager

java.lang.Object
  extended by oracle.jbo.mom.DefinitionManager

All Implemented Interfaces:
MetaObjectBase
Direct Known Subclasses:
JUMetaObjectManager, MetaObjectManager

public abstract class DefinitionManager
extends java.lang.Object
implements MetaObjectBase

A static class used for accessing meta-objects.

This class contains references to all Business Componenents for Java meta-objects. These classes are loaded from XML through JNDI calls to the appropriate context, and are also loaded at runtime from jboserver.properties.

Since:
Jdeveloper 3.0

Field Summary
protected  javax.naming.Context mContext
          Handle to the Context initialized for the framework

 

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_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

 

Constructor Summary
protected DefinitionManager()
           

 

Method Summary
protected  boolean addPersDefName(java.lang.Class defClass, java.lang.String fullName)
           
 void checkDefinitionUpdated(PersistableDefObject def)
           
protected abstract  ContainerDefImpl createContainerDefObject(boolean topLevel)
           
 PersistableDefObject createFromXML(int defScope, java.lang.String fullName, java.lang.String metaObjectName, DefElement elem)
          Deprecated.  
protected  PersistableDefObject createFromXMLWithStaticDef(int defScope, java.lang.String fullName, java.lang.String metaObjectName, DefElement elem, DefinitionObject staticDef)
          Deprecated.  
protected  PersistableDefObject createFromXMLWithStaticDef(int defScope, java.lang.String fullName, java.lang.String metaObjectName, DefElement elem, DefinitionObject staticDef, boolean forEditOrig)
           
 void deleteCustomizations(DefinitionObject def)
          Removes any MDS customizations made to the definition object.
 void dumpDefObjInfo(int index, java.lang.Object key, DefinitionObjectInfo defObjInfo, boolean forUseChain, java.io.PrintWriter out)
           
 void dumpMOM()
           
 void dumpMOM(java.io.Writer out, boolean dumpUseChain)
          See DefinitionContext.dumpMOM(java.io.Writer, boolean).
 java.lang.Class findClassForTagName(java.lang.String tagName)
          Deprecated.  
protected  ContainerDefImpl findContainer(java.lang.String packageName)
           
 java.lang.Object findDefinitionObject(java.lang.String metaObjectName, int exId, java.lang.Class claz, boolean sub)
          Finds the Meta Object from the statically maintained list of Meta Objects.
 java.lang.Object findDefinitionObject(java.lang.String metaObjectName, int exId, java.lang.Class claz, boolean sub, boolean loadDefIfNotFound)
          Finds the Meta Object from the statically maintained list of Meta Objects.
 java.lang.Object findDefinitionObject(java.lang.String metaObjectName, int exId, java.lang.Class claz, boolean sub, boolean loadDefIfNotFound, boolean bDisableNameChecking)
          Finds the Meta Object from the statically maintained list of Meta Objects.
 java.lang.Object findDefinitionObjectDontCheckName(java.lang.String metaObjectName, int exId, java.lang.Class claz, boolean sub)
          Finds the Meta Object from the statically maintained list of Meta Objects.
 java.lang.Object findDefObjectUsingMetadataObject(java.lang.String metaObjectName, int exId, java.lang.Class claz)
           
 java.lang.Object findDefObjectUsingMetadataObject(java.lang.String metaObjectName, int exId, java.lang.Class claz, java.lang.String fileExtension)
           
 java.lang.Object findLoadedObject(java.lang.String defObjName)
          See DefinitionContext.findDefObj(java.lang.String).
 java.lang.Object findLoadedSessionObject(java.lang.String defObjName)
           
 java.lang.Object findLoadedSiteObject(java.lang.String defObjName)
           
 java.lang.Object findMetadataObject(java.lang.String metaObjectName)
          Get the Metadata Object
 java.lang.Object findPersDefObject(java.lang.String metaObjectName, int exId, java.lang.Class claz, boolean sub)
           
 java.lang.Object findPersDefObject(java.lang.String metaObjectName, int exId, java.lang.Class claz, boolean sub, boolean noUpdateCheck)
           
 java.lang.Object findPersDefObjectWithPersDefName(java.lang.String metaObjectName, java.lang.String persDefName, DefinitionObject staticDef, int exId, java.lang.Class claz, boolean sub)
           
 java.lang.Object findSessionDefObject(java.lang.String metaObjectName, int exId, java.lang.Class claz, boolean sub)
           
 java.lang.Object findSiteDefObject(java.lang.String metaObjectName, int exId, java.lang.Class claz, boolean sub)
           
 java.lang.String findSubstituteName(java.lang.String metaObjectName)
           
 java.lang.String[] getAllDefinitionNames(java.lang.Class defClass)
           
protected  boolean getBooleanFlag(PropertyMetadata prop, boolean deflt)
           
 javax.naming.Context getContext()
          Gets the context, an instance of the context factory.
protected  java.util.Map getCurrentApplicationMap(boolean create)
          Deprecated. since 10.1.3. No direct replacement (but see comments above).
 java.util.Set<java.lang.String> getCustomizeableViewObjectNames()
          Returns the list of view object full names for view objects marked for display on the business editor.
protected  java.util.HashMap getDefinitionObjectsMap()
          Deprecated. since 9.0.5. No direct replacement (but see comments for getCurrentApplicationMap(boolean)).
protected abstract  java.lang.String getDefName()
           
protected  ContainerDefImpl getDynamicObjectsContainer()
           
protected  ContainerDefImpl getDynamicObjectsContainer(boolean doCreate)
          Returns the package that manages dynamically created definition objects.
protected abstract  java.lang.String getDynamicPackageName()
           
 DTD getJboDTD()
          Gets the cached DTD.
 DefXMLParser getJboXMLDoc()
          Deprecated. since 10.1.3. See comments above.
protected  java.lang.String getLatestDTDVersion()
           
 boolean getLazyLoadProp()
          Function to set the lazy load property
 java.lang.Object getMapLock()
          Deprecated. use lockDefinitionContext(java.lang.String) instead
 java.util.Properties getMOMProperties()
          Gets the server properties loaded from oracle.jbo.server.jboserver.properties.
protected  java.util.Map getObjectManagerDef()
           
 java.lang.String getPersDefObjectName(java.lang.String metaObjectName)
           
protected  ContainerDefImpl getProjectDef()
           
protected abstract  java.lang.String getProjectFileExtension()
           
 java.lang.String getSessionDefBaseDir()
           
static java.lang.String getSessionDefBasePackage()
           
static java.util.List getSessionDefPackages()
           
 int getSessPersDefObjCount()
           
 java.lang.String getSiteDefBaseDir()
           
static java.lang.String getSiteDefBasePackage()
           
static java.util.List getSiteDefPackages()
           
 LongRunningStatementMonitor getStatementMonitor()
          Return the LongRunningStatementMonitor that can monitor and terminate long running SQL statements.
 java.lang.String[] getSubstitutedNames(java.lang.String metaObjectName, boolean recurse)
           
 ValidatorFactory getValidatorFactory(java.lang.String nameSpace)
           
abstract  java.lang.String[] getXMLVersionArray()
           
 boolean hasDefinitionBeenUpdated(DefinitionObject def)
          figures out if the defintion object has been updated since it was read into the DefinitionManager cache.
 boolean hasDefinitionBeenUpdated(oracle.mds.core.MDSSession mdsSession, oracle.mds.core.MOKey mdsKey, java.lang.String defFullName)
           
protected  void initListener()
           
protected  void initManager()
           
protected  void initObjectManagerDef()
           
protected  void initSubExtendsPropForProject()
          Set the substitute extends prop for Project
protected  void insertDefinition(java.lang.String defObjName, java.lang.Object defObj)
           
protected  void insertDefinition(java.lang.String defObjName, java.lang.Object defObj, boolean isAgeable)
          See DefinitionContext.insertDefObj(java.lang.String, java.lang.Object, boolean).
protected  void insertPersDefObject(java.lang.String defObjName, java.lang.Object defObj, boolean isAgeable)
           
protected  void insertSessionDefObject(java.lang.String defObjName, java.lang.Object defObj, boolean isAgeable)
           
protected  void insertSiteDefObject(java.lang.String defObjName, java.lang.Object defObj, boolean isAgeable)
           
 boolean is323Compatible()
           
 boolean is903Compatible()
           
 boolean isDupBaseDef()
           
protected  boolean isLazyLoadingInDefMap()
           
 boolean isLazyLoadingMode()
          Gets the value of the JSP lazy loading flag.
 boolean isNameForSessionDef(java.lang.String name)
           
 boolean isNameForSiteDef(java.lang.String name)
           
 boolean isPersDefSupported()
           
 boolean isSessionDefSupported()
           
protected  boolean isSubstituteStat()
           
protected  boolean isValidateName()
           
 DefElement loadBaseXMLElement(java.lang.String metaObjectName)
          Function gets called for extends case where the superclass needs to be loaded.
 DefElement loadBaseXMLElement(java.lang.String metaObjectName, int defScope)
          Function gets called for extends case where the superclass needs to be loaded.
 void loadContext(java.lang.String cusContextFactory, java.lang.String initContext)
          Allows the application to change the context factory and default context at runtime.
 DefElement loadDefElement(java.lang.String metaObjectName)
           
protected  java.lang.Object loadDefinitionObjectWithoutCaching(java.lang.String metaObjectName)
          Main function in MOM to load a object from XMLStream through XMLContext
protected abstract  DefinitionObject loadFromXML(java.lang.String metaObjectName, DefElement elem, java.lang.String objType)
          Loads the XML metadata stream and returns a Def Object
protected  java.lang.Object loadLazyDefinitionObject(java.lang.String metaObjectName, ContainerDefImpl parent, boolean loadParent, boolean sub)
          Main function in MOM to load a object from XMLStream through XMLContext
protected abstract  java.lang.Object loadLazyFromSharedObject(java.lang.String metaObjectName, ContainerDefImpl parent, boolean loadParent, boolean sub)
           
 ContainerDefImpl loadProjectDefinition()
           
protected  ContainerDefImpl loadProjectDefinition(java.io.InputStream is, java.lang.String metaObjectName)
          Deprecated. since 10.1.3. Use loadProjectDefinition(String) instead.
protected  ContainerDefImpl loadProjectDefinition(java.io.Reader reader, java.lang.String metaObjectName)
          Deprecated. since 10.1.3. Use loadProjectDefinition(String) instead.
 ContainerDefImpl loadProjectDefinition(java.lang.String projectName)
          Finds the named package definition from the MOM cache.
protected abstract  java.lang.Object loadSpecialObjects(DefElement impl, java.lang.String metaObjectName, java.lang.String objType)
           
 PersistableDefObject loadTipPersistableDefObject(PersistableDefObject def)
           
 void lockDefinitionContext(java.lang.String scope)
          Locks the specified definition context.
 void registerClassForTagName(java.lang.String tagName, java.lang.Class cls)
          Deprecated.  
static boolean registerPagedefsInSessionContext()
           
 void registerValidatorFactory(java.lang.String nameSpace, ValidatorFactory valFac)
           
 void removeAllDefinitions()
          Purges the MOM cache for the current thread (which may or may not be shared with other threads, depending upon the scope of the MOM cache).
 void removeAllSessionDefinitions()
           
 java.lang.Object removeDefinition(DefinitionObject def)
          Removes the definition from the cache
protected  java.lang.Object removeDefinition(java.lang.String defObjName)
          See DefinitionContext.removeDefObj(java.lang.String).
 java.lang.Object removeDefinitionIfChanged(DefinitionObject def)
          Removed the Defintion Object from the cache if it has changed since it was read.
protected  java.lang.Object removePersDefObject(java.lang.String defObjName)
           
protected  java.lang.Object removeSessionDefObject(java.lang.String defObjName)
           
protected  java.lang.Object removeSiteDefObject(java.lang.String defObjName)
           
 void reportVMProperties()
          Diagnostic method which reports some useful VM properties throught the diagnostic stream
 boolean retireDefinitionObject(java.lang.String metaObjectName, boolean sub, boolean useSoftRef)
          Retires a definition object from the definiton manager.
 void setContextImpl(javax.naming.Context jndiContext)
          Set the JNDI context through API Call
 boolean setDefCachePolicy(int numStronglyHeld, boolean manageLRU, boolean unretireRecentlyUsed, boolean useSoftRef, int forDefScope)
           
 boolean setDefCachePolicy(java.lang.String scopeStr, oracle.adf.share.config.ADFDefCachePolicy policy)
           
protected  void setLazyLoadingInDefMap(boolean lazyLoading)
           
protected  void setLazyLoadingMode(boolean lazyLoading)
          Sets the value of the JSP lazy loading flag.
protected  void setNameCheck(boolean flag)
           
 void setSessionDefBaseDir(java.lang.String baseDir)
           
 void setSiteDefBaseDir(java.lang.String baseDir)
           
protected  void setSubstituteStat(boolean isSubstituteStat)
           
protected  void setValidateName(boolean bValidateName)
           
 void unlockDefinitionContext(java.lang.String scope)
           
 boolean unretireDefinitionObject(java.lang.String metaObjectName, boolean sub)
          Unretires a definition object from the definiton manager.
 boolean usesMDS()
          Return an indication as to whether the current application should use MDS for this DefinitionManager instance.
protected abstract  boolean usesMDSByDefault()
          Return an indication as to whether this DefinitionManager instance should use MDS if the application's adf-config.xml does not explicitly indicate true or false.

 

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

 

Field Detail

mContext

protected javax.naming.Context mContext
Handle to the Context initialized for the framework

Constructor Detail

DefinitionManager

protected DefinitionManager()

Method Detail

initListener

protected void initListener()

initManager

protected void initManager()

initObjectManagerDef

protected void initObjectManagerDef()

registerClassForTagName

public void registerClassForTagName(java.lang.String tagName,
                                    java.lang.Class cls)
Deprecated. 
Registers the class to be used as the definition object for the tag name
Parameters:
tagName -
cls -
For internal use only. Application developers should not use this
don't use

findClassForTagName

public java.lang.Class findClassForTagName(java.lang.String tagName)
Deprecated. 
Looks up the definition object class name associated with the tag
Parameters:
tagName -
Returns:
For internal use only. Application developers should not use this
don't use

registerValidatorFactory

public void registerValidatorFactory(java.lang.String nameSpace,
                                     ValidatorFactory valFac)

getValidatorFactory

public ValidatorFactory getValidatorFactory(java.lang.String nameSpace)

setNameCheck

protected void setNameCheck(boolean flag)

getDefName

protected abstract java.lang.String getDefName()

getObjectManagerDef

protected java.util.Map getObjectManagerDef()

setLazyLoadingInDefMap

protected void setLazyLoadingInDefMap(boolean lazyLoading)

isLazyLoadingInDefMap

protected boolean isLazyLoadingInDefMap()

setSubstituteStat

protected void setSubstituteStat(boolean isSubstituteStat)

isSubstituteStat

protected boolean isSubstituteStat()

setValidateName

protected void setValidateName(boolean bValidateName)

isValidateName

protected boolean isValidateName()

getJboXMLDoc

public DefXMLParser getJboXMLDoc()
Deprecated. since 10.1.3. See comments above.
Gets the XML parser. The getJboDTD method may be invoked on this parser, but not, in general, the parse or reset methods (they are not thread-safe). However, rather than invoking getJboXMLDoc().getJboDTD() to get the cached DTD, one should simply invoke getJboDTD().
Returns:
the XMLParser.

getJboDTD

public DTD getJboDTD()
Gets the cached DTD.
Returns:
the cached DTD.

setContextImpl

public void setContextImpl(javax.naming.Context jndiContext)
Set the JNDI context through API Call
Parameters:
jndiContext - Initial Context Impl

isLazyLoadingMode

public boolean isLazyLoadingMode()
Gets the value of the JSP lazy loading flag.
Returns:
the value of the lazy loading flag.

setLazyLoadingMode

protected void setLazyLoadingMode(boolean lazyLoading)
Sets the value of the JSP lazy loading flag.
Parameters:
lazyLoading - the new value of the lazy loading flag.

findContainer

protected ContainerDefImpl findContainer(java.lang.String packageName)

getAllDefinitionNames

public java.lang.String[] getAllDefinitionNames(java.lang.Class defClass)

findDefinitionObject

public java.lang.Object findDefinitionObject(java.lang.String metaObjectName,
                                             int exId,
                                             java.lang.Class claz,
                                             boolean sub)
Finds the Meta Object from the statically maintained list of Meta Objects.
Parameters:
metaObjectName - the fully qualified Name of the Meta Object.
exId - id identifying the meta-object kind.
claz - meta-object implementation class.
sub - flag controlling whether to perform meta-object substitution.
Returns:
The Meta Object. Returns null if no meta object exists.

findDefinitionObject

public java.lang.Object findDefinitionObject(java.lang.String metaObjectName,
                                             int exId,
                                             java.lang.Class claz,
                                             boolean sub,
                                             boolean loadDefIfNotFound)
Finds the Meta Object from the statically maintained list of Meta Objects.
Parameters:
metaObjectName - the fully qualified Name of the Meta Object.
exId - id identifying the meta-object kind.
claz - meta-object implementation class.
sub - flag controlling whether to perform meta-object substitution.
loadDefIfNotFound - loads metaobject from metadata store if not found.
Returns:
The Meta Object. Returns null if no meta object exists.

findDefinitionObjectDontCheckName

public java.lang.Object findDefinitionObjectDontCheckName(java.lang.String metaObjectName,
                                                          int exId,
                                                          java.lang.Class claz,
                                                          boolean sub)
Finds the Meta Object from the statically maintained list of Meta Objects. This variation will not check the identifier name
Parameters:
metaObjectName - the fully qualified Name of the Meta Object.
exId - id identifying the meta-object kind.
claz - meta-object implementation class.
sub - flag controlling whether to perform meta-object substitution.
Returns:
The Meta Object. Returns null if no meta object exists.

findDefinitionObject

public java.lang.Object findDefinitionObject(java.lang.String metaObjectName,
                                             int exId,
                                             java.lang.Class claz,
                                             boolean sub,
                                             boolean loadDefIfNotFound,
                                             boolean bDisableNameChecking)
Finds the Meta Object from the statically maintained list of Meta Objects.
Parameters:
metaObjectName - the fully qualified Name of the Meta Object.
exId - id identifying the meta-object kind.
claz - meta-object implementation class.
sub - flag controlling whether to perform meta-object substitution.
bDisableNameChecking - disables name checking regardless of the internal settings
Returns:
The Meta Object. Returns null if no meta object exists.

retireDefinitionObject

public boolean retireDefinitionObject(java.lang.String metaObjectName,
                                      boolean sub,
                                      boolean useSoftRef)
Retires a definition object from the definiton manager. After successful execution of the method, the definition object is held by the def manager either through a WeakReference or a SoftRefereence. If all strong refs to the def object is gone, the def object will be garbaged collected.

After the def object is GC'ed, if the client calls one of the findDefinitionObject() methods, the def object may be reloaded from the meta-data store.

To check if the GC collected the def object, the client may call

    Object defObj = findLoadedObject(metaObjectName);
 

If collected, the above call will return null.

Parameters:
metaObjectName - the full name of the meta-object as registered with the definition manager.
sub - a boolean flag indicating whether meta-object substitution should be applied.
useSoftRef - a boolean flag indicating whether to use SoftReference or WeakRefereence</code). If true, SoftReference is used.
Returns:
true if the def object was found and the ref to the def successfully turned into Soft/WeakReference. false if the def object was not found, or if the def object was already retired, or if the definition context does not support retiring of def objects.

unretireDefinitionObject

public boolean unretireDefinitionObject(java.lang.String metaObjectName,
                                        boolean sub)
Unretires a definition object from the definiton manager. If the def object was being held with Soft/WeakReference, it is changed into a direct reference to the def object.
Parameters:
metaObjectName - the full name of the meta-object as registered with the definition manager.
sub - a boolean flag indicating whether meta-object substitution should be applied.
Returns:
true if the def object was found and the ref to the def successfully turned into direct/strong refereence. false if the def object was not found, or if the def object was not retired, or if the def object was GC'ed, or if the definition context does not support retiring of def objects.

setDefCachePolicy

public boolean setDefCachePolicy(java.lang.String scopeStr,
                                 oracle.adf.share.config.ADFDefCachePolicy policy)

setDefCachePolicy

public boolean setDefCachePolicy(int numStronglyHeld,
                                 boolean manageLRU,
                                 boolean unretireRecentlyUsed,
                                 boolean useSoftRef,
                                 int forDefScope)

isPersDefSupported

public boolean isPersDefSupported()

isSessionDefSupported

public boolean isSessionDefSupported()

getPersDefObjectName

public java.lang.String getPersDefObjectName(java.lang.String metaObjectName)

findPersDefObjectWithPersDefName

public java.lang.Object findPersDefObjectWithPersDefName(java.lang.String metaObjectName,
                                                         java.lang.String persDefName,
                                                         DefinitionObject staticDef,
                                                         int exId,
                                                         java.lang.Class claz,
                                                         boolean sub)

findPersDefObject

public java.lang.Object findPersDefObject(java.lang.String metaObjectName,
                                          int exId,
                                          java.lang.Class claz,
                                          boolean sub)

findPersDefObject

public java.lang.Object findPersDefObject(java.lang.String metaObjectName,
                                          int exId,
                                          java.lang.Class claz,
                                          boolean sub,
                                          boolean noUpdateCheck)

findSiteDefObject

public java.lang.Object findSiteDefObject(java.lang.String metaObjectName,
                                          int exId,
                                          java.lang.Class claz,
                                          boolean sub)

findSessionDefObject

public java.lang.Object findSessionDefObject(java.lang.String metaObjectName,
                                             int exId,
                                             java.lang.Class claz,
                                             boolean sub)

getSessPersDefObjCount

public int getSessPersDefObjCount()

hasDefinitionBeenUpdated

public boolean hasDefinitionBeenUpdated(DefinitionObject def)
figures out if the defintion object has been updated since it was read into the DefinitionManager cache.
Parameters:
def -
Returns:
true if object has changed since it was read

hasDefinitionBeenUpdated

public boolean hasDefinitionBeenUpdated(oracle.mds.core.MDSSession mdsSession,
                                        oracle.mds.core.MOKey mdsKey,
                                        java.lang.String defFullName)

loadTipPersistableDefObject

public PersistableDefObject loadTipPersistableDefObject(PersistableDefObject def)

checkDefinitionUpdated

public void checkDefinitionUpdated(PersistableDefObject def)

removeDefinitionIfChanged

public java.lang.Object removeDefinitionIfChanged(DefinitionObject def)
Removed the Defintion Object from the cache if it has changed since it was read.
Parameters:
def -
Returns:
the object that was removed, or null if none was removed.

deleteCustomizations

public void deleteCustomizations(DefinitionObject def)
                          throws oracle.mds.exception.UnsupportedUpdateException
Removes any MDS customizations made to the definition object.
Parameters:
def -
Throws:
oracle.mds.exception.UnsupportedUpdateException

removeDefinition

public java.lang.Object removeDefinition(DefinitionObject def)
Removes the definition from the cache
Parameters:
def -
Returns:
the removed object

getSubstitutedNames

public java.lang.String[] getSubstitutedNames(java.lang.String metaObjectName,
                                              boolean recurse)

findSubstituteName

public java.lang.String findSubstituteName(java.lang.String metaObjectName)

loadSpecialObjects

protected abstract java.lang.Object loadSpecialObjects(DefElement impl,
                                                       java.lang.String metaObjectName,
                                                       java.lang.String objType)

loadLazyFromSharedObject

protected abstract java.lang.Object loadLazyFromSharedObject(java.lang.String metaObjectName,
                                                             ContainerDefImpl parent,
                                                             boolean loadParent,
                                                             boolean sub)

loadLazyDefinitionObject

protected java.lang.Object loadLazyDefinitionObject(java.lang.String metaObjectName,
                                                    ContainerDefImpl parent,
                                                    boolean loadParent,
                                                    boolean sub)
Main function in MOM to load a object from XMLStream through XMLContext

loadDefinitionObjectWithoutCaching

protected java.lang.Object loadDefinitionObjectWithoutCaching(java.lang.String metaObjectName)
Main function in MOM to load a object from XMLStream through XMLContext

loadDefElement

public DefElement loadDefElement(java.lang.String metaObjectName)

loadFromXML

protected abstract DefinitionObject loadFromXML(java.lang.String metaObjectName,
                                                DefElement elem,
                                                java.lang.String objType)
Loads the XML metadata stream and returns a Def Object
Parameters:
metaObjectName - name of the metaobject, for diagnostic purposes.
elem - an XML Stream as a DefElement object.
objType - object type Tag.
Returns:
a defObject, which is a JBO Object extending DefinitionObject

getDynamicObjectsContainer

protected ContainerDefImpl getDynamicObjectsContainer()

getDynamicObjectsContainer

protected ContainerDefImpl getDynamicObjectsContainer(boolean doCreate)
Returns the package that manages dynamically created definition objects. If it doesn't exist, it creates one.
Returns:
the package for dynamically created def objects.

getDynamicPackageName

protected abstract java.lang.String getDynamicPackageName()

getProjectFileExtension

protected abstract java.lang.String getProjectFileExtension()

createContainerDefObject

protected abstract ContainerDefImpl createContainerDefObject(boolean topLevel)

loadProjectDefinition

protected ContainerDefImpl loadProjectDefinition(java.io.InputStream is,
                                                 java.lang.String metaObjectName)
Deprecated. since 10.1.3. Use loadProjectDefinition(String) instead.

loadProjectDefinition

protected ContainerDefImpl loadProjectDefinition(java.io.Reader reader,
                                                 java.lang.String metaObjectName)
Deprecated. since 10.1.3. Use loadProjectDefinition(String) instead.

loadProjectDefinition

public ContainerDefImpl loadProjectDefinition(java.lang.String projectName)
Finds the named package definition from the MOM cache. Loads it from the metadata store if necessary. The project definition contains metaobject subsitution list among other things.
Parameters:
projectName - the fully-qualified name of the package.
Returns:
the named package, or null if no package exists.

loadProjectDefinition

public ContainerDefImpl loadProjectDefinition()

initSubExtendsPropForProject

protected void initSubExtendsPropForProject()
Set the substitute extends prop for Project

Finds if there is a subtitute extends tag and sets the right flag, finally makes a top level call to loadProject() Function first checks in Command line argument then in the file jboserver.properties only if this is missing in command line argument


getProjectDef

protected ContainerDefImpl getProjectDef()

is323Compatible

public boolean is323Compatible()

is903Compatible

public boolean is903Compatible()

isDupBaseDef

public boolean isDupBaseDef()

getBooleanFlag

protected boolean getBooleanFlag(PropertyMetadata prop,
                                 boolean deflt)

getLazyLoadProp

public boolean getLazyLoadProp()
Function to set the lazy load property

loadContext

public void loadContext(java.lang.String cusContextFactory,
                        java.lang.String initContext)
Allows the application to change the context factory and default context at runtime.
Parameters:
cusContextFactory - the name of the new custom context factory. if null the default is restored.
initContext - the name of the new default context. if null the default is restored.

getContext

public javax.naming.Context getContext()
Gets the context, an instance of the context factory. Applications can use the context to specify their own bindings for business meta-objects, and can fetch these objects from the context.
Returns:
the context.

getMOMProperties

public java.util.Properties getMOMProperties()
Gets the server properties loaded from oracle.jbo.server.jboserver.properties.
Returns:
the server properties.

loadBaseXMLElement

public DefElement loadBaseXMLElement(java.lang.String metaObjectName)
Function gets called for extends case where the superclass needs to be loaded.
Parameters:
metaObjectName -
Returns:
JBOElementImpl

loadBaseXMLElement

public DefElement loadBaseXMLElement(java.lang.String metaObjectName,
                                     int defScope)
Function gets called for extends case where the superclass needs to be loaded.
Parameters:
metaObjectName -
defScope -
Returns:
JBOElementImpl

reportVMProperties

public void reportVMProperties()
Diagnostic method which reports some useful VM properties throught the diagnostic stream

getXMLVersionArray

public abstract java.lang.String[] getXMLVersionArray()

getLatestDTDVersion

protected java.lang.String getLatestDTDVersion()

dumpDefObjInfo

public void dumpDefObjInfo(int index,
                           java.lang.Object key,
                           DefinitionObjectInfo defObjInfo,
                           boolean forUseChain,
                           java.io.PrintWriter out)

dumpMOM

public void dumpMOM(java.io.Writer out,
                    boolean dumpUseChain)
See DefinitionContext.dumpMOM(java.io.Writer, boolean).

dumpMOM

public void dumpMOM()

insertDefinition

protected void insertDefinition(java.lang.String defObjName,
                                java.lang.Object defObj,
                                boolean isAgeable)
See DefinitionContext.insertDefObj(java.lang.String, java.lang.Object, boolean).

insertDefinition

protected void insertDefinition(java.lang.String defObjName,
                                java.lang.Object defObj)

removeDefinition

protected java.lang.Object removeDefinition(java.lang.String defObjName)
See DefinitionContext.removeDefObj(java.lang.String).

isNameForSiteDef

public boolean isNameForSiteDef(java.lang.String name)

getSiteDefPackages

public static java.util.List getSiteDefPackages()

getSiteDefBasePackage

public static java.lang.String getSiteDefBasePackage()

getSiteDefBaseDir

public java.lang.String getSiteDefBaseDir()

setSiteDefBaseDir

public void setSiteDefBaseDir(java.lang.String baseDir)

isNameForSessionDef

public boolean isNameForSessionDef(java.lang.String name)

getSessionDefPackages

public static java.util.List getSessionDefPackages()

getSessionDefBasePackage

public static java.lang.String getSessionDefBasePackage()

getSessionDefBaseDir

public java.lang.String getSessionDefBaseDir()

setSessionDefBaseDir

public void setSessionDefBaseDir(java.lang.String baseDir)

addPersDefName

protected boolean addPersDefName(java.lang.Class defClass,
                                 java.lang.String fullName)

insertPersDefObject

protected void insertPersDefObject(java.lang.String defObjName,
                                   java.lang.Object defObj,
                                   boolean isAgeable)

insertSiteDefObject

protected void insertSiteDefObject(java.lang.String defObjName,
                                   java.lang.Object defObj,
                                   boolean isAgeable)

insertSessionDefObject

protected void insertSessionDefObject(java.lang.String defObjName,
                                      java.lang.Object defObj,
                                      boolean isAgeable)

removePersDefObject

protected java.lang.Object removePersDefObject(java.lang.String defObjName)

removeSiteDefObject

protected java.lang.Object removeSiteDefObject(java.lang.String defObjName)

removeSessionDefObject

protected java.lang.Object removeSessionDefObject(java.lang.String defObjName)

findLoadedObject

public java.lang.Object findLoadedObject(java.lang.String defObjName)
See DefinitionContext.findDefObj(java.lang.String).

findLoadedSiteObject

public java.lang.Object findLoadedSiteObject(java.lang.String defObjName)

findLoadedSessionObject

public java.lang.Object findLoadedSessionObject(java.lang.String defObjName)

removeAllDefinitions

public void removeAllDefinitions()
Purges the MOM cache for the current thread (which may or may not be shared with other threads, depending upon the scope of the MOM cache).

removeAllSessionDefinitions

public void removeAllSessionDefinitions()

getMapLock

public java.lang.Object getMapLock()
Deprecated. use lockDefinitionContext(java.lang.String) instead

getCurrentApplicationMap

protected java.util.Map getCurrentApplicationMap(boolean create)
Deprecated. since 10.1.3. No direct replacement (but see comments above).
In releases prior to 10.1.3, the map returned by this method was sometimes used as a proxy for the MOM cache. That usage is no longer supported. External clients that were issueing get, put, and remove on the returned Map should instead invoke the findLoadedObject, insertDefinition, and removeDefinition methods directly.
Parameters:
create - Create map if not found?
Returns:
the synchronized name-to-metaobject map for the current application. This won't have the same semantics as in prior releases (because the map values may be DefinitionObjectInfo objects rather than DefinitionObject objects). In future releases, this method may raise an exception.

getDefinitionObjectsMap

protected java.util.HashMap getDefinitionObjectsMap()
Deprecated. since 9.0.5. No direct replacement (but see comments for getCurrentApplicationMap(boolean)).

usesMDSByDefault

protected abstract boolean usesMDSByDefault()
Return an indication as to whether this DefinitionManager instance should use MDS if the application's adf-config.xml does not explicitly indicate true or false. This default value is obtained from a JVM-wide BC4J property. (Actually, that's not currently true for JUMetaObjectManager - see comments in JUMetaObjectManager.usesMDSByDefault()).
Returns:
Should we use MDS for applications that don't specify that info in the app's adf-config.xml?

usesMDS

public boolean usesMDS()
Return an indication as to whether the current application should use MDS for this DefinitionManager instance.
Returns:
Should we use MDS for the current application?

getStatementMonitor

public LongRunningStatementMonitor getStatementMonitor()
Return the LongRunningStatementMonitor that can monitor and terminate long running SQL statements. The monitor runs in its own thread.
Returns:
The LongRunningStatementMonitor instance.

findDefObjectUsingMetadataObject

public java.lang.Object findDefObjectUsingMetadataObject(java.lang.String metaObjectName,
                                                         int exId,
                                                         java.lang.Class claz,
                                                         java.lang.String fileExtension)

findDefObjectUsingMetadataObject

public java.lang.Object findDefObjectUsingMetadataObject(java.lang.String metaObjectName,
                                                         int exId,
                                                         java.lang.Class claz)

findMetadataObject

public java.lang.Object findMetadataObject(java.lang.String metaObjectName)
Get the Metadata Object
Parameters:
metaObjectName -
Returns:
The MetadataObject. If not found, returns null.

getCustomizeableViewObjectNames

public java.util.Set<java.lang.String> getCustomizeableViewObjectNames()
Returns the list of view object full names for view objects marked for display on the business editor.

createFromXML

public PersistableDefObject createFromXML(int defScope,
                                          java.lang.String fullName,
                                          java.lang.String metaObjectName,
                                          DefElement elem)
Deprecated. 
Parameters:
defScope -
fullName -
metaObjectName -
elem -
Returns:
For internal use only. Application developers should not use this
don't use

createFromXMLWithStaticDef

protected PersistableDefObject createFromXMLWithStaticDef(int defScope,
                                                          java.lang.String fullName,
                                                          java.lang.String metaObjectName,
                                                          DefElement elem,
                                                          DefinitionObject staticDef)
Deprecated. 
Parameters:
defScope -
fullName -
metaObjectName -
elem -
Returns:
For internal use only. Application developers should not use this
don't use

createFromXMLWithStaticDef

protected PersistableDefObject createFromXMLWithStaticDef(int defScope,
                                                          java.lang.String fullName,
                                                          java.lang.String metaObjectName,
                                                          DefElement elem,
                                                          DefinitionObject staticDef,
                                                          boolean forEditOrig)

registerPagedefsInSessionContext

public static boolean registerPagedefsInSessionContext()

lockDefinitionContext

public void lockDefinitionContext(java.lang.String scope)
Locks the specified definition context. All calls must be bracketed with an #unlockDefiniitonContext
Parameters:
a - ADFDefCachePolicy value. If none is specfied assume ADFDefCachePolicy.DEF_SCOPE_STR_SHARED
For internal use only. Application developers should not use this

unlockDefinitionContext

public void unlockDefinitionContext(java.lang.String scope)
Parameters:
a - ADFDefCachePolicy value. If none is specfied assume ADFDefCachePolicy.DEF_SCOPE_STR_SHARED
For internal use only. Application developers should not use this

Skip navigation links

Oracle Fusion Middleware Java API Reference for Oracle ADF Model
11g Release 1 (11.1.1.9.0)

E52932-01


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