oracle.jbo.server

Class PDefEntityObject

java.lang.Object

oracle.jbo.common.NamedObjectImpl

oracle.jbo.mom.DefinitionObject

oracle.jbo.mom.PersistableDefObject

oracle.jbo.mom.PersDefBase

oracle.jbo.server.PDefComponentObjectBase

oracle.jbo.server.PDefRow

oracle.jbo.server.PDefEntityObject

All Implemented Interfaces:

ResourceBundleOwner, ComponentOperationsManager, DiffMergeable, DiffSkippable, PersonalizableDef, DefPersistable, PersistentDefinition, OperationContainer, PropertyManager, ValidationManager, CustomizableEntityDef, CustomizableMetaObject, TriggerContainer, VariableManagerOwner, VariableManagerOwnerBase

public class PDefEntityObject
extends PDefRow
implements ValidationManager, TriggerContainer, CustomizableEntityDef

Note that there could dependency from PDefViewObject to PDefEntityObject. Suppose the PDefViewObject defines an attribute definition based on an attr coming from PDefEntityObject. When the PDefViewObject is loaded from XML, we create a ViewAttributeDefImpl on the PDefViewObject and copy the attr def values from PDefEntityObject.

If this PDefEntityObject's attribute is changed later, and nothing cuased the PDefViewObject to be reloaded from XML, the PDefViewObject may end up with stale definition. To fix this problem, Jedi code will invoke DefinitionManager::removeAllSessionDefinitions() to 'dump' all session definitions and pers definitions. Additionally Jedi ensures that PDefViewObject mirrors attribute level customizations done on the PDefEntityObject's personalized attributes so that runtime does not forget loading these personalizations.

Any ADFbc client who performs similar DTRT operations, should make the same call. However, one must take care when calling removeAllSessionDefinitions() as it will remove all session defs and clear out the MDS cache.

Nested Class Summary

Nested classes/interfaces inherited from class oracle.jbo.mom.PersistableDefObject

PersistableDefObject.CustomizationType, PersistableDefObject.PersonalizationType

Field Summary

Fields inherited from class oracle.jbo.mom.PersDefBase

APPLY_PERS_DB, APPLY_PERS_DEFAULT, APPLY_PERS_EVENTS, APPLY_PERS_PROPS, APPLY_PERS_QUERY, APPLY_PERS_STRUCT, APPLY_PERS_TO_BASE_DEF, APPLY_PERS_VALS, mUserPDefLogger

Fields inherited from class oracle.jbo.mom.PersistableDefObject

JIT_PACKAGE_NAME, mDebugToSkipEmptyDocForBug24949961, mEditedProperties, mEditedPropertyExprs

Fields inherited from class oracle.jbo.mom.DefinitionObject

DEF_MDS_CLIENT_KEY, DEF_SCOPE_ALL, DEF_SCOPE_PERS, DEF_SCOPE_SESSION, DEF_SCOPE_SHARED, DEF_SCOPE_SITE, DEF_SCOPE_USER, mBaseDefObject, mExtendedDefObjects, mObjectResolved, PERSDEF_MDS_CLIENT_KEY, PROPERTY_EXPRMAP

Fields inherited from class oracle.jbo.common.NamedObjectImpl

mFullName, mObjName, mParent, mProperties, RES_ID_SUFFIX, RESID_SUFFIX

Fields inherited from interface oracle.jbo.mom.xml.DefPersistable

FLAG_DIRTY, FLAG_EDITABLE, FLAG_FROM_TIP, FLAG_LOAD_BASE, FLAG_LOAD_HL_DEFS, FLAG_MAJOR_VERSION_CHANGED, FLAG_MINOR_VERSION_CHANGED, FLAG_NEW, FLAG_NEW_RECURSE, FLAG_SKIP_WRITE, XML_STATEMENT

Constructor Summary

Constructors

Constructor and Description
PDefEntityObject()
PDefEntityObject(EntityDefImpl entityDef)

Method Summary

