public class ViewCriteriaImpl extends ViewCriteria implements DefPersistable, ValidationManager, DiffMergeable
ViewCriteria.NestedViewCriteriaRow
API_BASED_REQUIRED, BASE_QUERY_ALIAS_BASE, CLONED_VARIABLE, CRITERIA_MODE_CACHE, CRITERIA_MODE_QUERY, DEF_BASED_REQUIRED, FILTER_ENABLED, FILTER_FORCED, FIND_MODE, FIND_MODE_ITERATOR, INTERNAL_VC, INVOKE_TRIGGERS, listeners, mProperties, mSavedState, mVariableManager, NAMED_VARIABLE, NESTED_QUERY_ALIAS_BASE, NOT_REQUIRED, NULL_VALUE, RELATIVE_NAME, ROOT_VC_NAME, TEMP_VARIABLE, VC_APPLIEDFROMSAVEDSEARCH, VC_LAYOUTNAME, VC_PROP_USERDEFVONAME, VC_USAGE_BASED_REQUIRED
XML_STATEMENT
ITER_MODE_LAST_PAGE_FULL, ITER_MODE_LAST_PAGE_PARTIAL, SLOT_BEFORE_FIRST, SLOT_BEYOND_LAST, SLOT_DELETED, SLOT_VALID
VC_CONJ_AND, VC_CONJ_NOT, VC_CONJ_OR, VC_CONJ_UNION, VC_UPPER_COL_DEFAULT, VC_UPPER_COL_FALSE, VC_UPPER_COL_TRUE
Constructor and Description |
---|
ViewCriteriaImpl(DefinitionManager defMgr,
StructureDef structureDef) |
ViewCriteriaImpl(DefinitionManager defMgr,
StructureDef structureDef,
VariableManager voVariableManager) |
ViewCriteriaImpl(DefinitionManager defMgr,
ViewCriteria parent,
java.lang.String structDefFullName) |
Modifier and Type | Method and Description |
---|---|
void |
addValidator(JboValidatorInterface validator) |
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.
|
protected void |
cleanUpClonedBindVariables()
For internal use only.
|
void |
copyFrom(ViewCriteria vc)
For internal use only.
|
ViewCriteria |
createCriteria() |
ViewCriteriaRow |
createViewCriteriaRow()
Creates a new ViewCriteriaRow for this ViewCriteria.
|
ViewCriteriaUsage |
createViewCriteriaUsage()
Creates a View Criteria reference to an existing view criteria
|
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 . |
VariableValueManager |
getContextualVariableManager()
For internal use only.
|
DefinitionManager |
getDefManager() |
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 |
getFullName()
This method returns the Persistence reference of the object.
|
java.util.Hashtable |
getLocalAndResourceProperties()
Used by the marshaller to get all the properties and resources (on
the server side only) that are defined in this view criteria.
|
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() |
java.util.ArrayList |
getValidators() |
protected VariableManager |
getVoVariableManager()
For internal use only.
|
java.lang.String |
getXMLElementTag()
Returns a piece of static info for the type of object this is invoked
upon.
|
void |
initUniqueVCName() |
boolean |
isNew()
This method returns if this object is previously persisted.
|
void |
loadXMLContents(DefElement xmlElement) |
JboValidatorHints |
lookupValidator(java.lang.String name) |
void |
removeValidator(JboValidatorInterface validator) |
void |
removeValidatorWithName(java.lang.String name) |
void |
resolve(ViewCriteriaResolver resolver)
For internal use only.
|
void |
setNew(boolean b)
This method marks the as previously persisted.
|
void |
setOrigObject(DefPersistable oldObj) |
void |
setTempVariableManagerVC(ViewCriteria vc) |
void |
validate()
Deprecated.
|
void |
validate(java.util.HashMap whereParams)
Deprecated.
since 12.1.1.0
|
void |
validate(VariableValueManager vMgr)
Performs view criteria item required and selectively required validation.
|
void |
validateRow(ViewCriteriaRow row,
java.util.HashMap whereParams)
Deprecated.
since 12.1.1.0
|
void |
validateRow(ViewCriteriaRow row,
VariableValueManager vMgr) |
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
|
activate, add, add, addAll, addAll, addElement, addListener, addRow, addTableAliasSuffix, clausesCacheDisabled, clear, convertArrayToMap, convertMapToArray, convertVarMapToVarMgr, createAndInitRow, createKey, createNestedCriteriaRow, createRow, createSimpleRow, criteriaChanged, ensureVariableManager, enumerateRowsInRange, findByAltKey, findByEntity, findByKey, findByViewCriteria, findElementByName, findElementWithRelativeName, findViewCriteriaItem, first, forceFiltering, get1013CompatibilityMode, getAllBindVariables, getAllBindVariables, getAllBindVariablesInternal, getAllBindVariablesInternal, getAllRowsInRange, getAttrHintsPDefViewObject, getAttributeIndexOf, getClauses, getConjunction, getCriteriaAlias, getCriteriaMode, getCurrentRow, getCurrentRowIndex, getCurrentRowSlot, getDisplayName, getElementProperties, getExtendedDataForVarName, getExtendedDataOffset, getFetchedRowCount, getIterMode, getKeepExtendedDataOffset, getLayoutName, getListenersList, getLocale, getLocaleName, getMessageBundleClass, getName, getNestedViewCriteria, getParent, getParentViewCriteria, getProperties, getProperties, getProperty, getProperty, getRangeIndexOf, getRangeSize, getRangeStart, getRawPropertyValue, getRequiredInternal, getResourceBundleDef, getResourcesFromBundle, getRootCriteriaRelativeName, getRootViewCriteria, getRow, getRowAtRangeIndex, getRowCount, getRowCountInRange, getRows, getSavedVariables, getStructureDef, getStructureDefFullName, getUpperColumnsValue, getUsedAttributeNames, getUsedViewAttributes, getVariableManager, getViewCriteriaManager, getViewObject, getViewObject, hasData, hasNext, hasPrevious, hasTransientAttrs, hasVariables, initializeFiltering, initName, insertElementAt, insertRow, insertRowAtRangeIndex, isAppliedIfJoinSatisfied, isCriteriaForQuery, isCriteriaForRowMatch, isDirty, isFilterEnabled, isFilterForced, isInternal, isItemHolder, isNamedVariableBelongs, isRangeAtBottom, isRangeAtTop, isRequired, isRowValidation, isSearchAppliedCriteria, isSubQueryAliasEnabled, isTemporaryVariable, isTemporaryVariableBelongs, isTemporaryVariableOfKind, isUpperColumns, isUseAttributeFormatHint, isUseBindVarsOnly, isViewCriteriaTypeVariable, last, loadVOBindVariables, mergeFrom, next, passivate, passivateElementProperties, previous, putCriteriaAlias, putDefaultCriteriaAlias, refreshProperty, remove, remove, removeAll, removeAllElements, removeCurrentRow, removeCurrentRowAndRetain, removeCurrentRowFromCollection, removeElement, removeElementAt, removeListener, removeProperty, removeRange, removeReferenceFromNamedBindVars, removeRow, reset, resetCriteria, retainAll, saveState, scrollRange, scrollRangeTo, scrollToRangePage, set, set1013CompatibilityMode, setAppliedIfJoinSatisfied, setAttrHintsPDefViewObject, setClauses, setConjunction, setConjunctionOnChildren, setCriteriaForQuery, setCriteriaMode, setCurrentRow, setCurrentRowAtRangeIndex, setDirty, setElementAt, setExtendedDataForVarName, setExtendedDataOffset, setIterMode, setKeepExtendedDataOffset, setName, setParent, setProperties, setProperty, setRangeSize, setRangeStart, setRequired, setRequiredInternal, setRowValidation, setSavedValuesInVariableMgr, setSavedVariables, setStructureDefFullName, setSubQueryAliasEnabled, setUpperColumns, setUseAttributeFormatHint, setUseBindVarsForLiterals, setVariableManager, setViewCriteriaManager, setViewObject, toString, trimNoDataRows, useBindVar, useBindVarsOnly
capacity, clone, contains, containsAll, copyInto, elementAt, elements, ensureCapacity, equals, firstElement, forEach, get, hashCode, indexOf, indexOf, isEmpty, iterator, lastElement, lastIndexOf, lastIndexOf, listIterator, listIterator, removeIf, replaceAll, setSize, size, sort, spliterator, subList, toArray, toArray, trimToSize
finalize, getClass, notify, notifyAll, wait, wait, wait
isDirty, setDirty
getName, getResourceBundleDef
public ViewCriteriaImpl(DefinitionManager defMgr, StructureDef structureDef)
public ViewCriteriaImpl(DefinitionManager defMgr, StructureDef structureDef, VariableManager voVariableManager)
public ViewCriteriaImpl(DefinitionManager defMgr, ViewCriteria parent, java.lang.String structDefFullName)
public void initUniqueVCName()
public void copyFrom(ViewCriteria vc)
ViewCriteria
copyFrom
in class ViewCriteria
vc
- the view criteria that needs to be copiedpublic ViewCriteria createCriteria()
createCriteria
in class ViewCriteria
ViewCriteria.add(Object)
needs
to be invoked to make the returned instance a nested view criteriapublic ViewCriteriaRow createViewCriteriaRow()
ViewCriteria
createViewCriteriaRow
in class ViewCriteria
ViewCriteriaRow
, an array for WHERE clause criteria.ViewCriteriaRow
public ViewCriteriaUsage createViewCriteriaUsage()
ViewCriteria
createViewCriteriaUsage
in class ViewCriteria
ViewCriteriaUsaga
instance that contains the
the information needed to resolve the view criteriaViewCriteriaUsage
public DefinitionManager getDefManager()
protected VariableManager getVoVariableManager()
ViewCriteria
getVoVariableManager
in class ViewCriteria
public boolean isNew()
DefPersistable
isNew
in interface DefPersistable
public void setNew(boolean b)
DefPersistable
setNew
in interface DefPersistable
b
- If true the Object is marked as new object.public DefPersistable getOrigObject()
getOrigObject
in interface DefPersistable
public void setOrigObject(DefPersistable oldObj)
setOrigObject
in interface DefPersistable
public java.lang.String getFullName()
DefPersistable
getFullName
in interface DefPersistable
getFullName
in interface ValidationManager
public java.lang.String getMergeableName()
DiffMergeable
getMergeableName
in interface DiffMergeable
public java.lang.String getMergeableFullName()
DiffMergeable
getMergeableFullName
in interface DiffMergeable
public java.util.Hashtable getLocalAndResourceProperties()
getLocalAndResourceProperties
in class ViewCriteria
public void writeObject(DefWriter jos)
PersistentDefinition
writeObject
in interface PersistentDefinition
jos
- the Output storage for persistencepublic void writeContents(DefWriter jos)
PersistentDefinition
writeContents
in interface PersistentDefinition
jos
- the Output storage for persistencepublic void writeChildren(DefWriter jos)
PersistentDefinition
writeChildren
in interface PersistentDefinition
jos
- the Output storage for persistencepublic void loadXMLContents(DefElement xmlElement)
public void resolve(ViewCriteriaResolver resolver)
ViewCriteria
resolve
in class ViewCriteria
resolver
- used to locate the structure defpublic java.lang.String getXMLElementTag()
PersistentDefinition
getXMLElementTag
in interface PersistentDefinition
public java.lang.String getDefXMLElementTag()
getDefXMLElementTag
in interface PersistentDefinition
public java.lang.String getDefTypeName()
DiffMergeable
getDefTypeName
in interface DiffMergeable
public java.lang.String getDefXMLNameSpace()
getDefXMLNameSpace
in interface PersistentDefinition
public void addValidator(JboValidatorInterface validator)
addValidator
in interface ValidationManager
public void removeValidator(JboValidatorInterface validator)
public void removeValidatorWithName(java.lang.String name)
public java.util.ArrayList getValidators()
getValidators
in interface ValidationManager
public JboValidatorHints lookupValidator(java.lang.String name)
public void validate()
validate
in class ViewCriteria
public void validate(java.util.HashMap whereParams)
validate
in class ViewCriteria
whereParams
- A Map of public void validate(VariableValueManager vMgr)
ViewCriteria
validate
in class ViewCriteria
public void validateRow(ViewCriteriaRow row, java.util.HashMap whereParams)
public void validateRow(ViewCriteriaRow row, VariableValueManager vMgr)
public void setTempVariableManagerVC(ViewCriteria vc)
public VariableValueManager getContextualVariableManager()
ViewCriteria
getContextualVariableManager
in class ViewCriteria
public DifferDetails ensureDifferDetails(DifferDetails difDetails)
DiffMergeable
DifferDetails
.
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 DiffMergeable
difDetails
- the incoming DifferDetails
. It may
be null
.difDetails
if it wasn't
null
coming in, or a new DifferDetails
if
the incoming difDetails
was null
public 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
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
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 beginDiffObjects(DiffMergeable docDef, DiffMergeable orgDef, DifferDetails difDetails)
DiffMergeable
DiffMergeable
's. 'this'
object is the
changed definition.
beginDiffObjects
in interface DiffMergeable
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 diffObjects(DiffMergeable docDef, DiffMergeable orgDef, DifferDetails difDetails)
DiffMergeable
diffContents
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 DiffMergeable
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
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
protected void cleanUpClonedBindVariables()
ViewCriteria
cleanUpClonedBindVariables
in class ViewCriteria