oracle.jbo.server.rules
Class JboBaseValidator

java.lang.Object
  oracle.jbo.common.NamedObjectImpl
      oracle.jbo.rules.AbstractValidator
          oracle.jbo.server.rules.JboBaseValidator

All Implemented Interfaces:

ValidatorConstants, VariableManagerOwner, VariableManagerOwnerBase

Direct Known Subclasses:

JboCompareValidator, JboListValidator, JboMethodValidator, JboRangeValidator

public abstract class JboBaseValidator
extends AbstractValidator

The superclass for all pre-defined validators.

This class implements the basic functionality of storing the value of either an attribute to be validated, or the entity or application module reference on which validation is to be invoked. Subclasses must provide validateValue, which performs the actual validation test.

Since:

Jdeveloper 3.0

Field Summary

protected int	mBindingStyle
protected AttributeDefImpl	mValidatingAttr
protected java.lang.String	mValidatingAttrName

Fields inherited from class oracle.jbo.rules.AbstractValidator

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

Fields inherited from class oracle.jbo.common.NamedObjectImpl

mFullName, mObjName, mParent, mProperties, RES_ID_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_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, SEVERITY_VETOABLE_WARNING, SEVERITY_WARNING, SQL, SQL_STR, VALIDATION_XMLNS, VALIDATOR_MSG_ID_PREFIX, VO, VO_STR, VO_USAGE, VO_USAGE_STR

Constructor Summary

JboBaseValidator()

Method Summary

protected java.lang.Object	extractValueToValidate(PropertyChangeEvent evObj)
int	getBindingStyle()
protected void	initialize()
void	loadXMLContents(DefElement elem)
protected void	raiseException(java.lang.Exception e, PropertyChangeEvent evObj)
void	resolve(ValidationManager owner, StructureDef structDef, PersistableDefObject defObj)
void	setBindingStyle(int bindingStyle)
protected void	setNewValue(java.lang.Object newValue) When the newValue is an Entity, get the attribute's value by using the getAttribute method on the entity.
void	setValidatingAttribute(AttributeDefImpl attr) Sets the validating attribute.
void	setValidatingAttribute(EntityDefImpl beanInfo, java.lang.String str) Sets the validating attribute by name.
abstract boolean	validateValue(java.lang.Object value) Validates an object.
void	vetoableChange(PropertyChangeEvent evObj) Invokes validateValue() on a value contained in a constrained property.

Methods inherited from class oracle.jbo.rules.AbstractValidator

applyValidatorPersonalization, clone, convertToJava, copyErrorMsgInfo, createException, createExprValueSupplier, ensureVariableManager, getDescription, getErrorMessageClass, getErrorMsgExpressions, getErrorMsgId, getErrorMsgIds, getExprValueSupplierType, getFullName, getInverse, getMessageBundleClass, getName, getOnCondition, getOwner, getResourceBundleDef, getResourceBundleId, getSeverity, getTriggeringAttributeDefs, getTriggeringAttributeNames, getValidatingAttributeName, getValidatorSubType, getVariableManager, hasErrorMsg, hasValidationCondition, hasVariables, initErrMsgParms, initTriggeringAttributeDefs, initValidatorProperties, isDirty, isMovedToAttrLevel, isNew, isTransactionLevel, isTransactionLevel, isValidatable, loadVariables, parseSeverityStr, prepareException, raiseException, raiseException, readStringArrayList, readTransientExpression, readUserObject, readUserObject, readUserObjectTrim, readUserObjectTrim, readUserStringElementsMap, setDefaultDescription, setDescription, setDirty, setErrorMessageClass, setErrorMsgExpressions, setErrorMsgId, setErrorMsgIds, setExprValueSupplierType, setInverse, setNew, setOnCondition, setResourceBundleDef, setResourceBundleId, setSeverity, setTransactionLevel, setTriggeringAttributeNames, setValidatingAttributeName, writeChildren, writeContents

Methods inherited from class oracle.jbo.common.NamedObjectImpl

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

Methods inherited from class java.lang.Object

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

Field Detail

mValidatingAttr

protected AttributeDefImpl mValidatingAttr

mValidatingAttrName

protected java.lang.String mValidatingAttrName

mBindingStyle

protected int mBindingStyle

Constructor Detail

JboBaseValidator

public JboBaseValidator()

Method Detail

initialize

protected void initialize()

extractValueToValidate

protected java.lang.Object extractValueToValidate(PropertyChangeEvent evObj)

vetoableChange

public void vetoableChange(PropertyChangeEvent evObj)
                    throws JboException

Invokes validateValue() on a value contained in a constrained property.

.

Parameters:

evObj - a PropertyChangeEvent containing a property to be validated.

Throws:

JboException - if validation fails, with CSMessageBundle error code EXC_VAL_ATTR_SET_FAILED.

raiseException

protected void raiseException(java.lang.Exception e,
                              PropertyChangeEvent evObj)

validateValue

public abstract boolean validateValue(java.lang.Object value)
                               throws java.lang.Exception

Validates an object.

Subclasses must implement this method.

Parameters:

value - the object to be validated.

Returns:

true if the object is valid.

Throws:

java.lang.Exception - if validation cannot be performed.

setNewValue

protected void setNewValue(java.lang.Object newValue)
                    throws java.lang.Exception

When the newValue is an Entity, get the attribute's value by using the getAttribute method on the entity. Otherwise, newValue should be a value to compare in this validator.

Parameters:

newValue - either the attribute's value or a value to use to compare in the validator.

Throws:

java.lang.Exception

setValidatingAttribute

public void setValidatingAttribute(AttributeDefImpl attr)

Sets the validating attribute.

Parameters:

attr - an attribute.

setValidatingAttribute

public void setValidatingAttribute(EntityDefImpl beanInfo,
                                   java.lang.String str)

Sets the validating attribute by name.

This variant is used when the validator is attached to an entity, rather than to an attribute.

Parameters:

beanInfo - the entity containing the attribute.

str - an attribute name as a string.

getBindingStyle

public int getBindingStyle()

setBindingStyle

public void setBindingStyle(int bindingStyle)

loadXMLContents

public void loadXMLContents(DefElement elem)

Overrides:

loadXMLContents in class AbstractValidator

resolve

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

Overrides:

resolve in class AbstractValidator