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

E10653-07

oracle.jbo.server
Class MetaObjectManager

java.lang.Object
  extended by oracle.jbo.mom.DefinitionManager
      extended by oracle.jbo.server.MetaObjectManager
All Implemented Interfaces:
MetaObjectBase
Direct Known Subclasses:
ContextMetaObjectManager

public class MetaObjectManager
extends DefinitionManager

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
 
Fields inherited from class oracle.jbo.mom.DefinitionManager
mbValidateName, mContext, mLazyLoading, mSubstituteStat
 
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_OPERATION, 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_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_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
 
Method Summary
protected  ContainerDefImpl createContainerDefObject(boolean topLevel)
           
static void createSharedDataHandle()
           
static ApplicationModule findApplicationModule(java.lang.String name, ApplicationModuleImpl am)
          Finds the application module instance
 java.util.ArrayList findBusLogicUnitNames(java.lang.String name)
          Gets the full names of all the business logic units defined.
static java.lang.Object findMetaObject(java.lang.String metaObjectName, int exId, java.lang.Class claz, boolean sub)
           
static java.lang.Object findPersMetaObject(java.lang.String metaObjectName, int exId, java.lang.Class claz, boolean sub)
           
static java.lang.Object findSessionMetaObject(java.lang.String metaObjectName, int exId, java.lang.Class claz, boolean sub)
           
 java.lang.String findViewDefNameForProgrammaticUseByShortName(java.lang.String shortName)
          Deprecated.  
 java.util.ArrayList findViewLogicUnitNames(java.lang.String name)
          Gets the full names of all the view logic units defined.
static java.lang.String[] getAllMetaNames(java.lang.Class defClass)
           
 java.util.ArrayList getCustomMessageBundlesList()
           
protected  java.lang.String getDynamicPackageName()
           
 java.util.Iterator<java.lang.String> getEditableGlobalFunctionResourcesIterator()
          Deprecated.  
 java.util.List<java.lang.String> getExportIntfSubPackageNames()
          Gets the set of relative packages for exported interfaces as defined in the .jpx files from the classpath.
 java.util.Iterator getImmutableGlobalFunctionResourcesIterator()
          Deprecated.  
static java.lang.String getLatestXMLVersion()
           
static DefXMLParser getParser()
          Deprecated. since 10.1.3. See DefinitionManager.getJboXMLDoc().
protected  ContainerDefImpl getProjectDef()
           
protected  java.lang.String getProjectFileExtension()
           
static java.util.Properties getServerProperties()
          Gets the server properties loaded from oracle.jbo.server.jboserver.properties.
static SharedHandle getSharedHandle()
          Get the Shared Handle
static java.lang.String getSharedHandleName()
          Get the Shared handle name
static boolean getSharedHandleStatus()
          Get the Shared Handle Status
static MetaObjectManager getSingleton()
           
 ValidatorFactory getValidatorFactory(java.lang.String nameSpace)
           
 java.lang.Long getVersionTimestamp()
           
 java.lang.String[] getXMLVersionArray()
           
protected  void initManager()
           
protected  void initSubExtendsPropForProject()
          Set the substitute extends prop for Project For 8i, we treat it differently than other deployments
static void insertMetaObject(java.lang.String metaObjectName, java.lang.Object metaObject)
          Inserts the metaobject into the MOM cache.
static void insertPersMetaObject(java.lang.String metaObjectName, java.lang.Object metaObject)
           
static void insertSessionMetaObject(java.lang.String metaObjectName, java.lang.Object metaObject)
           
static boolean isLazyLoading()
          Gets the value of the JSP lazy loading flag.
static DefElement loadBaseElement(java.lang.String metaObjectName)
           
static DefElement loadBaseElement(java.lang.String metaObjectName, int defScope)
           
static java.lang.Object loadFromSharedDataHandle(java.lang.String metaObjectName)
          Returns the def object from HashTable
 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 loadLazyFromSharedObject(java.lang.String metaObjectName, ContainerDefImpl parent, boolean loadParent, boolean sub)
          Main function in MOM to load a object from XMLStream through Shared MetaData
static PackageDefImpl loadProject(java.lang.String projectName)
           
protected  java.lang.Object loadSpecialObjects(DefElement elem, java.lang.String metaObjectName, java.lang.String objType)
           
static java.lang.Object loadXMLFromSharedDataHandle(java.lang.String metaObjectName)
          Returns the JBOElementImpl object from HashTable
static java.lang.Object removeMetaObject(java.lang.String metaObjectName)
          Removes the Meta Object from the statically maintained list of Meta Objects.
static java.lang.Object removePersMetaObject(java.lang.String metaObjectName)
           
static java.lang.Object removeSessionMetaObject(java.lang.String metaObjectName)
           
static void set8iProjectSub(java.lang.String projectName)
           
static void setLazyLoading(boolean lazyLoading)
          Sets the value of the JSP lazy loading flag.
static void setSharedHandleName(java.lang.String handleName)
          Set the Shared handle name, App module calls this function for the metaobjects
