oracle.jbo.rules

Class JboExpressionValidator

java.lang.Object

oracle.jbo.common.NamedObjectImpl

oracle.jbo.rules.AbstractValidator

oracle.jbo.rules.JboAbstractValidator

oracle.jbo.rules.JboExpressionValidator

All Implemented Interfaces:

ComponentOperationsManager, DiffMergeable, DefPersistable, PersistentDefinition, OperationContainer, JboExprValidator, JboValidatorHints, JboValidatorInterface, ValidatorConstants, VariableManagerOwner, VariableManagerOwnerBase

public class JboExpressionValidator
extends JboAbstractValidator
implements JboExprValidator

Nested Class Summary

Nested classes/interfaces inherited from interface oracle.jbo.rules.ValidatorConstants

ValidatorConstants.MessageFlavor

Field Summary

Fields inherited from class oracle.jbo.rules.JboAbstractValidator

mValidatingAttr

Fields inherited from class oracle.jbo.rules.AbstractValidator

mbInverse, mDescription, mErrorMessageClass, mMsgId, mMsgIds, mResourceBundleId, mTriggeringAttributeNames, mTriggeringAttributes, mValidatingAttrName

Fields inherited from class oracle.jbo.common.NamedObjectImpl

mFullName, mObjName, mParent, mProperties, RES_ID_SUFFIX, RESID_SUFFIX

Fields inherited from interface oracle.jbo.rules.ValidatorConstants

ATTR, ATTR_STR, BETWEEN, EO, EO_STR, EQUALTO, EXPR, EXPR_STR, GREATERTHAN, GREATERTHANEQUALTO, JBO, JBO_STR, LESSTHAN, LESSTHANEQUALTO, LITERAL, LITERAL_STR, MANDATORY_STR, mCompOperTypeVals, mRhsTypeVals, mSeverityVals, NOTEQUALTO, PNAME_CompareLength, PNAME_CompareType, PNAME_CompareValue, PNAME_DataType, PNAME_Description, PNAME_ErrorMessageExpressions, PNAME_ErrorMessageId, PNAME_ErrorMessageIds, PNAME_Exposed, PNAME_ExprValueSupplier, PNAME_ForPersonalization, PNAME_Inverse, PNAME_MessageFlavor, PNAME_Name, PNAME_OnAttribute, PNAME_OnAttributes, PNAME_OnCondition, PNAME_OperandType, PNAME_Severity, PNAME_Subtype, PNAME_TransactionLevel, PNAME_TransientExpression, PNAME_Trigger, PNAME_ValidationBeanClass, PNAME_ValName, PNAME_xmlns, PRECISION_SCALE_STR, SEVERITY_ERROR, SEVERITY_RECOVERABLE_ERROR_INDEX, SEVERITY_VETOABLE_WARNING, SEVERITY_WARNING, SQL, SQL_STR, TRIGGER_SUBTYPE_PREFIX, VALIDATION_XMLNS, VALIDATOR_MSG_ID_PREFIX, VO, VO_STR, VO_USAGE, VO_USAGE_STR

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

XML_STATEMENT

Constructor Summary

Constructors

Constructor and Description
JboExpressionValidator()
JboExpressionValidator(boolean inverse, java.lang.String expr)

Method Summary

Modifier and Type	Method and Description
void	applyDiffChildren(DifferDetails dif, DiffResolver resolver) Applies changes to children defs.
java.lang.Object	clone()
DifferDetails	diffChildren(DiffMergeable docDef, DiffMergeable orgDef, DifferDetails difDetails) Performs diff of children defs.
ExprCodeSource	getCodeSource()
java.lang.String	getDefXMLElementTag()
java.lang.String	getExpression()
java.lang.String	getExpressionClassName()
ExpressionDef	getExpressionDef()
boolean	getExpressionHasReturn()
ExprEval.Privilege	getExpressionPrivilege()
ExprEval.TrustMode	getExpressionTrustMode() For Internal Framework Use Only.
java.lang.String	getOwnerName() For internal framework use only
void	initValidatorProperties(java.util.HashMap props)
void	loadXMLContents(DefElement elem)
void	resolve(ValidationManager owner, StructureDef structDef, PersistableDefObject defObj)
void	setExpression(java.lang.String expr) Deprecated. use setExpressionDef(oracle.jbo.common.ExpressionDef) instead.
void	setExpressionDef(ExpressionDef exprDef)
void	setExpressionHasReturn(boolean ret)
void	setExpressionPrivilege(ExprEval.Privilege pr)
void	setExpressionTrustMode(ExprEval.TrustMode trusted) For Internal Framework Use Only.
void	setTriggerType(TriggerType type) Deprecated.
void	setTriggerTypeString(java.lang.String type)
void	setTypeCheckedMode(ExprEval.TypeCheckedMode typeCheckedMode)
void	validate(JboValidatorContext evObj) Tests the validity of the object/value as described in the validator context.
boolean	validateValue(java.lang.Object value) Validates a value.
boolean	validateValueWithContext(JboValidatorContext evObj, java.lang.Object value) Called internally by the framework with validation OnCondition is true or there is no validation OnCondition.
void	writeChildren(DefWriter jos) Writes the Object's children to the Persistent storage