Modifier and Type	Method and Description
AssociationDefImpl	addAssocAccessor(java.lang.String accName, java.lang.String assocName, java.lang.Class javaType)
AssociationDefImpl	addAssocAccessor(java.lang.String accName, java.lang.String assocName, java.lang.Class javaType, AssociationDefBase.IntersectExpandEnd mtomEnd)
AttributeDefImpl	addAttribute(java.lang.String attrName, java.lang.String columnName, java.lang.Class javaType, boolean isPersistent)
AttributeDefImpl	addCustomAttribute(java.lang.String attrName, java.lang.String columnName, java.lang.Class javaType, boolean isPersistent)
void	addEventDef(EventDef eventDef)
void	addEventMapping(EventMapping eventMapping)
void	addPersTrigger(TriggerType trig, JboValidatorInterface validator) Internal: Applications should not use this method. *
void	addTrigger(TriggerType trig, JboValidatorHints validator) Internal: Applications should not use this method. *
void	addTrigger(TriggerType trig, JboValidatorInterface validator) Internal: Applications should not use this method. *
void	addValidator(JboValidatorHints validator)
void	addValidator(JboValidatorInterface validator)
protected java.util.HashMap	adjustPropertyMapForWrite()
void	applyDiffChildren(DifferDetails dif, DiffResolver resolver) Applies changes to children defs.
void	applyDiffContents(DifferDetails dif, DiffResolver resolver) When diff/merge operation is requested, we have the following three def objects:
void	applyPersDB(java.lang.Object instance)
void	applyPersEvents(java.lang.Object instance)
void	applyPersonalization(int mode, java.lang.Object instance)
void	applyPersonalizationToBaseDef()
void	applyPersProps(java.lang.Object instance)
void	applyPersStruct(java.lang.Object instance)
void	applyPersVals(java.lang.Object instance)
DifferDetails	diffChildren(DiffMergeable docDef, DiffMergeable orgDef, DifferDetails difDetails) Performs diff of children defs.
DifferDetails	diffContents(DiffMergeable docDef, DiffMergeable orgDef, DifferDetails difDetails) Performs diff of scalar values.
static PDefEntityObject	findDefObject(java.lang.String persDefName)
static PDefEntityObject	findDefObjectNoSub(java.lang.String persDefName)
DefinitionObject	findStaticDefinitionObject(java.lang.String fullName)
StructureDef	findStructureDefByName(java.lang.String structDefFullName)
JboValidatorHints	findTrigger(TriggerType trig, java.lang.String name)
JboValidatorHints	findValidator(java.lang.String name)
static java.lang.String[]	getAllDefNames()
java.util.HashMap	getAllProperties(java.util.HashMap map, LocaleContext locale)
java.lang.String	getDefXMLNameSpace()
java.lang.String	getEditVersionsAsString()
java.util.ArrayList	getEventDefs()
java.util.ArrayList	getEventMappings()
oracle.jbo.server.InheritPersonalization	getInheritPersonalizationValue()
protected int	getLoadSubclassLevel()
int	getMajorVersion()
int	getMinorVersion()
protected java.lang.String	getNoPersDefObjectName(java.lang.String metaObjectName)
java.util.ArrayList	getPersTriggers(TriggerType trig) Internal: Applications should not use this method. *
java.util.ArrayList	getPersValidators()
java.util.ArrayList	getTriggers(TriggerType trig) Internal: Applications should not use this method. *
java.util.ArrayList	getValidators()
boolean	isCustIntoStaticDef()
PersistableDefObject	loadDefObject(boolean forTip, boolean forEditOrig, boolean resolveDef)
protected void	loadDefVersions(DefElement xmlElement)
void	loadXMLAttrDefContents(DefElement elem, int index)
void	loadXMLContents(DefElement xmlElement, java.lang.String fullName)
EventDef	lookupEventDef(java.lang.String eventName)
EventMapping	lookupEventMapping(java.lang.String name)
ExprDef	lookupExprDef(OwnerType type, java.lang.String path) Search for an ExprDef in the ComponentOperationsManager's namespace.
JboValidatorHints	lookupPersTrigger(TriggerType trig, java.lang.String valName)
JboValidatorHints	lookupPersValidator(java.lang.String valName)
JboValidatorHints	lookupTrigger(TriggerType trig, java.lang.String valName) Internal: Applications should not use this method. *
JboValidatorHints	lookupValidator(java.lang.String valName)
JboValidatorInterface	lookupValidatorByName(java.lang.String valName)
EventDef	personalizeEventDef(java.lang.String name)
EventMapping	personalizeEventMapping(java.lang.String eventName, EventMapping.EventPointType type)
JboValidatorHints	personalizeTrigger(TriggerType trig, java.lang.String name, java.lang.String validatorType, java.lang.String validatorSubType) Internal: Applications should not use this method. *
JboValidatorHints	personalizeValidator(java.lang.String name, java.lang.String validatorType, java.lang.String validatorSubType)
protected void	processAccessors()
boolean	removeEventDef(java.lang.String eventName)
boolean	removeEventMapping(java.lang.String name)
boolean	removePayloadItem(java.lang.String eventDefName, java.lang.String attrName) Removes the specified event payload item from this entity object, if it is present.
boolean	removePersTrigger(TriggerType trig, java.lang.String valName)
boolean	removePersValidator(java.lang.String valName)
void	removeTrigger(TriggerType trig, java.lang.String valName) Internal: Applications should not use this method. *
void	removeValidator(java.lang.String valName)
void	resolveDefObject()
protected java.lang.Object	resolvePropertyRaw(java.lang.String property, LocaleContext locale)
void	saveXMLContents()
void	setBatchThreshold(int num)
void	setCustIntoStaticDef(boolean b)
void	setInheritPersonalizationStrValue(java.lang.String s)
void	writeChildren(DefWriter jos) Writes the Object's children to the Persistent storage
void	writeContents(DefWriter jos) Objects should write their persistence output in this method
void	writeXMLContents()

