oracle.jbo.server

Class MetaObjectManager

java.lang.Object

oracle.jbo.mom.DefinitionManager

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

mContext

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

Method Summary

Methods

Modifier and Type	Method and Description
protected ContainerDefImpl	createContainerDefObject(boolean topLevel)
static void	createSharedDataHandle()
static ApplicationModule	findApplicationModule(java.lang.String name, ApplicationModuleImpl am) Finds the application module instance
AppModuleUsage	findAppModuleUsage(java.lang.String amName)
java.util.ArrayList	findBusLogicUnitNames(java.lang.String name) Gets the full names of all the business logic units defined.
AppModuleConfigImpl	findConfiguration(java.lang.String configName)
static java.lang.Object	findMetaObject(java.lang.String metaObjectName, int exId, java.lang.Class claz, boolean sub)
java.lang.String	findObjNameForDiscrValues(java.lang.String rootBaseName, java.lang.String discrVals)
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)
static java.lang.Object	findSiteMetaObject(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	getDefName()
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().
java.util.Map<java.lang.String,java.lang.String>	getProgrammaticUseViewDefMap() Deprecated.
protected ContainerDefImpl	getProjectDef()
protected java.lang.String	getProjectFileExtension()
java.util.Map<java.lang.String,java.util.List<java.lang.String>>	getSchemaRegenerationRules() Deprecated.
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 void	insertSiteMetaObject(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()
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
void	removeAllSessionDefinitions()
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 java.lang.Object	removeSiteMetaObject(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
void	unloadImportedJpxFiles()
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, createFromXMLWithStaticDef, createFromXMLWithStaticDef, deleteCustomizations, dumpDefObjInfo, dumpMOM, dumpMOM, findClassForTagName, findContainer, findDefinitionObject, findDefinitionObject, findDefinitionObject, findDefinitionObjectDontCheckName, findDefObjectUsingMetadataObject, findDefObjectUsingMetadataObject, findLoadedObject, findLoadedSessionObject, findLoadedSiteObject, findMetadataObject, findPersDefObject, findPersDefObject, findPersDefObjectWithPersDefName, findPersDefObjectWithPersDefName, findSessionDefObject, findSiteDefObject, findSubstituteName, getAllDefinitionNames, getBooleanFlag, getContext, getCurrentApplicationMap, getCustomizeableViewObjectNames, getDefinitionObjectsMap, getDynamicObjectsContainer, getDynamicObjectsContainer, getJboDTD, getJboXMLDoc, getLatestDTDVersion, getLazyLoadProp, getMapLock, getMOMProperties, getObjectManagerDef, getPersDefObjectName, getSessionDefBaseDir, getSessionDefBasePackage, getSessionDefPackages, getSessPersDefObjCount, getSiteDefBaseDir, getSiteDefBasePackage, getSiteDefPackages, getStatementMonitor, getSubstitutedNames, hasDefinitionBeenUpdated, hasDefinitionBeenUpdated, initListener, initObjectManagerDef, insertDefinition, insertDefinition, insertPersDefObject, insertSessionDefObject, insertSiteDefObject, is323Compatible, is903Compatible, isDupBaseDef, isLazyLoadingInDefMap, isLazyLoadingMode, isNameForSessionDef, isNameForSiteDef, isPersDefSupported, isSessionDefSupported, isSubstituteStat, isValidateName, loadBaseXMLElement, loadBaseXMLElement, loadContext, loadDefElement, loadDefinitionObjectWithoutCaching, loadLazyDefinitionObject, loadProjectDefinition, loadProjectDefinition, loadProjectDefinition, loadProjectDefinition, loadTipPersistableDefObject, registerClassForTagName, registerValidatorFactory, removeAllDefinitions, removeDefinition, removeDefinition, removeDefinitionIfChanged, removePersDefObject, removeSessionDefObject, removeSiteDefObject, reportVMProperties, retireDefinitionObject, setContextImpl, setDefCachePolicy, setDefCachePolicy, setLazyLoadingInDefMap, setLazyLoadingMode, setNameCheck, setSessionDefBaseDir, setSiteDefBaseDir, setSubstituteStat, setValidateName, unretireDefinitionObject, 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()

getDefName

protected java.lang.String getDefName()

Specified by:

getDefName in class DefinitionManager

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.

insertSiteMetaObject

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

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)

removeSiteMetaObject

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

removeSessionMetaObject

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

removePersMetaObject

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

removeAllSessionDefinitions

public void removeAllSessionDefinitions()

Overrides:

removeAllSessionDefinitions in class DefinitionManager

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)

loadProject

public static PackageDefImpl loadProject()

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)

findSiteMetaObject

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

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?

findObjNameForDiscrValues

public java.lang.String findObjNameForDiscrValues(java.lang.String rootBaseName,
                                         java.lang.String discrVals)

findConfiguration

public AppModuleConfigImpl findConfiguration(java.lang.String configName)

findAppModuleUsage

public AppModuleUsage findAppModuleUsage(java.lang.String amName)

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

getProgrammaticUseViewDefMap

public java.util.Map<java.lang.String,java.lang.String> getProgrammaticUseViewDefMap()

Deprecated.

Returns a map of the fully-qualified view def names 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:

map of programmatically accessible view objects (ShortName,ViewDefFullName) as defined in the .jpx files, or null if none is defined.

For internal use only. Application developers should not use this

getSchemaRegenerationRules

public java.util.Map<java.lang.String,java.util.List<java.lang.String>> getSchemaRegenerationRules()

Deprecated.

Returns a map of fully-qualified entity def names for which service view objects need schema regeneration if the primary EO is customized.

Returns:

map of primary entity defs whose customization should trigger secondary view defs exposed in services.

For internal use only. Application developers should not use this

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:

full name of programmatically accessible view object based on a shortName passed in, 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

unloadImportedJpxFiles

public void unloadImportedJpxFiles()

For internal use only. Application developers should not use this

Internal framework use only.

Advanced method: Applications should typically not use this method.

This method is invoked during Hot Deploy to clear JPX project settings stored in static variable.