protected  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 oracle.jbo.mom.DefinitionManager
addPersDefName, checkDefinitionUpdated, createFromXML, deleteCustomizations, dumpDefObjInfo, dumpMOM, dumpMOM, findClassForTagName, findContainer, findDefinitionObject, findDefinitionObject, findDefinitionObject, findDefinitionObjectDontCheckName, findDefObjectUsingMetadataObject, findDefObjectUsingMetadataObject, findLoadedObject, findLoadedSessionObject, findMetadataObject, findPersDefObject, findPersDefObject, findPersDefObjectWithPersDefName, findSessionDefObject, findSubstituteName, getAllDefinitionNames, getBooleanFlag, getContext, getCurrentApplicationMap, getCustomizeableViewObjectNames, getDefinitionObjectsMap, getDynamicObjectsContainer, getJboDTD, getJboXMLDoc, getLatestDTDVersion, getLazyLoadProp, getMapLock, getMOMProperties, getPersDefObjectName, getSessionDefBaseDir, getSessionDefBasePackage, getSessionDefPackages, getSessPersDefObjCount, getStatementMonitor, getSubstitutedNames, hasDefinitionBeenUpdated, initListener, insertDefinition, insertDefinition, insertPersDefObject, insertSessionDefObject, is323Compatible, is903Compatible, isLazyLoadingMode, isNameForSessionDef, isPersDefSupported, isSessionDefSupported, loadBaseXMLElement, loadBaseXMLElement, loadContext, loadDefElement, loadDefinitionObjectWithoutCaching, loadLazyDefinitionObject, loadProjectDefinition, loadProjectDefinition, loadProjectDefinition, loadProjectDefinition, loadTipPersistableDefObject, registerClassForTagName, registerPagedefsInSessionContext, registerValidatorFactory, removeAllDefinitions, removeAllSessionDefinitions, removeDefinition, removeDefinition, removeDefinitionIfChanged, removePersDefObject, removeSessionDefObject, reportVMProperties, setContextImpl, setLazyLoadingMode, setNameCheck, setSessionDefBaseDir, usesMDS
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

getSingleton

public static MetaObjectManager getSingleton()

getParser

public static DefXMLParser getParser()
Deprecated. since 10.1.3. See DefinitionManager.getJboXMLDoc().

Gets the XML parser.

Returns:
the XMLParser.

initManager

protected void initManager()
Overrides:
initManager in class DefinitionManager

getValidatorFactory

public ValidatorFactory getValidatorFactory(java.lang.String nameSpace)
Overrides:
getValidatorFactory in class DefinitionManager

setSharedHandleName

public static void setSharedHandleName(java.lang.String handleName)
Set the Shared handle name, App module calls this function for the metaobjects


set8iProjectSub

public static void set8iProjectSub(java.lang.String projectName)

getSharedHandleName

public static java.lang.String getSharedHandleName()
Get the Shared handle name


getSharedHandleStatus

public static boolean getSharedHandleStatus()
Get the Shared Handle Status


getSharedHandle

public static SharedHandle getSharedHandle()
Get the Shared Handle


isLazyLoading

public static boolean isLazyLoading()
Gets the value of the JSP lazy loading flag.

Returns:
the value of the lazy loading flag.

setLazyLoading

public static void setLazyLoading(boolean lazyLoading)
Sets the value of the JSP lazy loading flag.

Parameters:
lazyLoading - the new value of the lazy loading flag.

insertMetaObject

public static void insertMetaObject(java.lang.String metaObjectName,
                                    java.lang.Object metaObject)
Inserts the metaobject into the MOM cache. The metaobject is marked as not ageable!

Parameters:
metaObjectName - The fully qualified Name of the metaobject
metaObject - The metaobject itself

removeMetaObject

public static java.lang.Object removeMetaObject(java.lang.String metaObjectName)
Removes the Meta Object from the statically maintained list of Meta Objects.

Parameters:
metaObjectName - The fully qualified Name of the Meta Object
Returns:
The Meta Object that is removed. Returns null if no meta object exists.

insertSessionMetaObject

public static void insertSessionMetaObject(java.lang.String metaObjectName,
                                           java.lang.Object metaObject)

insertPersMetaObject

public static void insertPersMetaObject(java.lang.String metaObjectName,
                                        java.lang.Object metaObject)

removeSessionMetaObject

public static java.lang.Object removeSessionMetaObject(java.lang.String metaObjectName)

removePersMetaObject

public static java.lang.Object removePersMetaObject(java.lang.String metaObjectName)

loadLazyFromSharedObject

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

Specified by:
loadLazyFromSharedObject in class DefinitionManager

loadFromXML

public DefinitionObject loadFromXML(java.lang.String metaObjectName,
                                    DefElement elem,
                                    java.lang.String objType)
Loads the XML metadata stream and returns a Def Object

Specified by:
loadFromXML in class DefinitionManager
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

loadProject

public static PackageDefImpl loadProject(java.lang.String projectName)

loadFromSharedDataHandle

public static java.lang.Object loadFromSharedDataHandle(java.lang.String metaObjectName)
Returns the def object from HashTable

Returns:
defObject: name of the Def Object (packagename.objName)

loadXMLFromSharedDataHandle