Methods inherited from class oracle.jbo.server.PDefRow

addListBindingDef, addRowOperation, addScriptRowOperation, addViewAccessorDef, findAttributeDef, findListBindingDef, findRowOperationDefinition, findViewAccessorDef, getAttrDefsMap, getAttributeCount, getAttributeDef, getAttributeDefs, getAttributeDefs2, getAttributeIndexOf, getChildDefOwner, getColumnNameForQuery, getHiddenAttributes, getHiddenAttributesList, getListBindingDefs, getPersonalizedAttributes, getResourceBundleDef, getScriptRowOperationDefinitions, getScriptRowOperationDefinitions, getStructureDef, getViewAccessorDefs, hideAttribute, isObjectResolved, lookupAttributeDef, lookupListBindingDef, lookupPersonalizedAttribute, lookupRowOperationDefinition, lookupViewAccessorDef, personalizeAttribute, removeAttribute, removeHiddenAttribute, removeListBindingDef, removePersonalizedAttribute, removeRowOperation, removeViewAccessorDef, setEditable, setWholeDefDirty, setWholeDefNew

Methods inherited from class oracle.jbo.server.PDefComponentObjectBase

addOperation, addScriptOperation, applyDiffChildrenPDefComponentOperations, beginDiffObjects, diffChildrenPDefComponentOperations, editCodeSource, ensureCodeSource, ensureVariableManager, findOperationDefinition, getMessageBundleClass, getOperationDefinitions, getPersonalizedVariables, getResourceBundleDef, getResourcePrefix, getRowOperationDefinitions, getScriptOperationDefinitions, getVariableManager, hasPersonalizedComponentOperations, hasVariables, isDynamicCodeSourceEnabled, lookupCodeSource, lookupOperationDefinition, lookupPersonalizedVariable, lookupRowOperationDefinition, personalizeOperations, personalizeVariable, reapplyChanges, removeOperation, removePersonalizedVariable, setReapplyMerge, setVariableManager, updateMdsKeyFromTip

Methods inherited from class oracle.jbo.mom.PersDefBase

applyPersonalization, applyPropertiesPersonalization, deregisterDefObject, deregisterSessionObject, getBasePackage, getFileName, getStaticDef, getStaticDefWithCheck, getTrimmedFullName, getTrimmedFullNameForDef, hasStaticDefElem, isAuditEnabled, isAuditEnabled, isAutoMerged, isDeprecated, loadSubclassXMLContents, loadXMLContents, mergePropertyMap, raiseCustomAuditEvent, registerDefObject, registerSessionDefObject, removeProperty, setDefinitionState, setFullName, setFullName, setProperty, setPropertyExpression, setPropertyMap, setStaticDef, setStaticDefPublic

Methods inherited from class oracle.jbo.mom.PersistableDefObject

