public class RowReference extends ComponentObjectImpl implements DefPersistable, DiffMergeable
NAME
RowReference.java - Base class for view object bases.
DESCRIPTION
NOTES
VERSION
MODIFIED (MM/DD/YY)
| Modifier and Type | Field and Description |
|---|---|
static byte |
EFFDT_USAGE_HAS_IMPLICIT_ATTRS |
static java.lang.String |
EFFDT_USAGE_HAS_IMPLICIT_ATTRS_STR |
static byte |
EFFDT_USAGE_NO_OVERRIDE |
static byte |
EFFDT_USAGE_OVERRIDE_FALSE |
static java.lang.String |
EFFDT_USAGE_OVERRIDE_FALSE_STR |
mFullName, mObjName, mParent, mProperties, RES_ID_SUFFIX, RESID_SUFFIXFLAG_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_STATEMENTDEFINITION_STATE_ACTIVE, DEFINITION_STATE_DEPRECATED, PROPERTY_DEFINITION_STATE, PROPERTY_ERROR_MSG, PROPERTY_LABEL, PROPERTY_LABEL_PLURAL, PROPERTY_TOOLTIP| Modifier and Type | Method and Description |
|---|---|
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:
|
DifferDetails |
beginDiffObjects(DiffMergeable docDef,
DiffMergeable orgDef,
DifferDetails difDetails)
This method is the entry point call when the diffing process
begins on the document-level def.
|
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.
|
DifferDetails |
diffObjects(DiffMergeable docDef,
DiffMergeable orgDef,
DifferDetails difDetails)
The work-horse method performing diff between two defs of this
def type.
|
DifferDetails |
ensureDifferDetails(DifferDetails difDetails)
Ensures that we have a valid
DifferDetails. |
protected ViewAttributeDefImpl |
findViewAttrDefByBaseAttrName(java.lang.String name,
AttributeDefImpl attr) |
protected ViewAttributeDefImpl |
findViewAttrDefByViewAttrName(java.lang.String name,
AttributeDefImpl attr) |
protected ViewAttributeDefImpl |
findViewAttributeDefImpl(java.lang.String name) |
protected java.util.ArrayList |
findViewAttributeDefImpls(AttributeDefImpl attr) |
AssociationReference[] |
getAssociationReferences() |
DefObject |
getDef() |
java.lang.String |
getDefTypeName()
Returns the XML def type name of this defintion object, e.g.,
"PDefEntityObject".
|
java.lang.String |
getDefXMLElementTag() |
java.lang.String |
getDefXMLNameSpace() |
java.lang.String |
getIdentificationAttributeName()
return the attribute name for identification on an xml element.
|
int |
getJoinType()
Returns the join type if the Entity Reference participates in one.
|
static int |
getJoinType(java.lang.String type) |
static java.lang.String |
getJoinTypeAsString(int joinType)
Returns the join type as a
String so that
it can be used in SQL generation. |
java.lang.String |
getMergeableFullName()
Returns the fully qualified name of the diff-mergeable definition object.
|
java.lang.String |
getMergeableName()
Returns the diff-mergeable definition's name (short form).
|
DefPersistable |
getOrigObject() |
ViewAttributeDefImpl[] |
getViewAttributeDefImpls() |
java.lang.String |
getXMLElementTag()
Returns a piece of static info for the type of object this is invoked
upon.
|
boolean |
isDeleteParticipant()
Does this Referant Entity participate in the Delete processing in
this usage.
|
boolean |
isDirty()
This method returns if an Object is modified from last save/load
|
boolean |
isEffectiveDated()
Checks if the underlying entity is used in an
effective dated fashion or not.
|
boolean |
isEntireObjectTable() |
boolean |
isInsertParticipant()
Does this Referant Entity participate in the Delete processing in
this usage.
|
boolean |
isLockParticipant()
Does this Referant Entity participate in the Lock processing in
this usage.
|
boolean |
isNew()
This method returns if this object is previously persisted.
|
boolean |
isNewRecurse() |
boolean |
isReadOnly() |
boolean |
isReference()
Does this Referant Entity participate in the DML.
|
static boolean |
isSame(RowReference left,
RowReference right) |
boolean |
isSkipWrite() |
boolean |
isWriteObject(DefPersistable parentObj,
DefWriter defWriter) |
void |
setDirty(boolean b)
This method marks the Object dirty
|
void |
setEntireObjectTable(boolean b) |
void |
setFullName(java.lang.String name)
Give this object a fully-qualified name.
|
void |
setJoinType(int joinType)
Set the type of join.
|
void |
setName(java.lang.String name)
Name this object.
|
void |
setNew(boolean b)
This method marks the as previously persisted.
|
void |
setNewRecurse(boolean b) |
void |
setOrigObject(DefPersistable origObject) |
void |
setReadOnly(boolean state)
Set the Referant Entity to READ-ONLY entity usage
|
void |
setReference(boolean state)
Set the Referant Entity to REFERENCE-ONLY enable entity lookup on source key attribute change.
|
void |
setSkipWrite(boolean b) |
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 |
writeObject(DefWriter jos)
Objects should write their persistence output in this method
|
addListener, applyPersonalization, applyPersonalization, create, createRef, createVariableValueManager, editCodeSource, ensureCodeSource, ensureVariableManager, findPersDefObject, getAdfmConfigStartupProperty, getAllProperties, getApplicationModule, getBooleanAdfmConfigProperty, getCompListeners, getCompListenersList, getDefFullName, getDefinitionManager, getDefinitionState, getDefManager, getDefName, getDefScope, getFullNameForPersDef, getHintValue, getLabel, getLabelPlural, getMessageBundleClass, getOperationDefinitions, getProxyClassName, getProxyClassName, getResourceBundleDef, getResourceBundleDef, getRootApplicationModule, getRowOperationDefinitions, getScriptOperationDefinitions, getScriptRowOperationDefinitions, getStaticDefFullName, getStringFromMessageBundle, getStructureDef, getTooltip, getVariableManager, hasVariables, isDead, isDynamicCodeSourceEnabled, isPersonalized, isRegWithPiggyMan, lookupExprDef, remove, resolvePropertyRaw, setParent, setProxyClassNameisPropertyExpression, setParent, setPropertiesMapallocatePropertyMap, getFullName, getName, getParent, getProperties, getPropertiesAsStrings, getPropertiesMap, getProperty, getProperty, getPropertyExpressionDef, getPropertyExpressionsMap, getPropertyExprEval, getPropertyMap, getPropertyNamesSet, getRawPropertyValue, getResourcesFromBundle, hasProperty, mergePropertyMap, refreshProperty, removeProperty, removeProperty, requiresNamePrefixedResId, resolveObjectProperty, setPropertiesMap2, setProperty, setProperty, setPropertyExpression, setPropertyExpressionMap, setPropertyMap, setRawPropertyValueclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitgetFullNamegetFullName, getNamegetProperties, getProperty, getProperty, refreshPropertygetNamegetFullNamegetProperty, removeProperty, setPropertypublic static final byte EFFDT_USAGE_NO_OVERRIDE
public static final byte EFFDT_USAGE_OVERRIDE_FALSE
public static final byte EFFDT_USAGE_HAS_IMPLICIT_ATTRS
public static final java.lang.String EFFDT_USAGE_OVERRIDE_FALSE_STR
public static final java.lang.String EFFDT_USAGE_HAS_IMPLICIT_ATTRS_STR
public void setName(java.lang.String name)
ComponentObjectImplsetName in class ComponentObjectImplname - the name to be given to this object.public java.lang.String getMergeableName()
DiffMergeablegetMergeableName in interface DiffMergeablepublic java.lang.String getMergeableFullName()
DiffMergeablegetMergeableFullName in interface DiffMergeablepublic boolean isNew()
DefPersistableisNew in interface DefPersistablepublic void setNew(boolean b)
DefPersistablesetNew in interface DefPersistableb - If true the Object is marked as new object.public boolean isNewRecurse()
isNewRecurse in interface DefPersistablepublic void setNewRecurse(boolean b)
setNewRecurse in interface DefPersistablepublic boolean isDirty()
DefPersistableisDirty in interface DefPersistablepublic void setDirty(boolean b)
DefPersistablesetDirty in interface DefPersistableb - If true the Object is marked Dirty.public boolean isSkipWrite()
isSkipWrite in interface DefPersistablepublic void setSkipWrite(boolean b)
setSkipWrite in interface DefPersistablepublic boolean isWriteObject(DefPersistable parentObj, DefWriter defWriter)
isWriteObject in interface DefPersistablepublic DefPersistable getOrigObject()
getOrigObject in interface DefPersistablepublic void setOrigObject(DefPersistable origObject)
setOrigObject in interface DefPersistablepublic void setFullName(java.lang.String name)
NamedObjectImplsetFullName in class NamedObjectImplname - this object's fully-qualified name;
the package name concatenated with the class name.public DefObject getDef()
getDef in class ComponentObjectImplpublic ViewAttributeDefImpl[] getViewAttributeDefImpls()
public AssociationReference[] getAssociationReferences()
public boolean isLockParticipant()
public boolean isDeleteParticipant()
public boolean isInsertParticipant()
public boolean isEntireObjectTable()
public void setEntireObjectTable(boolean b)
public void setReference(boolean state)
state - True to be REFERENCE, false otherwise.public void setReadOnly(boolean state)
state - True to be READONLY , false otherwise.public boolean isReference()
protected ViewAttributeDefImpl findViewAttrDefByViewAttrName(java.lang.String name, AttributeDefImpl attr)
protected ViewAttributeDefImpl findViewAttrDefByBaseAttrName(java.lang.String name, AttributeDefImpl attr)
protected ViewAttributeDefImpl findViewAttributeDefImpl(java.lang.String name)
protected java.util.ArrayList findViewAttributeDefImpls(AttributeDefImpl attr)
public boolean isReadOnly()
public void writeObject(DefWriter jos)
PersistentDefinitionwriteObject in interface PersistentDefinitionjos - the Output storage for persistencepublic void writeContents(DefWriter jos)
PersistentDefinitionwriteContents in interface PersistentDefinitionjos - the Output storage for persistencepublic void writeChildren(DefWriter jos)
PersistentDefinitionwriteChildren in interface PersistentDefinitionjos - the Output storage for persistencepublic java.lang.String getDefTypeName()
DiffMergeablegetDefTypeName in interface DiffMergeablepublic java.lang.String getXMLElementTag()
PersistentDefinitiongetXMLElementTag in interface PersistentDefinitionpublic java.lang.String getDefXMLElementTag()
getDefXMLElementTag in interface PersistentDefinitionpublic java.lang.String getDefXMLNameSpace()
getDefXMLNameSpace in interface PersistentDefinitionpublic java.lang.String getIdentificationAttributeName()
PersistentDefinitiongetIdentificationAttributeName in interface PersistentDefinitionpublic void setJoinType(int joinType)
setFromClause and setWhereClause
on the ViewDefImpl class.joinType - The type of joinpublic int getJoinType()
public static java.lang.String getJoinTypeAsString(int joinType)
String so that
it can be used in SQL generation.String objectpublic static int getJoinType(java.lang.String type)
public boolean isEffectiveDated()
true if the usage is effective dated,
public static boolean isSame(RowReference left, RowReference right)
public DifferDetails ensureDifferDetails(DifferDetails difDetails)
DiffMergeableDifferDetails.
This method is to create a DifferDetails object to
be used for diffing if necessary. The difDetails may come in
as null. By calling this method, we can ensure that
a non-null difDetails is there. So, instead of
writing:
if (difDetails == null)
{
difDetails = new DifferDetails(..);
}
difDetails.addDiffDetail(..);
we can write
(difDetails = diffMergeable.ensureDifferDetails(difDetails)).addDiffDetail(..);
ensureDifferDetails in interface DiffMergeabledifDetails - the incoming DifferDetails. It may
be null.difDetails if it wasn't
null coming in, or a new DifferDetails if
the incoming difDetails was nullpublic DifferDetails diffContents(DiffMergeable docDef, DiffMergeable orgDef, DifferDetails difDetails)
DiffMergeableorgDef. 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;
}
diffContents in interface DiffMergeabledocDef - the document-level definitionorgDef - the original definition. It could be
null if the definition did not exist originallydifDetails - the DifferDetails that accumulate
the details of diff from the document-level (top-level) defDifferDetails that has all the details
of diffpublic DifferDetails diffChildren(DiffMergeable docDef, DiffMergeable orgDef, DifferDetails difDetails)
DiffMergeabledifDetails 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.
diffChildren in interface DiffMergeabledocDef - the document-level definitionorgDef - the original definition. It could be
null if the definition did not exist originallydifDetails - the DifferDetails that accumulate
the details of diff from the document-level (top-level) defDifferDetails that has all the details
of diffpublic DifferDetails beginDiffObjects(DiffMergeable docDef, DiffMergeable orgDef, DifferDetails difDetails)
DiffMergeableDiffMergeable's. 'this' object is the
changed definition.
beginDiffObjects in interface DiffMergeabledocDef - the document-level definitionorgDef - the original definition. It could be
null if the definition did not exist originallydifDetails - the DifferDetails that accumulate
the details of diff from the document-level (top-level) defDifferDetails that has all the details
of diffpublic DifferDetails diffObjects(DiffMergeable docDef, DiffMergeable orgDef, DifferDetails difDetails)
DiffMergeablediffContents
to diff scalar values and diffChildren to diff
children objects. The children objects themselves are expected
to be DiffMergeable. 'this' object is the
changed definition.
diffObjects in interface DiffMergeabledocDef - the document-level definitionorgDef - the original definition. It could be
null if the definition did not exist originallydifDetails - the DifferDetails that accumulate
the details of diff from the document-level (top-level) defDifferDetails that has all the details
of diffpublic void applyDiffContents(DifferDetails dif, DiffResolver resolver)
DiffMergeable
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.
applyDiffContents in interface DiffMergeabledif - changes to be applied to 'this' defresolver - the diff resolver used in diff/merge operationpublic void applyDiffChildren(DifferDetails dif, DiffResolver resolver)
DiffMergeabledif 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
}
}
applyDiffChildren in interface DiffMergeable