oracle.jbo.uicli.mom

Class JUMetaObjectManager

java.lang.Object

oracle.jbo.mom.DefinitionManager

oracle.jbo.uicli.mom.JUMetaObjectManager

All Implemented Interfaces:

oracle.adf.share.mds.ADFSessOptsChangeListener, MetaObjectBase, JUMetaObjectBase

public class JUMetaObjectManager
extends DefinitionManager
implements JUMetaObjectBase

Field Summary

Fields

Modifier and Type	Field and Description
static JUMetaObjectManager	mom

Fields inherited from class oracle.jbo.mom.DefinitionManager

mContext

Fields inherited from interface oracle.jbo.uicli.mom.JUMetaObjectBase

TYP_APPLICATION, TYP_CONTROL_BINDING, TYP_DEF_APPLICATION, TYP_DEF_CONTROL_BINDING, TYP_DEF_DATACONTROL, TYP_DEF_DATACONTROL_CONFIG, TYP_DEF_FORM_BINDING, TYP_DEF_ITER_BINDING, TYP_DEF_SESSION, TYP_FORM_BINDING, TYP_ITER_BINDING, TYP_SESSION

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

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	JUMetaObjectManager()

Method Summary

Modifier and Type	Method and Description
void	addApplication(DCDataControl app)
JUApplicationDefImpl	createApplicationDefinition(java.lang.String name)
static JUApplication	createApplicationObject(java.lang.String qualifiedAMName)
static JUApplication	createApplicationObject(java.lang.String qualifiedAMName, java.util.Properties env)
static JUApplication	createApplicationObject(java.lang.String qualifiedAMName, java.util.Properties env, EnvInfoProvider envInfo)
protected ContainerDefImpl	createContainerDefObject(boolean topLevel)
protected PersistableDefObject	createFromXMLWithStaticDef(int defScope, java.lang.String fullName, java.lang.String metaObjectName, DefElement elem, DefinitionObject staticDef, boolean forEditOrig, boolean resolveDef) Deprecated.
static ApplicationPool	createPool(java.lang.String qualifiedAMName) Deprecated. applications should use oracle.jbo.common.ampool.PoolMgr.findPool directly or should rely upon createApplicationObject to create a pool using the fully qualified ApplicationModule definition name.
static ApplicationPool	createPool(java.lang.String qualifiedAMName, java.util.Properties env) Deprecated. applications should use oracle.jbo.common.ampool.PoolMgr.findPool directly or should rely upon createApplicationObject to create a pool using the fully qualified ApplicationModule definition name.
static JUApplication	findApplicationObject(java.lang.String qualifiedAMName)
static JUApplicationDefImpl	findCpx(java.lang.String sResource)
protected static JUApplicationDefImpl	findCpx(java.lang.String sResource, java.lang.String objExt)
BindingContext	getBindingContext()
static java.lang.String	getClientCpxName()
static java.lang.String	getClientProjectExtension()
static java.lang.String	getConfigName(java.lang.String qualifiedAMName) Returns the configuration name for a qualifiedAMName of the form <appDefName>.<sessDefName>.
DefinitionFactory	getControlDefFactory()
static java.lang.String	getCurrentlyLoadingCpx()
DefinitionFactory	getDefinitionFactory(java.lang.String sNameSpace) Returns the factory mapped to the provided namespace.
protected java.lang.String	getDefName()
protected java.lang.String	getDynamicPackageName()
protected java.util.HashMap	getFactoryMap()
static JUMetaObjectManager	getJUMom()
static DefXMLParser	getParser() Deprecated. since 10.1.3. See DefinitionManager.getJboXMLDoc().
protected java.lang.String	getProjectFileExtension()
java.lang.String[]	getXMLVersionArray()
protected void	initManager()
void	invalidateBindingContainerDef(BindingContext ctx, java.lang.String defName) Internal: Applications should not use this class.
static boolean	isStatelessApplication()
DCBindingContainerReference	loadBindingContainerRef(BindingContext ctx, org.w3c.dom.Node node)
static DCBindingContainerReference	loadBindingContainerRef(DefElement xmlElement)
static void	loadCpx(java.lang.String sResource, java.util.Map userParams)
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)
protected java.lang.Object	loadSpecialObjects(DefElement elem, java.lang.String metaObjectName, java.lang.String objType)
void	registerDefinitionFactory(java.lang.String sNameSpace, DefinitionFactory factory) Registers a binding factory and associates it with the provided namespace.
void	registerDynamicBindingContainerDef(DefinitionObject def)
void	registerStructureDef(DefinitionObject def)
void	registerStructureDefForApplication(DefinitionObject def)
static void	releaseApplicationObject(DCDataControl app) Deprecated. since 10.1.2, use DCDataControl.release() instead to release a datacontrol from the bindings as well as from the business service.
void	releaseBindingContext() This method is used to release the binding context in a DT@RT scenario where the Definition needs to be cleared.
void	releaseStructureDef(java.lang.String name) Deprecated. since 12.2.1 use oracle.jbo.mom.DefinitionManager#removeDefObject(String) instead
void	removeDefinitionFactory(java.lang.String sNameSpace) Removed the factory associated with the provided namespace.
java.lang.Object	removePersDefObject(java.lang.String defObjName)
java.lang.Object	removeSessionDefObject(java.lang.String defObjName)
static void	reportException(DCBindingContainer formBnd, java.lang.Exception ex)
static void	reportException(JUFormBinding formBnd, java.lang.Exception ex)
static void	reportException(JUFormBinding formBnd, java.lang.Exception ex, boolean reportExceptionNow)
static JUApplicationDefImpl	setApplicationDefinition(java.io.InputStream is, java.lang.String appDefName) Deprecated. since 10.1.3. Use setApplicationDefinition(String) instead, if possible.
static JUApplicationDefImpl	setApplicationDefinition(java.io.Reader reader, java.lang.String appDefName) Deprecated. since 10.1.3. Use setApplicationDefinition(String) instead, if possible.
static JUApplicationDefImpl	setApplicationDefinition(java.lang.String appDefName)
static void	setApplicationObject(java.lang.String qualifiedName, ApplicationModule am)
static void	setBaseErrorHandler(JUErrorHandler baseErrorHandler) Deprecated. since 9.0.5.1, Use setErrorHandler instead.
static void	setClientOwnedCpxName(java.lang.String name) Sets the client usage of cpx or rpx for internal purposes in a given scope.
static void	setClientOwnedCpxName(java.lang.String name, java.lang.String scopeStr) Sets the client usage of cpx or rpx for internal purposes in a given scope.
static void	setControlDefFactory(DefinitionFactory factory)
static void	setErrorHandler(DCErrorHandler baseErrorHandler)
void	setJClientDefFactory(DefinitionFactory factory) Internal: Applications should not use this class.
static void	setStatelessApplication(boolean isStatelessApplication) Sets the application in a stateless mode.
protected boolean	shouldAddToParent(DefinitionObject child, ContainerDefImpl parent)
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, addSessOptsChangeListener, checkDefinitionUpdated, checkSessionOptionsChange, clearCachedCustomizeableViewObjectNames, createFromXML, createFromXMLWithStaticDef, deleteCustomizations, dumpDefObjInfo, dumpMOM, dumpMOM, findAnyDefObject, findClassForTagName, findContainer, findDefinitionObject, findDefinitionObject, findDefinitionObject, findDefinitionObjectDontCheckName, findDefMgrAndCreateFromXML, findDefObjectUsingMetadataObject, findDefObjectUsingMetadataObject, findLoadedObject, findLoadedSessionObject, findLoadedSiteObject, findMetadataObject, findPersDefObject, findPersDefObject, findPersDefObjectWithPersDefName, findPersDefObjectWithPersDefName, findSessionDefObject, findSiteDefObject, findSubstituteName, findUserDefObject, findUserDefObject, finishSessionOptionsChange, getAllComponentDefNames, getAllDefinitionNames, getBooleanFlag, getContext, getCurrentApplicationMap, getCustomizeableRESTViewObjectNames, getCustomizeableViewObjectNames, getDefinitionObjectsMap, getDynamicObjectsContainer, getDynamicObjectsContainer, getFirstDefMgr, getJboDTD, getJboXMLDoc, getLatestDTDVersion, getLazyLoadProp, getListenerDescription, getListenerName, getMapLock, getMOMProperties, getObjectManagerDef, getPersDefObjectName, getProjectDef, getSessionDefBaseDir, getSessionDefBasePackage, getSessionDefPackages, getSessPersDefObjCount, getSiteDefBaseDir, getSiteDefBasePackage, getSiteDefPackages, getStatementMonitor, getStaticValueProvider, getSubstitutedNames, getUserDefObjectName, getValidatorFactory, hasDefinitionBeenUpdated, hasDefinitionBeenUpdated, initListener, initObjectManagerDef, initSubExtendsPropForProject, insertDefinition, insertDefinition, insertPersDefObject, insertSessionDefObject, insertSiteDefObject, insertUserDefObject, is323Compatible, is903Compatible, isDefObjEventEnabled, isDupBaseDef, isLazyLoadingInDefMap, isLazyLoadingMode, isMergeContextMDSSession, isNameForSessionDef, isNameForSiteDef, isPersDefSupported, isSessionDefSupported, isSubstituteStat, isValidateName, loadBaseXMLElement, loadBaseXMLElement, loadContext, loadDefElement, loadDefinitionObjectWithoutCaching, loadLazyDefinitionObject, loadProjectDefinition, loadProjectDefinition, loadProjectDefinition, loadProjectDefinition, loadProjectDefinition, loadProjectDefinitionInSession, loadTipPersistableDefObject, lockDefinitionContext, lookupAnyDefObject, popMergeContext, pushMergeContextForInit, pushMergeContextForTarget, registerClassForTagName, registerValidatorFactory, removeAllDefinitions, removeAllSessionDefinitions, removeDefinition, removeDefinition, removeDefinitionIfChanged, removeSessOptsChangeListener, removeSiteDefObject, removeUserDefObject, reportVMProperties, retireDefinitionObject, setContextImpl, setDefCachePolicy, setDefCachePolicy, setLazyLoadingInDefMap, setLazyLoadingMode, setMergeContext, setNameCheck, setSessionDefBaseDir, setSiteDefBaseDir, setSubstituteStat, setValidateName, unlockDefinitionContext, unretireDefinitionObject, usesMDS

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

