org.jminor.framework.domain

Class Domain.Validator

java.lang.Object

org.jminor.common.db.valuemap.DefaultValueMap.DefaultValidator<Property,Entity>

org.jminor.framework.domain.Domain.Validator

All Implemented Interfaces:

java.io.Serializable, ValueMap.Validator<Property,Entity>, Entity.Validator

Enclosing class:

Domain

public static class Domain.Validator
extends DefaultValueMap.DefaultValidator<Property,Entity>
implements Entity.Validator

A default Entity.Validator implementation providing null validation for properties marked as not null, range validation for numerical properties with max and/or min values specified and string length validation based on the specified max length. This Validator can be extended to provide further validation.

See Also:

Property.Builder#setNullable(boolean), Property.Builder#setMin(double), Property.Builder#setMax(double), Property.Builder#setMaxLength(int), Serialized Form

Constructor Summary

Constructors

Constructor and Description
Validator() Instantiates a new Entity.Validator
Validator(boolean performNullValidation) Instantiates a new Entity.Validator

Method Summary

Modifier and Type	Method and Description
boolean	isNullable(Entity entity, Property property) Returns true if the given property accepts a null value for the given entity, by default this method simply returns property.isNullable()
void	performLengthValidation(Entity entity, Property property) Performs a length validation on the given string based property
void	performNullValidation(Entity entity, Property property) Performs a null validation on the given property
void	performRangeValidation(Entity entity, Property property) Performs a range validation on the given number based property
void	validate(java.util.Collection<Entity> entities) Validates all writable properties in the given entities
void	validate(Entity entity) Validates all writable properties in the given entity
void	validate(Entity entity, Property property) Checks if the value associated with the give key is valid, throws a ValidationException if not

Methods inherited from class org.jminor.common.db.valuemap.DefaultValueMap.DefaultValidator

addRevalidationListener, isValid, removeRevalidationListener, revalidate

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.jminor.common.db.valuemap.ValueMap.Validator

addRevalidationListener, isValid, removeRevalidationListener, revalidate

Constructor Detail

Validator

public Validator()

Instantiates a new Entity.Validator

Validator

public Validator(boolean performNullValidation)

Instantiates a new Entity.Validator

Parameters:

performNullValidation - if true then automatic null validation is performed

Method Detail

isNullable

public boolean isNullable(Entity entity,
                          Property property)

Returns true if the given property accepts a null value for the given entity, by default this method simply returns property.isNullable()

Specified by:

isNullable in interface ValueMap.Validator<Property,Entity>

Overrides:

isNullable in class DefaultValueMap.DefaultValidator<Property,Entity>

Parameters:

entity - the entity being validated

property - the property

Returns:

true if the property accepts a null value

validate

public final void validate(java.util.Collection<Entity> entities)
                    throws ValidationException

Validates all writable properties in the given entities

Specified by:

validate in interface Entity.Validator

Parameters:

entities - the entities to validate

Throws:

ValidationException - in case validation fails

validate

public void validate(Entity entity)
              throws ValidationException

Validates all writable properties in the given entity

Specified by:

validate in interface ValueMap.Validator<Property,Entity>

Overrides:

validate in class DefaultValueMap.DefaultValidator<Property,Entity>

Parameters:

entity - the entity to validate

Throws:

ValidationException - in case validation fails

validate

public void validate(Entity entity,
                     Property property)
              throws ValidationException

Checks if the value associated with the give key is valid, throws a ValidationException if not

Specified by:

validate in interface ValueMap.Validator<Property,Entity>

Overrides:

validate in class DefaultValueMap.DefaultValidator<Property,Entity>

Parameters:

entity - the value map to validate

property - the key the value is associated with

Throws:

ValidationException - if the given value is not valid for the given key

performRangeValidation

public final void performRangeValidation(Entity entity,
                                         Property property)
                                  throws RangeValidationException

Performs a range validation on the given number based property

Specified by:

performRangeValidation in interface Entity.Validator

Parameters:

entity - the entity

property - the property

Throws:

RangeValidationException - in case the value of the given property is outside the legal range

See Also:

Property.Builder#setMax(double), Property.Builder#setMin(double)

performNullValidation

public final void performNullValidation(Entity entity,
                                        Property property)
                                 throws NullValidationException

Performs a null validation on the given property

Specified by:

performNullValidation in interface Entity.Validator

Parameters:

entity - the entity

property - the property

Throws:

NullValidationException - in case the property value is null and the property is not nullable

See Also:

Property.Builder#setNullable(boolean), Property.isNullable()

performLengthValidation

public void performLengthValidation(Entity entity,
                                    Property property)
                             throws LengthValidationException

Performs a length validation on the given string based property

Specified by:

performLengthValidation in interface Entity.Validator

Parameters:

entity - the entity

property - the property

Throws:

LengthValidationException - in case the length of the value of the given property

See Also:

Property.Builder#setMaxLength(int)