public class ListBindingDef extends PersistableDefObject implements ResourceBundleOwner
PersistableDefObject.CustomizationType, PersistableDefObject.PersonalizationType
Modifier and Type | Field and Description |
---|---|
static java.lang.String |
LIST_CRITERIA_DISPLAY_HINT |
static java.lang.String |
LIST_CRITERIA_DISPLAY_HINT_EXECUTE |
static java.lang.String |
LIST_CRITERIA_DISPLAY_HINT_HIDE |
static java.lang.String |
LIST_CRITERIA_NAME |
static java.lang.String |
PNAME_AttrExpressions |
static java.lang.String |
PNAME_AttrNames |
static java.lang.String |
PNAME_ComboAttrCount |
static java.lang.String |
PNAME_ComboRowCount |
static java.lang.String |
PNAME_DerivedAttrNames |
static java.lang.String |
PNAME_LabelList |
static java.lang.String |
PNAME_ListAttrNames |
static java.lang.String |
PNAME_ListDelimiter |
static java.lang.String |
PNAME_ListDisplayAttrNames |
static java.lang.String |
PNAME_ListIterName |
static java.lang.String |
PNAME_ListNullValueFlag |
static java.lang.String |
PNAME_ListNullValueId |
static java.lang.String |
PNAME_ListOperMode |
static java.lang.String |
PNAME_ListRangeSize |
static java.lang.String |
PNAME_ListRSIName |
static java.lang.String |
PNAME_ListServerBindingName |
static java.lang.String |
PNAME_ListVOName |
static java.lang.String |
PNAME_MRUCount |
static java.lang.String |
PNAME_MRUId |
static java.lang.String |
PNAME_MRUItems |
static java.lang.String |
PNAME_RowLevelBinds |
static java.lang.String |
PNAME_StaticList |
static java.lang.String |
PNAME_StaticListDT |
static java.lang.String |
PNAME_ValueList |
static java.lang.String |
STR_LIST_ADD_NULL_AT_END |
static java.lang.String |
STR_LIST_ADD_NULL_AT_START |
static java.lang.String |
STR_LIST_ADD_NULL_NOWHERE |
mEditedProperties, mEditedPropertyExprs
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
mFullName, mObjName, mParent, mProperties, RES_ID_SUFFIX, RESID_SUFFIX
XML_STATEMENT
Constructor and Description |
---|
ListBindingDef(DefinitionManager defMgr,
int defScope) |
ListBindingDef(ListBindingDef other) |
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:
|
static java.lang.String |
convertListNullValueFlag(int nullValueFlag)
For internal use only
|
static int |
convertListNullValueFlag(java.lang.String str)
For internal use only
|
static boolean |
convertToBoolean(java.lang.Object val) |
static int |
convertToInt(java.lang.Object val) |
static int[] |
convertToIntArray(java.lang.Object[] arr) |
void |
copyFrom(ListBindingDef def)
Internal: Applications should not use this method.
|
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.
|
RowSetIterator |
filterAndApplyListWithCaseCheck(RowSetIterator listRSI,
java.util.Map valuesMap,
Row targetRow,
ViewCriteria criteria,
boolean exact,
boolean checkForCase,
boolean ignoreOper,
boolean apply)
Deprecated.
|
RowSetIterator |
filterList(RowSetIterator listRSI,
java.util.Map valuesMap,
Row targetRow,
ViewCriteria criteria,
boolean exact,
boolean checkForCase)
Deprecated.
|
java.lang.String[] |
getAttrExpressions() |
java.lang.String[] |
getAttrNames() |
int |
getComboDisplayAttributeCount()
Returns the count of attributes that should be displayed in a combo dropdown.
|
int |
getComboDisplayRowCountHint()
Returns the count of attributes that should be displayed in a combo dropdown.
|
java.lang.String |
getDefXMLElementTag() |
java.lang.String |
getDelimiter() |
java.lang.String[] |
getDerivedAttrNames() |
java.lang.String |
getDisplayCriteriaName() |
java.lang.String[] |
getLabelList() |
java.lang.String[] |
getListAttrNames() |
java.lang.String[] |
getListDisplayAttrNames() |
int |
getListRangeSize() |
java.lang.String |
getListRSIName() |
java.lang.String |
getListVOName() |
int |
getMRUCount() |
java.util.List<java.util.List<java.lang.String>> |
getMRUItems() |
int |
getNullValueFlag() |
java.lang.String |
getNullValueId() |
java.lang.String |
getNullValueText(java.util.Locale locale) |
java.lang.String |
getPreferredCriteriaName() |
ResourceBundleDef |
getResourceBundleDef() |
java.lang.String |
getResourcePrefix() |
boolean |
getRowLevelBinds() |
java.util.List<java.lang.String> |
getSelectedDisplayValues(RowSetIterator rsi,
Row currentRow)
Deprecated.
|
java.lang.Object[] |
getValueList() |
void |
init(java.util.HashMap initValues) |
boolean |
isAutoExecuteCriteria() |
boolean |
isCriteriaShown() |
boolean |
isMRUCountDefined()
For internal use only.
|
boolean |
isStaticList() |
void |
loadFromXML(DefElement xmlElement) |
static void |
readXMLBoolean(DefElement xmlElement,
java.lang.String name,
java.util.HashMap valueTab) |
static void |
readXMLInt(DefElement xmlElement,
java.lang.String name,
java.util.HashMap valueTab) |
static void |
readXMLString(DefElement xmlElement,
java.lang.String name,
java.util.HashMap valueTab) |
static void |
readXMLStringArray(DefElement xmlElement,
java.lang.String name,
java.util.HashMap valueTab) |
void |
setAttrExpressions(java.lang.String[] attrExprs) |
void |
setAttrNames(java.lang.String[] attrNames) |
void |
setAutoExecuteCriteria(boolean val) |
void |
setComboDisplayAttributeCount(int listRangeSize) |
void |
setComboDisplayRowCountHint(int listRangeSize) |
void |
setCriteriaShown(boolean val) |
void |
setDelimiter(java.lang.String de) |
void |
setDerivedAttrNames(java.lang.String[] derivedAttrNames) |
void |
setDisplayCriteriaName(java.lang.String name) |
void |
setLabelList(java.lang.String[] list) |
void |
setListAttrNames(java.lang.String[] listAttrNames) |
void |
setListDisplayAttrNames(java.lang.String[] str) |
void |
setListRangeSize(int listRangeSize) |
void |
setListRSIName(java.lang.String listRSIName) |
void |
setListVOName(java.lang.String voName) |
void |
setMRUCount(int count) |
void |
setMRUItems(java.util.List<java.util.List<java.lang.String>> vals) |
void |
setNullValueFlag(int flag) |
void |
setNullValueId(java.lang.String s) |
void |
setNullValueText(java.lang.String text) |
void |
setParent(NamedObjectImpl parent)
Sets this object's parent.
|
void |
setPreferredCriteriaName(java.lang.String criteriaName) |
void |
setResourceBundleDef(ResourceBundleDef def) |
void |
setRowLevelBinds(boolean bRowLevelBinds) |
void |
setStaticList(boolean staticList) |
void |
setValueList(java.lang.Object[] valList) |
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
|
addDefImport, addExtendedDefObject, addSavedDocName, adjustPropertyMapForWrite, allocatePropertyMap, allocatePropertyMapForEdits, beginDiffObjects, checkEditable, checkStructWithOld, close, createFromXML, deregisterDefObject, deregisterSessionObject, diffObjects, ensureDifferDetails, findDefImport, finishedLoading, getBaseDir, getBasePackage, getDefImports, getDefManager, getDefTypeName, getDefWriter, getDefXMLNameSpace, getEditedPropertiesMap, getEditedPropertyExpressionsMap, getEditedPropertyMap, getEditObject, getEditVersionsAsString, getExtendedDefObjectsInternal, getFileName, getFullDirName, getFullFileName, getMajorVersion, getMergeableFullName, getMergeableName, getMinorVersion, getOrigObject, getPropertyMap, getSavedDocNames, getSessionSyncLock, getSubstitutedNames, getSyncLock, getXMLElementTag, guaranteePath, hasExtendedDefObjects, includeCustomizationLayerInfo, isCustomizationEnabled, isCustomizationEnabled, isDirty, isEditable, isFromTip, isLoadBase, isMajorVersionChanged, isMinorVersionChanged, isNew, isPersonalizationEnabled, isPersonalizationEnabled, isPropertyExpression, loadDefImports, loadDefObject, loadXMLContents, loadXMLContentsNoResolve, lockDefinitionContext, mergeChanges, mergePropertyMap, objectRemoved, reapplyChanges, registerClass, registerDefObject, registerSessionDefObject, registerSiteDefObject, remove, removeAndDelete, removeDefImport, removeExtendedDefObject, removeProperty, saveXMLContents, setCustomizationEnabled, setCustomizationEnabled, setDefaultBaseDir, setDefMgr, setDirty, setEditable, setEditableFlag, setEditableObject, setFullName, setFullNameInternal, setLoadBase, setMajorVersionChanged, setNew, setOrigObject, setPersonalizationEnabled, setPersonalizationEnabled, setProperty, setPropertyExpression, setPropertyMap, setupDefWriterFromMO, staticUpdateChildrenList, unlockDefinitionContext, updateChildrenList, updateMdsKeyFromTip, verifyVersion, verifyVersionNullCheck, writeHeaderForNew, writeObject, writeVersion, writeXMLContents
addPropertySetName, enableUpdateCheck, getAllExtendedDefObjects, getBaseDefObject, getContainerDef, getContainerName, getDefinitionState, getDefScope, getExtendedDefObjects, getMdsKey, getMdsReference, getPropertySetName, getPropertySetNames, getRootBaseDefObject, isBaseDefFor, isComponentDefinition, isDeprecated, isDynamicDefinitionObject, isObjectResolved, isSubtypeOf, isSuppressUpdateCheck, loadCustomProperties, loadProperties, loadPropertiesInMap, loadPropertySetNames, loadSchemaProperties, resolveReferences, setBaseDefObject, setBaseDefObject, setDefScope, setMdsKey, setMdsReference, setName, setObjectResolved, setPropertySetName, staticLoadCustomProperties, staticLoadSchemaProperties, suppressUpdateCheck
getAllProperties, getFullName, getName, getParent, getProperties, getPropertiesAsStrings, getPropertiesMap, getProperty, getProperty, getPropertyExpressionDef, getPropertyExpressionsMap, getPropertyNamesSet, getRawPropertyValue, getResourcesFromBundle, getStringFromMessageBundle, refreshProperty, removeProperty, requiresNamePrefixedResId, resolveObjectProperty, resolvePropertyRaw, setPropertiesMap, setPropertiesMap2, setProperty
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
getFullName
public static final java.lang.String LIST_CRITERIA_NAME
public static final java.lang.String LIST_CRITERIA_DISPLAY_HINT
public static final java.lang.String LIST_CRITERIA_DISPLAY_HINT_EXECUTE
public static final java.lang.String LIST_CRITERIA_DISPLAY_HINT_HIDE
public static final java.lang.String PNAME_StaticList
public static final java.lang.String PNAME_StaticListDT
public static final java.lang.String PNAME_AttrNames
public static final java.lang.String PNAME_AttrExpressions
public static final java.lang.String PNAME_DerivedAttrNames
public static final java.lang.String PNAME_ListAttrNames
public static final java.lang.String PNAME_ListDisplayAttrNames
public static final java.lang.String PNAME_ListRangeSize
public static final java.lang.String PNAME_ValueList
public static final java.lang.String PNAME_LabelList
public static final java.lang.String PNAME_MRUItems
public static final java.lang.String PNAME_ListVOName
public static final java.lang.String PNAME_ListRSIName
public static final java.lang.String PNAME_ListIterName
public static final java.lang.String STR_LIST_ADD_NULL_NOWHERE
public static final java.lang.String STR_LIST_ADD_NULL_AT_START
public static final java.lang.String STR_LIST_ADD_NULL_AT_END
public static final java.lang.String PNAME_ComboAttrCount
public static final java.lang.String PNAME_ComboRowCount
public static final java.lang.String PNAME_MRUCount
public static final java.lang.String PNAME_MRUId
public static final java.lang.String PNAME_ListOperMode
public static final java.lang.String PNAME_ListDelimiter
public static final java.lang.String PNAME_ListServerBindingName
public static final java.lang.String PNAME_ListNullValueFlag
public static final java.lang.String PNAME_ListNullValueId
public static final java.lang.String PNAME_RowLevelBinds
public ListBindingDef(DefinitionManager defMgr, int defScope)
public ListBindingDef(ListBindingDef other)
public void init(java.util.HashMap initValues)
public void setParent(NamedObjectImpl parent)
DefinitionObject
setParent
in class DefinitionObject
parent
- the named object that is to be the parent of this object.public void copyFrom(ListBindingDef def)
public void setDisplayCriteriaName(java.lang.String name)
public void setAutoExecuteCriteria(boolean val)
public void setCriteriaShown(boolean val)
public java.lang.String getDisplayCriteriaName()
public boolean isAutoExecuteCriteria()
public boolean isCriteriaShown()
public boolean isStaticList()
public void setStaticList(boolean staticList)
public java.lang.String getListVOName()
public void setListVOName(java.lang.String voName)
public java.lang.String getDelimiter()
public void setDelimiter(java.lang.String de)
public java.lang.String[] getAttrExpressions()
public void setAttrExpressions(java.lang.String[] attrExprs)
public java.lang.String[] getAttrNames()
public void setAttrNames(java.lang.String[] attrNames)
public java.lang.String[] getDerivedAttrNames()
public void setDerivedAttrNames(java.lang.String[] derivedAttrNames)
public java.lang.String getListRSIName()
public void setListRSIName(java.lang.String listRSIName)
public java.lang.String[] getListAttrNames()
public void setListAttrNames(java.lang.String[] listAttrNames)
public java.lang.String[] getListDisplayAttrNames()
public void setListDisplayAttrNames(java.lang.String[] str)
public int getListRangeSize()
public void setListRangeSize(int listRangeSize)
public int getComboDisplayAttributeCount()
public int getComboDisplayRowCountHint()
public void setComboDisplayAttributeCount(int listRangeSize)
public void setComboDisplayRowCountHint(int listRangeSize)
public java.lang.Object[] getValueList()
public void setValueList(java.lang.Object[] valList)
public java.lang.String[] getLabelList()
public void setLabelList(java.lang.String[] list)
public java.lang.String getPreferredCriteriaName()
public void setPreferredCriteriaName(java.lang.String criteriaName)
public int getMRUCount()
public void setMRUCount(int count)
public boolean isMRUCountDefined()
public boolean getRowLevelBinds()
public void setRowLevelBinds(boolean bRowLevelBinds)
public int getNullValueFlag()
public void setNullValueFlag(int flag)
public java.lang.String getNullValueId()
public void setNullValueId(java.lang.String s)
public void setResourceBundleDef(ResourceBundleDef def)
public ResourceBundleDef getResourceBundleDef()
getResourceBundleDef
in interface ResourceBundleOwner
public java.lang.String getResourcePrefix()
getResourcePrefix
in interface ResourceBundleOwner
public java.lang.String getNullValueText(java.util.Locale locale)
public void setNullValueText(java.lang.String text)
public void loadFromXML(DefElement xmlElement)
public void writeChildren(DefWriter jos)
PersistentDefinition
writeChildren
in interface PersistentDefinition
writeChildren
in class PersistableDefObject
jos
- the Output storage for persistencepublic void writeContents(DefWriter jos)
PersistentDefinition
writeContents
in interface PersistentDefinition
writeContents
in class PersistableDefObject
jos
- the Output storage for persistencepublic DifferDetails diffContents(DiffMergeable docDef, DiffMergeable orgDef, DifferDetails difDetails)
DiffMergeable
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) {orgDefImpl = ( ) 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 DiffMergeable
diffContents
in class PersistableDefObject
docDef
- 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)
DiffMergeable
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.
diffChildren
in interface DiffMergeable
diffChildren
in class PersistableDefObject
docDef
- 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 DiffMergeable
applyDiffContents
in class PersistableDefObject
dif
- changes to be applied to 'this'
defresolver
- the diff resolver used in diff/merge operationpublic void applyDiffChildren(DifferDetails dif, DiffResolver resolver)
DiffMergeable
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(); 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
applyDiffChildren
in class PersistableDefObject
public static int convertListNullValueFlag(java.lang.String str)
public static java.lang.String convertListNullValueFlag(int nullValueFlag)
public static int convertToInt(java.lang.Object val)
public static boolean convertToBoolean(java.lang.Object val)
public static int[] convertToIntArray(java.lang.Object[] arr)
public static void readXMLString(DefElement xmlElement, java.lang.String name, java.util.HashMap valueTab)
public static void readXMLInt(DefElement xmlElement, java.lang.String name, java.util.HashMap valueTab)
public static void readXMLBoolean(DefElement xmlElement, java.lang.String name, java.util.HashMap valueTab)
public static void readXMLStringArray(DefElement xmlElement, java.lang.String name, java.util.HashMap valueTab)
public java.lang.String getDefXMLElementTag()
getDefXMLElementTag
in interface PersistentDefinition
getDefXMLElementTag
in class PersistableDefObject
@Concealed public RowSetIterator filterList(RowSetIterator listRSI, java.util.Map valuesMap, Row targetRow, ViewCriteria criteria, boolean exact, boolean checkForCase)
@Concealed public RowSetIterator filterAndApplyListWithCaseCheck(RowSetIterator listRSI, java.util.Map valuesMap, Row targetRow, ViewCriteria criteria, boolean exact, boolean checkForCase, boolean ignoreOper, boolean apply)
@Concealed public java.util.List<java.lang.String> getSelectedDisplayValues(RowSetIterator rsi, Row currentRow)
public void setMRUItems(java.util.List<java.util.List<java.lang.String>> vals)
public java.util.List<java.util.List<java.lang.String>> getMRUItems()