public static java.lang.Object loadXMLFromSharedDataHandle(java.lang.String metaObjectName)
Returns the JBOElementImpl object from HashTable

Returns:
DefElement: name of the Def Object (packagename.objName)

findSessionMetaObject

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

findPersMetaObject

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

getAllMetaNames

public static java.lang.String[] getAllMetaNames(java.lang.Class defClass)

findMetaObject

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

loadBaseElement

public static DefElement loadBaseElement(java.lang.String metaObjectName)

loadBaseElement

public static DefElement loadBaseElement(java.lang.String metaObjectName,
                                         int defScope)

initSubExtendsPropForProject

protected void initSubExtendsPropForProject()
Set the substitute extends prop for Project For 8i, we treat it differently than other deployments

Overrides:
initSubExtendsPropForProject in class DefinitionManager

getServerProperties

public static java.util.Properties getServerProperties()
Gets the server properties loaded from oracle.jbo.server.jboserver.properties.

Returns:
the server properties.

createSharedDataHandle

public static void createSharedDataHandle()
                                   throws javax.naming.NamingException
Throws:
javax.naming.NamingException

getDynamicPackageName

protected java.lang.String getDynamicPackageName()
Specified by:
getDynamicPackageName in class DefinitionManager

getProjectFileExtension

protected java.lang.String getProjectFileExtension()
Specified by:
getProjectFileExtension in class DefinitionManager

getProjectDef

protected ContainerDefImpl getProjectDef()
Overrides:
getProjectDef in class DefinitionManager

loadSpecialObjects

protected java.lang.Object loadSpecialObjects(DefElement elem,
                                              java.lang.String metaObjectName,
                                              java.lang.String objType)
Specified by:
loadSpecialObjects in class DefinitionManager

createContainerDefObject

protected ContainerDefImpl createContainerDefObject(boolean topLevel)
Specified by:
createContainerDefObject in class DefinitionManager

getXMLVersionArray

public java.lang.String[] getXMLVersionArray()
Specified by:
getXMLVersionArray in class DefinitionManager

getLatestXMLVersion

public static java.lang.String getLatestXMLVersion()

getCustomMessageBundlesList

public java.util.ArrayList getCustomMessageBundlesList()

getVersionTimestamp

public final java.lang.Long getVersionTimestamp()

usesMDSByDefault

protected boolean usesMDSByDefault()
Description copied from class: DefinitionManager
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()).

Specified by:
usesMDSByDefault in class DefinitionManager
Returns:
Should we use MDS for applications that don't specify that info in the app's adf-config.xml?

findApplicationModule

public static ApplicationModule findApplicationModule(java.lang.String name,
                                                      ApplicationModuleImpl am)
Finds the application module instance

Parameters:
name - The name of the application module instance.
am - The root application module of the current session.
Returns:
The Applcation Module with the specified instance name.

findBusLogicUnitNames

public java.util.ArrayList findBusLogicUnitNames(java.lang.String name)
Gets the full names of all the business logic units defined.

Parameters:
name - an unqualified name
Returns:
a list of qualified names, or null if the specified business logic unit is not found.

findViewLogicUnitNames

public java.util.ArrayList findViewLogicUnitNames(java.lang.String name)
Gets the full names of all the view logic units defined.

Parameters:
name - an unqualified name
Returns:
a list of qualified names, or null if the specified view logic unit is not found.

getExportIntfSubPackageNames

public java.util.List<java.lang.String> getExportIntfSubPackageNames()
Gets the set of relative packages for exported interfaces as defined in the .jpx files from the classpath.

Returns:
relative packages for exported interfaces, or null if no subpackages are defined.
See Also:
PackageDefImpl.COMMON_SUBPACKAGE

findViewDefNameForProgrammaticUseByShortName

public java.lang.String findViewDefNameForProgrammaticUseByShortName(java.lang.String shortName)
Deprecated. 

Returns the fully-qualified view def name, given the shortname passed in. The shortname will either match one of the registered (shortname,viewdef) mapping defined in one of the JPX files in the classpath, or it will be the name of a custom object from one of the custom object base packages defined in the JPX files.

Returns:
custom base object packages as defined in the .jpx files, or null if none is defined.
For internal use only. Application developers should not use this

getImmutableGlobalFunctionResourcesIterator

public java.util.Iterator getImmutableGlobalFunctionResourcesIterator()
Deprecated. 

Gets an iterator on the list of immutable global function resources as defined in the .jpx files from the classpath. Iterator of the copy-on-write arraylist is threadsafe.

Returns:
iterator on the list of immutable global function resources as defined in the .jpx files or null if none is defined.
For internal use only. Application developers should not use this

getEditableGlobalFunctionResourcesIterator

public java.util.Iterator<java.lang.String> getEditableGlobalFunctionResourcesIterator()
Deprecated. 

Gets an iterator on the list of immutable global function resources as defined in the .jpx files from the classpath. Iterator of the copy-on-write arraylist is threadsafe.

Returns:
custom base object packages as defined in the .jpx files, or null if no subpackages are defined.
For internal use only. Application developers should not use this

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

E10653-07

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