mom

public static JUMetaObjectManager mom

Constructor Detail

JUMetaObjectManager

protected JUMetaObjectManager()

Method Detail

getDefName

protected java.lang.String getDefName()

Specified by:

getDefName in class DefinitionManager

setJClientDefFactory

public void setJClientDefFactory(DefinitionFactory factory)

Internal: Applications should not use this class.

setControlDefFactory

public static void setControlDefFactory(DefinitionFactory factory)

getControlDefFactory

public DefinitionFactory getControlDefFactory()

setBaseErrorHandler

public static void setBaseErrorHandler(JUErrorHandler baseErrorHandler)

Deprecated. since 9.0.5.1, Use setErrorHandler instead.

setErrorHandler

public static void setErrorHandler(DCErrorHandler baseErrorHandler)

reportException

public static void reportException(DCBindingContainer formBnd,
                                   java.lang.Exception ex)

reportException

public static void reportException(JUFormBinding formBnd,
                                   java.lang.Exception ex)

reportException

public static void reportException(JUFormBinding formBnd,
                                   java.lang.Exception ex,
                                   boolean reportExceptionNow)

setApplicationDefinition

public static JUApplicationDefImpl setApplicationDefinition(java.io.InputStream is,
                                                            java.lang.String appDefName)

Deprecated. since 10.1.3. Use setApplicationDefinition(String) instead, if possible.