addChildren, addDefImport, addExtendedDefObject, addSavedDocName, allocatePDef, allocatePropertyMap, allocatePropertyMapForEdits, baseIsWriteObject, buildChildName, buildFileName, callFinishedLoading, checkEditable, checkEditableWithDefWriter, checkStructWithOld, close, createEditPDef, createFromXML, deregisterHLDef, diffChildrenHLDefs, diffChildrenProperties, diffObjects, ensureDifferDetails, ensureDifferSkip, extractCustIntoPDef, findDefImport, finishedLoading, forgetChanges, getBaseDir, getChildren, getDefImports, getDefManager, getDefTypeName, getDefWriter, getDefXMLElementTag, getDifferSkip, getEditedPropertiesMap, getEditedPropertyExpressionsMap, getEditedPropertyMap, getEditObject, getExtendedDefObjectsInternal, getFullDirName, getFullFileName, getHLDefMap, getIdentificationAttributeName, getMergeableFullName, getMergeableName, getOrigObject, getPropertyMap, getPropertyNamesSet, getSavedDocNames, getSessionSyncLock, getSubstitutedNames, getSyncLock, getXMLElementTag, guaranteePath, hasExtendedDefObjects, includeCustomizationLayerInfo, isCreateEditPDef, isCustomizationEnabled, isCustomizationEnabled, isDirty, isEditable, isFromTip, isInheritPolicyStrict, isLoadBase, isLoadHLDefs, isMajorVersionChanged, isMinorVersionChanged, isNew, isNewRecurse, isPersonalizationEnabled, isPersonalizationEnabled, isPropertyExpression, isSaveToJSON, isSkipWrite, isWriteObject, loadDefImports, loadXMLContentsNoResolve, lockDefinitionContext, lookupHLDef, makeNew, mergeChanges, mergeEditedPropertiesForJSON, objectRemoved, postSaveContents, readJSONObject, registerClass, registerHLDef, registerSiteDefObject, reloadFromXMLContents, remove, removeAndDelete, removeDefImport, removeExtendedDefObject, saveJSONContents, setCustomizationEnabled, setCustomizationEnabled, setDefaultBaseDir, setDefMgr, setDirty, setEditableFlag, setEditableObject, setForRuntime, setFullNameInternal, setLoadBase, setLoadHLDefs, setMajorVersionChanged, setNew, setNewRecurse, setOrigObject, setPersonalizationEnabled, setPersonalizationEnabled, setSkipWrite, setupDefWriterFromMO, staticUpdateChildrenList, transferDefChangesInto, unlockDefinitionContext, updateChildObject, updateChildrenList, verifyVersion, verifyVersionNullCheck, writeHeaderForNew, writeJSONContents, writeObject, writeVersion

Methods inherited from class oracle.jbo.mom.DefinitionObject

addPropertySetName, enableUpdateCheck, getAllExtendedDefObjects, getBaseDefObject, getContainerDef, getContainerName, getDefinitionState, getDefScope, getExtendedDefObjects, getMdsKey, getMdsReference, getMdsReferenceName, getPropertySetName, getPropertySetNames, getRootBaseDefObject, isBaseDefFor, isComponentDefinition, isDynamicDefinitionObject, isSubtypeOf, isSuppressUpdateCheck, loadCustomProperties, loadProperties, loadPropertiesInMap, loadPropertySetNames, loadSchemaProperties, objectFound, objectInserted, resolveReferences, setBaseDefObject, setBaseDefObject, setDefScope, setMdsKey, setMdsReference, setName, setObjectResolved, setParent, setPropertySetName, staticLoadCustomProperties, staticLoadSchemaProperties, suppressUpdateCheck

Methods inherited from class oracle.jbo.common.NamedObjectImpl

getFullName, getName, getParent, getProperties, getPropertiesAsStrings, getPropertiesMap, getProperty, getProperty, getPropertyExpressionDef, getPropertyExpressionsMap, getPropertyExprEval, getRawPropertyValue, getResourcesFromBundle, getStringFromMessageBundle, hasProperty, refreshProperty, removeProperty, requiresNamePrefixedResId, resolveObjectProperty, setPropertiesMap, setPropertiesMap2, setProperty, setPropertyExpressionMap, setRawPropertyValue

Methods inherited from class java.lang.Object

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

Methods inherited from interface oracle.jbo.server.CustomizableEntityDef

findAttributeDef, lookupAttributeDef, removeAttribute

Methods inherited from interface oracle.jbo.server.CustomizableMetaObject

getFullName, isDirty, isNew, saveXMLContents, setDirty, setEditable

Methods inherited from interface oracle.jbo.PropertyManager

getProperty, removeProperty, setProperty

Methods inherited from interface oracle.jbo.rules.ValidationManager

getFullName, getName, getResourceBundleDef, getResourceBundleDef, getStructureDef

Methods inherited from interface oracle.jbo.VariableManagerOwner

getName

Methods inherited from interface oracle.jbo.ComponentOperationsManager

getDefManager, getDefScope, getFullName

Methods inherited from interface oracle.jbo.mom.xml.DefPersistable

getFullName

Constructor Detail

PDefEntityObject

public PDefEntityObject()

PDefEntityObject

