Oracle ADF Model and Business Components API Reference 10.1.2 B14022-01

oracle.jbo.server.rules
Class JboBaseValidator

java.lang.Object
  extended byoracle.jbo.rules.AbstractValidator
      extended byoracle.jbo.server.rules.JboBaseValidator
Direct Known Subclasses:
JboCompareValidator, JboListValidator, 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  java.lang.Object mLValue
           
protected  AttributeDefImpl mValidatingAttr
           
 
Fields inherited from class oracle.jbo.rules.AbstractValidator
mDescription, mErrorMessageClass, mMsgId, mValidatingAttrName
 
Constructor Summary
JboBaseValidator()
           
 
Method Summary
protected  void initialize()
           
protected  void raiseException(java.lang.Exception e, PropertyChangeEvent evObj)
           
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
convertToJava, getDescription, getErrorMessageClass, getErrorMsgId, getInverse, getValidatingAttributeName, setDescription, setErrorMessageClass, setErrorMsgId, setInverse, setValidatingAttributeName
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

mLValue

protected transient java.lang.Object mLValue

mValidatingAttr

protected AttributeDefImpl mValidatingAttr
Constructor Detail

JboBaseValidator

public JboBaseValidator()
Method Detail

initialize

protected void initialize()

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.

Oracle ADF Model and Business Components API Reference 10.1.2 B14022-01

 

Copyright © 1997, 2004, Oracle. All rights reserved.