setApplicationDefinition

public static JUApplicationDefImpl setApplicationDefinition(java.io.Reader reader,
                                                            java.lang.String appDefName)

Deprecated. since 10.1.3. Use setApplicationDefinition(String) instead, if possible.

setApplicationDefinition

public static JUApplicationDefImpl setApplicationDefinition(java.lang.String appDefName)

createApplicationDefinition

public JUApplicationDefImpl createApplicationDefinition(java.lang.String name)

getJUMom

public static JUMetaObjectManager getJUMom()

getParser

public static DefXMLParser getParser()

Deprecated. since 10.1.3. See DefinitionManager.getJboXMLDoc().

Gets the XML parser.

Returns:

the XMLParser.

getXMLVersionArray

public java.lang.String[] getXMLVersionArray()

Specified by:

getXMLVersionArray in class DefinitionManager

getDynamicPackageName

protected java.lang.String getDynamicPackageName()

Specified by:

getDynamicPackageName in class DefinitionManager

getProjectFileExtension

protected java.lang.String getProjectFileExtension()

Specified by:

getProjectFileExtension in class DefinitionManager

getClientProjectExtension

public static java.lang.String getClientProjectExtension()

setClientOwnedCpxName

@Concealed
public static void setClientOwnedCpxName(java.lang.String name)