public PDefEntityObject(EntityDefImpl entityDef)

Method Detail

getAllDefNames

public static java.lang.String[] getAllDefNames()

findDefObjectNoSub

public static PDefEntityObject findDefObjectNoSub(java.lang.String persDefName)

findDefObject

public static PDefEntityObject findDefObject(java.lang.String persDefName)

findStaticDefinitionObject

public DefinitionObject findStaticDefinitionObject(java.lang.String fullName)

Specified by:

findStaticDefinitionObject in interface PersonalizableDef

Specified by:

findStaticDefinitionObject in class PersDefBase

getValidators

public java.util.ArrayList getValidators()

Specified by:

getValidators in interface ValidationManager

Overrides:

getValidators in class PDefRow

findValidator

public JboValidatorHints findValidator(java.lang.String name)

lookupValidatorByName

public JboValidatorInterface lookupValidatorByName(java.lang.String valName)

Specified by:

lookupValidatorByName in interface CustomizableEntityDef

lookupValidator

public JboValidatorHints lookupValidator(java.lang.String valName)

Specified by:

lookupValidator in interface CustomizableEntityDef

addValidator

public void addValidator(JboValidatorHints validator)

addValidator

public void addValidator(JboValidatorInterface validator)

Specified by:

addValidator in interface ValidationManager

Overrides:

addValidator in class PDefRow

removeValidator

public void removeValidator(java.lang.String valName)

Specified by:

removeValidator in interface CustomizableEntityDef

getPersValidators

public java.util.ArrayList getPersValidators()

personalizeValidator

public JboValidatorHints personalizeValidator(java.lang.String name,
                                              java.lang.String validatorType,
                                              java.lang.String validatorSubType)

lookupPersValidator

public JboValidatorHints lookupPersValidator(java.lang.String valName)

removePersValidator

public boolean removePersValidator(java.lang.String valName)

getTriggers

@Restricted
public java.util.ArrayList getTriggers(TriggerType trig)

Internal: Applications should not use this method. *

Specified by:

getTriggers in interface CustomizableEntityDef

For internal use only. Application developers should not use this

findTrigger

public JboValidatorHints findTrigger(TriggerType trig,
                                     java.lang.String name)

lookupTrigger

@Concealed
public JboValidatorHints lookupTrigger(TriggerType trig,
                                                  java.lang.String valName)

Internal: Applications should not use this method. *

Specified by:

lookupTrigger in interface TriggerContainer

For internal use only. Application developers should not use this

addTrigger

@Concealed
public void addTrigger(TriggerType trig,
                                  JboValidatorInterface validator)

Internal: Applications should not use this method. *

Specified by:

addTrigger in interface TriggerContainer

For internal use only. Application developers should not use this

addTrigger

@Restricted
public void addTrigger(TriggerType trig,
                                   JboValidatorHints validator)

Internal: Applications should not use this method. *

For internal use only. Application developers should not use this

removeTrigger

@Restricted
public void removeTrigger(TriggerType trig,
                                      java.lang.String valName)

Internal: Applications should not use this method. *

Specified by:

removeTrigger in interface TriggerContainer

For internal use only. Application developers should not use this

getPersTriggers

@Concealed
public java.util.ArrayList getPersTriggers(TriggerType trig)

Internal: Applications should not use this method. *

For internal use only. Application developers should not use this

lookupPersTrigger

public JboValidatorHints lookupPersTrigger(TriggerType trig,
                                           java.lang.String valName)

Specified by:

lookupPersTrigger in interface TriggerContainer

addPersTrigger

@Concealed
public void addPersTrigger(TriggerType trig,
                                      JboValidatorInterface validator)

Internal: Applications should not use this method. *

Specified by:

addPersTrigger in interface TriggerContainer

For internal use only. Application developers should not use this

personalizeTrigger

@Concealed
public JboValidatorHints personalizeTrigger(TriggerType trig,
                                                       java.lang.String name,
                                                       java.lang.String validatorType,
                                                       java.lang.String validatorSubType)

Internal: Applications should not use this method. *

For internal use only. Application developers should not use this

removePersTrigger

public boolean removePersTrigger(TriggerType trig,
                                 java.lang.String valName)

Specified by:

removePersTrigger in interface TriggerContainer

getEventDefs

public java.util.ArrayList getEventDefs()

addEventDef

public void addEventDef(EventDef eventDef)

lookupEventDef

public EventDef lookupEventDef(java.lang.String eventName)

removeEventDef

public boolean removeEventDef(java.lang.String eventName)

