oracle.jbo.rules
Class JboRegExpValidator

java.lang.Object
  oracle.jbo.rules.AbstractValidator
      oracle.jbo.rules.JboAbstractValidator
          oracle.jbo.rules.JboRegExpValidator

All Implemented Interfaces:

DefPersistable, PersistentDefinition, JboValidatorHints, JboValidatorInterface, ValidatorConstants, VariableManagerOwner, VariableManagerOwnerBase

public class JboRegExpValidator
extends JboAbstractValidator

A validator that tests attribute values by comparing them with a pre-defined regular expression.

The value to be validated is designated as the left-hand operand of a relation operation. The validator provides the right-hand operand

Since:

Jdeveloper 3.0

Field Summary

protected java.lang.String	mFlagValue
protected java.lang.String	mPattern
static java.lang.String	REGEX_CANON_EQ_TEXT
static java.lang.String	REGEX_CASE_INSENSITIVE_TEXT
static java.lang.String	REGEX_DOTALL_TEXT
static java.lang.String	REGEX_MULTILINE_TEXT
static java.lang.String	REGEX_UNICODE_CASE_TEXT

Fields inherited from class oracle.jbo.rules.JboAbstractValidator

mValidatingAttr

Fields inherited from class oracle.jbo.rules.AbstractValidator

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

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, PNAME_CompareLength, PNAME_CompareType, PNAME_CompareValue, PNAME_DataType, PNAME_ErrorMessageExpressions, PNAME_ErrorMessageId, PNAME_ErrorMessageIds, PNAME_Exposed, PNAME_ForPersonalization, PNAME_Inverse, PNAME_Name, PNAME_OnAttribute, PNAME_OnAttributes, PNAME_OnCondition, PNAME_OperandType, PNAME_Severity, PNAME_Subtype, PNAME_TransactionLevel, PNAME_TransientExpression, 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

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

XML_STATEMENT

Constructor Summary

JboRegExpValidator()
Creates an uninitialized regular expression validator.

JboRegExpValidator(boolean inverse, java.lang.String patternArg, java.lang.String flagValueArg)
Creates an initialized regular expression validator.

Method Summary

java.lang.String	getDefXMLElementTag()
java.lang.String	getFlagValue() Gets the match flags for the regular expression comparison.
protected static int	getKeyValue(java.lang.String flagValue, java.lang.String keyString, int keyValue) Internal:
java.lang.String	getPattern() Gets the right-side operand of this validator's expression.
static int	getRegExpFlagInt(java.lang.String flagStr) Gets the computed int value of the regular expression match flags.
protected void	initialize(JboValidatorContext evObj)
void	initValidatorProperties(java.util.HashMap props)
void	loadXMLContents(DefElement elem)
void	setFlagValue(java.lang.String flagValueArg) Sets the match flags for the regular expression comparison.
void	setPattern(java.lang.String patternArg) Sets the right-side operand of this validator's expression.
java.lang.String	toString() Internal: For debugging purposes only.
boolean	validateValue(java.lang.Object value) Validate an object by matching it with a pre-defined regular expression.
void	writeContents(DefWriter jos) Objects should write their persistence output in this method

Methods inherited from class oracle.jbo.rules.JboAbstractValidator

applyValidatorPersonalization, clone, closeObject, getDefXMLNameSpace, getErrorMsgId, getErrorReportAttrDef, getFullName, getImageLoc, getName, getOrigObject, getTriggeringAttributeDefs, getValidatingAttributeName, getValueToValidate, getXMLElementTag, isForPersonalization, isReadOnly, raiseException, resolve, setForPersonalization, setInitialized, setName, setNewValue, setOrigObject, setValidatingAttribute, setValidatingAttribute, validate, validateMany, validateValueWithContext, writeObject

Methods inherited from class oracle.jbo.rules.AbstractValidator

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

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, 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

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

writeChildren

Field Detail

REGEX_CASE_INSENSITIVE_TEXT

public static final java.lang.String REGEX_CASE_INSENSITIVE_TEXT

See Also:

Constant Field Values

REGEX_MULTILINE_TEXT

public static final java.lang.String REGEX_MULTILINE_TEXT

See Also:

Constant Field Values

REGEX_DOTALL_TEXT

public static final java.lang.String REGEX_DOTALL_TEXT

See Also:

Constant Field Values

REGEX_UNICODE_CASE_TEXT

public static final java.lang.String REGEX_UNICODE_CASE_TEXT

See Also:

Constant Field Values

REGEX_CANON_EQ_TEXT

public static final java.lang.String REGEX_CANON_EQ_TEXT

See Also:

Constant Field Values

mPattern

protected java.lang.String mPattern

mFlagValue

protected java.lang.String mFlagValue

Constructor Detail

JboRegExpValidator

public JboRegExpValidator()

Creates an uninitialized regular expression validator.

The method setPattern() must be invoked before validation can be performed.

JboRegExpValidator

public JboRegExpValidator(boolean inverse,
                          java.lang.String patternArg,
                          java.lang.String flagValueArg)

Creates an initialized regular expression validator.

Parameters:

inverse - if true the logic of this validator's comparison relation is inverted.

patternArg - this validator's right-hand operand, a reference object containing a regular expression.

flagValueArg - validator's match flags

Method Detail

initialize

protected void initialize(JboValidatorContext evObj)

Overrides:

initialize in class JboAbstractValidator

validateValue

public boolean validateValue(java.lang.Object value)

Validate an object by matching it with a pre-defined regular expression.

The value parameter is the left-hand operand of this validator's regular expression comparison relation. The right-hand operand is the value set by setPattern().

This method is called by AbstractValidator#vetoableChange().

Specified by:

validateValue in class JboAbstractValidator

Parameters:

value - the object to be validated.

Returns:

true if the relation holds, or false if the relation does not hold or operand is invalid or uninitialized.

setPattern

public void setPattern(java.lang.String patternArg)

Sets the right-side operand of this validator's expression.

Parameters:

patternArg - a reference object containing a regular expression.

getPattern

public java.lang.String getPattern()

Gets the right-side operand of this validator's expression.

setFlagValue

public void setFlagValue(java.lang.String flagValueArg)

Sets the match flags for the regular expression comparison.

Parameters:

flagValueArg - a reference object containing String representation of the match flags.

getFlagValue

public java.lang.String getFlagValue()

Gets the match flags for the regular expression comparison.

toString

public java.lang.String toString()

Internal: For debugging purposes only.

Overrides:

toString in class java.lang.Object

getRegExpFlagInt

public static int getRegExpFlagInt(java.lang.String flagStr)

Gets the computed int value of the regular expression match flags.

getKeyValue

protected static int getKeyValue(java.lang.String flagValue,
                                 java.lang.String keyString,
                                 int keyValue)

Internal:

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

getDefXMLElementTag

public java.lang.String getDefXMLElementTag()

Specified by:

getDefXMLElementTag in interface PersistentDefinition

Specified by:

getDefXMLElementTag in class JboAbstractValidator

writeContents

public void writeContents(DefWriter jos)

Description copied from interface: PersistentDefinition

Objects should write their persistence output in this method

Specified by:

writeContents in interface PersistentDefinition

Overrides:

writeContents in class JboAbstractValidator

Parameters:

jos - the Output storage for persistence