Sets the client usage of cpx or rpx for internal purposes in a given scope.

Parameters:

name - allowed constants are JboNameUtil.APP_EXTENSION or JboNameUtil.REST_APP_EXTENSION

setClientOwnedCpxName

@Concealed
public static void setClientOwnedCpxName(java.lang.String name,
                                                    java.lang.String scopeStr)

Sets the client usage of cpx or rpx for internal purposes in a given scope.

Parameters:

name - allowed constants are JboNameUtil.APP_EXTENSION or JboNameUtil.REST_APP_EXTENSION

scopeStr - Allowed constants are ADFContext.APPLICATION_SCOPE and ADFContext.REQUEST_SCOPE

getClientCpxName

public static java.lang.String getClientCpxName()

isStatelessApplication

public static boolean isStatelessApplication()

setStatelessApplication

@Concealed
public static void setStatelessApplication(boolean isStatelessApplication)

Sets the application in a stateless mode. At the end of the request all the pending state is destroyed. It changes the default for all the users connected to the model runtime.

Parameters:

isStatelessApplication - a boolean to turn on or off the behavior.

createContainerDefObject

protected ContainerDefImpl createContainerDefObject(boolean topLevel)

Specified by:

createContainerDefObject 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

loadLazyFromSharedObject

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

Specified by:

loadLazyFromSharedObject in class DefinitionManager

findApplicationObject

public static JUApplication findApplicationObject(java.lang.String qualifiedAMName)

setApplicationObject

public static void setApplicationObject(java.lang.String qualifiedName,
                                        ApplicationModule am)

releaseApplicationObject

public static void releaseApplicationObject(DCDataControl app)

Deprecated. since 10.1.2, use DCDataControl.release() instead to release a datacontrol from the bindings as well as from the business service.

createApplicationObject

public static JUApplication createApplicationObject(java.lang.String qualifiedAMName)

createApplicationObject

public static JUApplication createApplicationObject(java.lang.String qualifiedAMName,
                                                    java.util.Properties env)

getConfigName

public static java.lang.String getConfigName(java.lang.String qualifiedAMName)

Returns the configuration name for a qualifiedAMName of the form <appDefName>.<sessDefName>.

Returns:

null if the appDef or the sessDef are not found

loadBindingContainerRef

public DCBindingContainerReference loadBindingContainerRef(BindingContext ctx,
                                                           org.w3c.dom.Node node)

loadBindingContainerRef

public static DCBindingContainerReference loadBindingContainerRef(DefElement xmlElement)

getCurrentlyLoadingCpx

public static java.lang.String getCurrentlyLoadingCpx()

findCpx