Methods inherited from class oracle.jbo.rules.JboAbstractValidator

applyValidatorPersonalization, closeObject, createException, diffContents, editCodeSource, ensureCodeSource, getDefXMLNameSpace, getErrorMsgId, getErrorReportAttrDef, getFullName, getImageLoc, getMessageFlavor, getName, getOperationDefinitions, getOrigObject, getRowOperationDefinitions, getTriggeringAttributeDefs, getValidatingAttributeName, getValidatorType, getValueToValidate, getXMLElementTag, initialize, isForPersonalization, isReadOnly, lookupExprDef, raiseException, setForPersonalization, setInitialized, setMessageFlavor, setName, setNewValue, setOrigObject, setValidatingAttribute, setValidatingAttribute, validateMany, writeContents, writeObject

Methods inherited from class oracle.jbo.rules.AbstractValidator

applyDiffContents, applyValidatorPersonalization, beginDiffObjects, convertToJava, copyErrorMsgInfo, createAttributeException, createExprValueSupplier, createRowException, diffObjects, ensureDifferDetails, ensureVariableManager, getDefTypeName, getDescription, getErrorMessageClass, getErrorMsgExpressionDefs, getErrorMsgExpressions, getErrorMsgIds, getExprIdentifier, getExprValueSupplierType, getInverse, getMergeableFullName, getMergeableName, getMessageBundleClass, getOnCondition, getOnConditionDef, getOwner, getResourceBundleDef, getResourceBundleId, getSeverity, getTriggeringAttributeNames, getTriggerType, getValidatorSubType, getVariableManager, hasErrorMsg, hasValidationCondition, hasVariables, initErrMsgParms, initTriggeringAttributeDefs, isDirty, isMovedToAttrLevel, isNew, isTransactionLevel, isTransactionLevel, isValidatable, loadVariables, lookupMessageDef, parseSeverityStr, prepareException, raiseException, readStringArrayList, readTransientExpression, readTransientExpression, readUserObject, readUserObject, readUserObjectTrim, readUserObjectTrim, readUserStringElementsMap, setDefaultDescription, setDescription, setDirty, setErrorMessageClass, setErrorMsgExpressionDefs, setErrorMsgExpressions, setErrorMsgId, setErrorMsgIds, setExprValueSupplierType, setInverse, setNew, setOnCondition, setResourceBundleDef, setResourceBundleId, setSeverity, setTransactionLevel, setTriggeringAttributeNames, setValidatingAttributeName, setValidatorSubType

Methods inherited from class oracle.jbo.common.NamedObjectImpl

allocatePropertyMap, getAllProperties, getParent, getProperties, getPropertiesAsStrings, getPropertiesMap, getProperty, getProperty, getPropertyExpressionDef, getPropertyExpressionsMap, getPropertyMap, getPropertyNamesSet, getRawPropertyValue, getResourcesFromBundle, getStringFromMessageBundle, isPropertyExpression, mergePropertyMap, refreshProperty, removeProperty, removeProperty, requiresNamePrefixedResId, resolveObjectProperty, resolvePropertyRaw, setFullName, setParent, setPropertiesMap, setPropertiesMap2, setProperty, setProperty, setPropertyExpression, setPropertyMap

Methods inherited from class java.lang.Object

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

Methods inherited from interface oracle.jbo.rules.JboValidatorHints

getTriggeringAttributeNames, isTransactionLevel