personalizeEventDef

public EventDef personalizeEventDef(java.lang.String name)

getEventMappings

public java.util.ArrayList getEventMappings()

addEventMapping

public void addEventMapping(EventMapping eventMapping)

lookupEventMapping

public EventMapping lookupEventMapping(java.lang.String name)

removeEventMapping

public boolean removeEventMapping(java.lang.String name)

personalizeEventMapping

public EventMapping personalizeEventMapping(java.lang.String eventName,
                                            EventMapping.EventPointType type)

removePayloadItem

public boolean removePayloadItem(java.lang.String eventDefName,
                                 java.lang.String attrName)

Removes the specified event payload item from this entity object, if it is present.

Parameters:

eventDefName - the name of the event containing the payload item

attrName - the name of the payload item to be removed

Returns:

false if the event or payload item was not found

addAssocAccessor

public AssociationDefImpl addAssocAccessor(java.lang.String accName,
                                           java.lang.String assocName,
                                           java.lang.Class javaType,
                                           AssociationDefBase.IntersectExpandEnd mtomEnd)

addAssocAccessor

public AssociationDefImpl addAssocAccessor(java.lang.String accName,
                                           java.lang.String assocName,
                                           java.lang.Class javaType)

Specified by:

addAssocAccessor in interface CustomizableEntityDef

setBatchThreshold

public void setBatchThreshold(int num)

addCustomAttribute

public AttributeDefImpl addCustomAttribute(java.lang.String attrName,
                                           java.lang.String columnName,
                                           java.lang.Class javaType,
                                           boolean isPersistent)

Specified by:

addCustomAttribute in interface CustomizableEntityDef

Parameters:

attrName -

columnName -

javaType -

isPersistent -

Returns:

For internal use only. Application developers should not use this

addAttribute

public AttributeDefImpl addAttribute(java.lang.String attrName,
                                     java.lang.String columnName,
                                     java.lang.Class javaType,
                                     boolean isPersistent)

findStructureDefByName

public StructureDef findStructureDefByName(java.lang.String structDefFullName)

processAccessors

protected void processAccessors()

Specified by:

processAccessors in class PDefRow

applyPersonalization

public void applyPersonalization(int mode,
                                 java.lang.Object instance)

Specified by:

applyPersonalization in interface PersonalizableDef

Specified by:

applyPersonalization in class PersDefBase

applyPersStruct

public void applyPersStruct(java.lang.Object instance)

applyPersDB

public void applyPersDB(java.lang.Object instance)

applyPersProps

public void applyPersProps(java.lang.Object instance)

applyPersVals

public void applyPersVals(java.lang.Object instance)

applyPersEvents

public void applyPersEvents(java.lang.Object instance)

writeChildren

public void writeChildren(DefWriter jos)

Description copied from interface: PersistentDefinition

Writes the Object's children to the Persistent storage

Specified by:

writeChildren in interface PersistentDefinition

Overrides:

writeChildren in class PDefRow

Parameters:

jos - the Output storage for persistence

writeContents

public void writeContents(DefWriter jos)

Description copied from interface: PersistentDefinition

Objects should write their persistence output in this method

Specified by:

writeContents in interface PersistentDefinition

Overrides:

writeContents in class PDefComponentObjectBase

Parameters:

jos - the Output storage for persistence

writeXMLContents

public void writeXMLContents()

Specified by:

writeXMLContents in interface CustomizableMetaObject

loadXMLContents

public void loadXMLContents(DefElement xmlElement,
                            java.lang.String fullName)

Overrides:

loadXMLContents in class PDefComponentObjectBase

resolveDefObject

public void resolveDefObject()

Specified by:

resolveDefObject in interface PersonalizableDef

Overrides:

resolveDefObject in class PDefRow

loadXMLAttrDefContents

public void loadXMLAttrDefContents(DefElement elem,
                                   int index)

diffChildren

public DifferDetails diffChildren(DiffMergeable docDef,
                                  DiffMergeable orgDef,
                                  DifferDetails difDetails)

Description copied from interface: DiffMergeable

Performs diff of children defs. This def should enumerate through all its children and diff them and accumulate details of diff into difDetails and return it at the end.

For example, if this def has Child1 and Child2, its implementation should look something like:

    public DifferDetails diffChildren(DiffMergeable docDef, DiffMergeable orgDef, DifferDetails difDetails)
    {
       difDetails = diffChildrenChild1(docDef, orgDef, difDetails);
       difDetails = diffChildrenChild1(docDef, orgDef, difDetails);

       return difDetails;
    }
 