public static JUApplicationDefImpl findCpx(java.lang.String sResource)

Parameters:

sResource - the name to be loaded, ex: "view.DataBindings.cpx"

Returns:

The app def object representing the sResource name passed in which may cause it to be loaded from storage if not already in memory.

findCpx

protected static JUApplicationDefImpl findCpx(java.lang.String sResource,
                                              java.lang.String objExt)

Parameters:

sResource - the name to be loaded, ex: "view.DataBindings.cpx"

objExt - resource extension used for the case where clientcpx type is different to the resource which we are loading. for example during a REST call client cpx is rpx but the resource which we want to load can be cpx.

Returns:

The app def object representing the sResource name passed in which may cause it to be loaded from storage if not already in memory.

loadCpx

public static void loadCpx(java.lang.String sResource,
                           java.util.Map userParams)

createApplicationObject

public static JUApplication createApplicationObject(java.lang.String qualifiedAMName,
                                                    java.util.Properties env,
                                                    EnvInfoProvider envInfo)

getBindingContext

public BindingContext getBindingContext()

addApplication

public void addApplication(DCDataControl app)

createPool

public static ApplicationPool createPool(java.lang.String qualifiedAMName)

Deprecated. applications should use oracle.jbo.common.ampool.PoolMgr.findPool directly or should rely upon createApplicationObject to create a pool using the fully qualified ApplicationModule definition name.

createPool

public static ApplicationPool createPool(java.lang.String qualifiedAMName,
                                         java.util.Properties env)

Deprecated. applications should use oracle.jbo.common.ampool.PoolMgr.findPool directly or should rely upon createApplicationObject to create a pool using the fully qualified ApplicationModule definition name.

getFactoryMap

protected java.util.HashMap getFactoryMap()

registerDefinitionFactory

public void registerDefinitionFactory(java.lang.String sNameSpace,
                                      DefinitionFactory factory)

Registers a binding factory and associates it with the provided namespace.

getDefinitionFactory

public DefinitionFactory getDefinitionFactory(java.lang.String sNameSpace)

Returns the factory mapped to the provided namespace.

removeDefinitionFactory

public void removeDefinitionFactory(java.lang.String sNameSpace)

Removed the factory associated with the provided namespace.

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

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?

invalidateBindingContainerDef

public void invalidateBindingContainerDef(BindingContext ctx,
                                          java.lang.String defName)

Internal: Applications should not use this class.

releaseBindingContext

public void releaseBindingContext()

This method is used to release the binding context in a DT@RT scenario where the Definition needs to be cleared. This will cause the definition to be reloaded by MOM to pick up any customizations that where made via the DT@RT api.

initManager

protected void initManager()

Overrides:

initManager in class DefinitionManager

removePersDefObject

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

Overrides:

removePersDefObject in class DefinitionManager

removeSessionDefObject

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

Overrides:

removeSessionDefObject in class DefinitionManager

registerStructureDef

public void registerStructureDef(DefinitionObject def)

registerStructureDefForApplication

@Concealed
public void registerStructureDefForApplication(DefinitionObject def)

For internal use only. Application developers should not use this

*** For internal framework use only *** Applications should not use this method.

registerDynamicBindingContainerDef

public void registerDynamicBindingContainerDef(DefinitionObject def)

releaseStructureDef

public void releaseStructureDef(java.lang.String name)

Deprecated. since 12.2.1 use oracle.jbo.mom.DefinitionManager#removeDefObject(String) instead

Only clears out the structure def entry from MOM. Does not do a deep clean of accessor structure defs.

createFromXMLWithStaticDef

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

Deprecated.

Overrides:

createFromXMLWithStaticDef in class DefinitionManager

Parameters:

defScope -

fullName -

metaObjectName -

elem -

Returns:

For internal use only. Application developers should not use this

don't use

shouldAddToParent

protected boolean shouldAddToParent(DefinitionObject child,
                                    ContainerDefImpl parent)

Overrides:

shouldAddToParent in class DefinitionManager