Methods inherited from interface oracle.jbo.rules.JboValidatorInterface

getDescription, setDescription

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

isDirty, isNew, setDirty, setNew

Constructor Detail

JboExpressionValidator

public JboExpressionValidator()

JboExpressionValidator

@Concealed
public JboExpressionValidator(boolean inverse,
                                         java.lang.String expr)

For internal use only. Application developers should not use this

Method Detail

clone

public java.lang.Object clone()

Overrides:

clone in class JboAbstractValidator

getExpression

public java.lang.String getExpression()

Specified by:

getExpression in interface JboExprValidator

getExpressionClassName

@Concealed
public java.lang.String getExpressionClassName()

For internal use only. Application developers should not use this

getCodeSource

@Concealed
public ExprCodeSource getCodeSource()

For internal use only. Application developers should not use this

setExpression

public void setExpression(java.lang.String expr)

Deprecated. use setExpressionDef(oracle.jbo.common.ExpressionDef) instead.

getExpressionDef

public ExpressionDef getExpressionDef()

Specified by:

getExpressionDef in interface JboExprValidator

setExpressionDef

public void setExpressionDef(ExpressionDef exprDef)

getExpressionPrivilege

public ExprEval.Privilege getExpressionPrivilege()

setExpressionPrivilege

public void setExpressionPrivilege(ExprEval.Privilege pr)

getExpressionTrustMode

@Concealed
public ExprEval.TrustMode getExpressionTrustMode()

For Internal Framework Use Only.

For internal use only. Application developers should not use this

setExpressionTrustMode

@Concealed
public void setExpressionTrustMode(ExprEval.TrustMode trusted)

For Internal Framework Use Only.

For internal use only. Application developers should not use this

setTypeCheckedMode

public void setTypeCheckedMode(ExprEval.TypeCheckedMode typeCheckedMode)

getExpressionHasReturn

public boolean getExpressionHasReturn()

setExpressionHasReturn

public void setExpressionHasReturn(boolean ret)

validateValue

public boolean validateValue(java.lang.Object value)

Description copied from class: JboAbstractValidator

Validates a value.

Subclasses must implement this method.

Specified by:

validateValue in class JboAbstractValidator

Parameters:

value - the object to be validated.

Returns:

true if the object is valid.

validateValueWithContext

public boolean validateValueWithContext(JboValidatorContext evObj,
                                        java.lang.Object value)

Description copied from class: JboAbstractValidator

Called internally by the framework with validation OnCondition is true or there is no validation OnCondition. This method should not be directly invoked in applications.

Overrides:

validateValueWithContext in class JboAbstractValidator

setTriggerType

@Concealed
public void setTriggerType(TriggerType type)

Deprecated.

For internal framework use only

For internal use only. Application developers should not use this

setTriggerTypeString

@Concealed
public void setTriggerTypeString(java.lang.String type)

Overrides:

setTriggerTypeString in class AbstractValidator

For internal use only. Application developers should not use this

getOwnerName

@Concealed
public java.lang.String getOwnerName()

For internal framework use only

For internal use only. Application developers should not use this

validate

public void validate(JboValidatorContext evObj)

Description copied from interface: JboValidatorInterface

Tests the validity of the object/value as described in the validator context.

Specified by:

validate in interface JboValidatorInterface

Overrides:

validate in class JboAbstractValidator

Parameters:

evObj - the validator context

initValidatorProperties

public void initValidatorProperties(java.util.HashMap props)

Specified by:

initValidatorProperties in interface JboValidatorHints

Overrides:

initValidatorProperties in class AbstractValidator

loadXMLContents

public void loadXMLContents(DefElement elem)

Overrides:

loadXMLContents in class JboAbstractValidator

resolve

public void resolve(ValidationManager owner,
                    StructureDef structDef,
                    PersistableDefObject defObj)

Specified by:

resolve in interface JboValidatorHints

Overrides:

resolve in class JboAbstractValidator

getDefXMLElementTag

public java.lang.String getDefXMLElementTag()

Specified by:

getDefXMLElementTag in interface PersistentDefinition

Overrides:

getDefXMLElementTag in class AbstractValidator

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 AbstractValidator

Parameters:

jos - the Output storage for persistence

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 AbstractValidator

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();

          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 AbstractValidator