where diffChildrenChild1() uses DifferChildren's helper method diffChildrenList to diff the child defs.

Specified by:

diffChildren in interface DiffMergeable

Overrides:

diffChildren in class PDefRow

Parameters:

docDef - the document-level definition

orgDef - the original definition. It could be null if the definition did not exist originally

difDetails - the DifferDetails that accumulate the details of diff from the document-level (top-level) def

Returns:

the DifferDetails that has all the details of diff

diffContents

public DifferDetails diffContents(DiffMergeable docDef,
                                  DiffMergeable orgDef,
                                  DifferDetails difDetails)

Description copied from interface: DiffMergeable

Performs diff of scalar values. Typically, scalar attr values are grouped into String, int, and boolean arrays -- one set coming from 'this' definition and the other set coming from orgDef. Then, help methods on DifferBase can be used to diff the attr values and accumulate the details of diff in difDetails.

Here is example code snippet:

    private static final String DIFF_STRING_ELEMS[] =
    {
       "MyStringVal1",
       "MyStringVal2"
    };

    private static final String DIFF_INT_ELEMS[] =
    {
       "MyIntVal",
    }

    public DifferDetails diffContents(DiffMergeable docDef, DiffMergeable orgDef, DifferDetails difDetails)
    {
       <Your-def-class> orgDefImpl = (<Your-def-class>) orgDef;

       final String editStringValues[] =
       {
          this.getMyStringVal1(),
          this.getMyStringVal2()
       };

       String orgStringValues[] = null;

       if (orgDef != null)
       {
          String orgV[] =
          {
             orgDefImpl.getMyStringVal1(),
             orgDefImpl.getMyStringVal2()
          };

          orgStringValues = orgV;
       }

       final int editIntValues[] =
       {
          this.getMyIntVal(),
       };

       int orgIntValues[] = null;

       if (orgDef != null)
       {
          int orgV[] =
          {
             orgDefImpl.getMyIntVal()
          };

          orgIntValues = orgV;
       }

       difDetails = DifferBase.diffStringArray(this, DIFF_STRING_ELEMS, editStringValues, orgStringValues, difDetails);
       difDetails = DifferBase.diffIntArray(this, DIFF_INT_ELEMS, editIntValues, orgIntValues, difDetails);

       return difDetails;
   }
 

Specified by:

diffContents in interface DiffMergeable

Parameters:

docDef - the document-level definition

orgDef - the original definition. It could be null if the definition did not exist originally

difDetails - the DifferDetails that accumulate the details of diff from the document-level (top-level) def

Returns:

the DifferDetails that has all the details of diff

applyDiffChildren

public void applyDiffChildren(DifferDetails dif,
                              DiffResolver resolver)

Description copied from interface: DiffMergeable

Applies changes to children defs. dif contains the changes to be applied to the children. For each child def, this method should first retrieve the diff details for the child, which is of type DifferChildren. Then, it should call DifferChildren.applyDiffChanges(oracle.jbo.mom.DiffChildrenMerge, oracle.jbo.mom.DiffResolver) to perform the change operation.

applyChanges() requires a DiffChildrenMerge object, which has the insert, update, and remove methods. 'this' def object must provide implmementation of these operations.

Here is a sample:

    public void applyDiffChildren(DifferDetails dif, DiffResolver resolver)
    {
       DifferChangeMap detailMap = dif.getDetailMap();

       if (detailMap != null)
       {
          DifferChildren difChild1 = (DifferChildren) detailMap.getValue(<XML-tag-for-Child1>);

          if (difVCs != null)
          {
             DiffChildrenMerge dm = new DiffChildrenMerge()
             {
                public void insertChild(Object id, Object value)
                {
                   .. perform insert op for Child1 ..
                }

                public void updateChild(Object id, Object value, Object oldValue)
                {
                   .. perform update op for Child1 ..
                }

                public void removeChild(Object id)
                {
                   .. perform remove op for Child1 ..
                }
             };

             difChild1.applyDiffChanges(dm, resolver);
          }

          // Similarly for Child2
       }
    }
 

Specified by:

applyDiffChildren in interface DiffMergeable

Overrides:

applyDiffChildren in class PDefRow

lookupExprDef

public ExprDef lookupExprDef(OwnerType type,
                             java.lang.String path)

Description copied from interface: ComponentOperationsManager

Search for an ExprDef in the ComponentOperationsManager's namespace.

Specified by:

lookupExprDef in interface ComponentOperationsManager

Overrides:

lookupExprDef in class PDefRow

Parameters:

type - the OwnerType of the expression

path - the ExprDef.getPath() of the expression

getInheritPersonalizationValue

public oracle.jbo.server.InheritPersonalization getInheritPersonalizationValue()

setInheritPersonalizationStrValue

public void setInheritPersonalizationStrValue(java.lang.String s)

isCustIntoStaticDef

public boolean isCustIntoStaticDef()

setCustIntoStaticDef

public void setCustIntoStaticDef(boolean b)

loadDefObject

public PersistableDefObject loadDefObject(boolean forTip,
                                          boolean forEditOrig,
                                          boolean resolveDef)

Overrides:

loadDefObject in class PersistableDefObject

getLoadSubclassLevel

protected int getLoadSubclassLevel()

getEditVersionsAsString

public java.lang.String getEditVersionsAsString()

Overrides:

getEditVersionsAsString in class PersistableDefObject

getMajorVersion

public int getMajorVersion()

Overrides:

getMajorVersion in class PersistableDefObject

getMinorVersion

public int getMinorVersion()

Overrides:

getMinorVersion in class PersistableDefObject

loadDefVersions

protected void loadDefVersions(DefElement xmlElement)

getNoPersDefObjectName

protected java.lang.String getNoPersDefObjectName(java.lang.String metaObjectName)

applyPersonalizationToBaseDef

public void applyPersonalizationToBaseDef()

saveXMLContents

public void saveXMLContents()

Overrides:

saveXMLContents in class PersDefBase

resolvePropertyRaw

protected java.lang.Object resolvePropertyRaw(java.lang.String property,
                                              LocaleContext locale)

Overrides:

resolvePropertyRaw in class NamedObjectImpl

getAllProperties

public java.util.HashMap getAllProperties(java.util.HashMap map,
                                          LocaleContext locale)

Overrides:

getAllProperties in class NamedObjectImpl

adjustPropertyMapForWrite

protected java.util.HashMap adjustPropertyMapForWrite()

Overrides:

adjustPropertyMapForWrite in class PersistableDefObject

getDefXMLNameSpace

public java.lang.String getDefXMLNameSpace()

Specified by:

getDefXMLNameSpace in interface PersistentDefinition

Overrides:

getDefXMLNameSpace in class PersistableDefObject

applyDiffContents

public void applyDiffContents(DifferDetails dif,
                              DiffResolver resolver)

Description copied from interface: DiffMergeable

When diff/merge operation is requested, we have the following three def objects:

orgDef - original def object (from the branch point) editDef - def object into which changes are to be merge toMergeDef - def object to be merged (source of changes) For sandbox refresh operation, orgDef comes from the branch point, editDef from the sandbox, toMergeDef from the mainline of the repos. With these three defs, we first diff editDef against orgDef, producing editDifDetails.

Similarly, toMergeDef is diffed against orgDef, producing toMergeDifDetails. The diff engine then walks through these two sets of diffs and identifies conflicts. After the conflicts are all resolved, we apply appropriate changes to editDef.

applyDiffContents is called to apply changes to scalar values. dif contains the changed values to be applied to 'this' object. Use sample code like the following:

    public void applyDiffContents(DifferDetails dif, DiffResolver resolver)
    {
       DifferChangeMap detailMap = dif.getDetailMap();
       Object[] updValues;

       // DIFF_STRING_ELEMS from the above example code
       for (int j = 0; j < DIFF_STRING_ELEMS.length; j++)
       {
          if ((updValues = (Object[]) detailMap.getValue(DIFF_STRING_ELEMS[j])) != null)
          {
             switch(j)
             {
             case 0:
                setMyStringVal1((String) updValues[0]);
                break;
             case 1:
                 setMyStringVal2((String) updValues[0]);
                break;
             }
          }
       }

       for (int j = 0; j < DIFF_INT_ELEMS.length; j++)
       {
          if ((updValues = (Object[]) detailMap.getValue(DIFF_INT_ELEMS[j])) != null)
          {
             switch(j)
             {
             case 0:
                setMyIntVal((Integer) updValues[0]);
                break;
             }
          }
       }
    }
 

Notice that the index specified in the case statement is the array index of the attr in the String, int, or boolean array.

Specified by:

applyDiffContents in interface DiffMergeable

Overrides:

applyDiffContents in class PersistableDefObject

Parameters:

dif - changes to be applied to 'this' def

resolver - the diff resolver used in diff/merge operation