org.nuiton.validator.bean.simple

Class SimpleBeanValidator<O>

java.lang.Object

org.nuiton.validator.bean.AbstractValidator<O>

org.nuiton.validator.bean.simple.SimpleBeanValidator<O>

public class SimpleBeanValidator<O>
extends AbstractValidator<O>

Validator for a javaBean object.

A such validator is designed to validate to keep the validation of a bean, means the bean is attached to the validator (via the context field context.

A such validator is also a JavaBean and you can listen his states modifications via the classic java bean api.

Note: The SimpleBeanValidator should never be used for validation in a service approch since it needs to keep a reference to the bean to validate.

Since:

2.5.2

Author:

tchemit

See Also:

SimpleBeanValidatorListener

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	SimpleBeanValidator.NuitonValidatorContext<O>

Field Summary

Fields

Modifier and Type	Field and Description
static String	BEAN_PROPERTY Name of the bounded property bean.
protected SimpleBeanValidator.NuitonValidatorContext<O>	context Context of the registred bean to validate.
protected SimpleBeanValidator<?>	parentValidator To chain to another validator (acting as parent of this one).

Fields inherited from class org.nuiton.validator.bean.AbstractValidator

canValidate, changed, CHANGED_PROPERTY, CONTEXT_PROPERTY, l, listenerList, pcs, SCOPES_PROPERTY, valid, VALID_PROPERTY, validatorProvider

Constructor Summary

Constructors

Constructor and Description
SimpleBeanValidator(NuitonValidatorProvider validatorProvider, Class<O> beanClass, String context)
SimpleBeanValidator(NuitonValidatorProvider validatorProvider, Class<O> beanClass, String context, NuitonValidatorScope... scopes)

Method Summary

Methods

Modifier and Type	Method and Description
void	addSimpleBeanValidatorListener(SimpleBeanValidatorListener listener)
<T> T	convert(O bean, String fieldName, String value, Class<T> valueClass)
<T> T	convert(String fieldName, String value, Class<T> valueClass) Convert a value.
void	doValidate()
protected void	doValidate(O bean)
protected void	fireFieldChanged(SimpleBeanValidatorEvent evt)
O	getBean() Obtain the actual bean attached to the validator.
protected NuitonValidator<O>	getDelegate()
NuitonValidatorScope	getHighestScope(String field)
SimpleBeanValidator<?>	getParentValidator()
SimpleBeanValidatorListener[]	getSimpleBeanValidatorListeners()
boolean	hasErrors()
boolean	hasFatalErrors()
boolean	hasInfos()
boolean	hasWarnings()
boolean	isValid(String fieldName)
protected void	mergeMessages(NuitonValidatorResult newMessages)
static <O> SimpleBeanValidator<O>	newValidator(Class<O> type, String context, NuitonValidatorScope... scopes) Obtain a new SimpleBeanValidator for the given parameters.
static <O> SimpleBeanValidator<O>	newValidator(String providerName, Class<O> type, String context, NuitonValidatorScope... scopes) Obtain a new SimpleBeanValidator for the given parameters.
protected void	rebuildDelegateValidator(Class<O> beanType, String context, NuitonValidatorScope... scopes)
void	removeSimpleBeanValidatorListener(SimpleBeanValidatorListener listener)
void	setBean(O bean) Change the attached bean.
void	setParentValidator(SimpleBeanValidator<?> parentValidator)
protected void	validate() il faut eviter le code re-intrant (durant une validation, une autre est demandee).

Methods inherited from class org.nuiton.validator.bean.AbstractValidator

addPropertyChangeListener, addPropertyChangeListener, containsField, firePropertyChange, getContext, getEffectiveFields, getEffectiveFields, getEffectiveScopes, getModel, getScopes, getType, isCanValidate, isChanged, isValid, removePropertyChangeListener, removePropertyChangeListener, setCanValidate, setChanged, setContext, setScopes, setValid

Methods inherited from class java.lang.Object

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

Field Detail

BEAN_PROPERTY

public static final String BEAN_PROPERTY

Name of the bounded property bean.

See Also:

getBean(), setBean(Object), Constant Field Values

context

protected final SimpleBeanValidator.NuitonValidatorContext<O> context

Context of the registred bean to validate.

Since:

2.5.2

parentValidator

protected SimpleBeanValidator<?> parentValidator

To chain to another validator (acting as parent of this one).

Since:

2.5.2

Constructor Detail

SimpleBeanValidator

public SimpleBeanValidator(NuitonValidatorProvider validatorProvider,
                   Class<O> beanClass,
                   String context)

SimpleBeanValidator

public SimpleBeanValidator(NuitonValidatorProvider validatorProvider,
                   Class<O> beanClass,
                   String context,
                   NuitonValidatorScope... scopes)

Method Detail

newValidator

public static <O> SimpleBeanValidator<O> newValidator(Class<O> type,
                                      String context,
                                      NuitonValidatorScope... scopes)
                                           throws NullPointerException

Obtain a new SimpleBeanValidator for the given parameters.

Note: It will use the default provider of NuitonValidator

Type Parameters:

O - type of bean to validate

Parameters:

type - type of bean to validate

context - context of validation

scopes - authorized scopes (if null, will use all scopes)

Returns:

the new instanciated SimpleBeanValidator.

Throws:

NullPointerException - if type is null

See Also:

NuitonValidatorFactory.getDefaultProviderName()

newValidator

public static <O> SimpleBeanValidator<O> newValidator(String providerName,
                                      Class<O> type,
                                      String context,
                                      NuitonValidatorScope... scopes)
                                           throws NullPointerException

Obtain a new SimpleBeanValidator for the given parameters.

Note: It will use the provider of NuitonValidator defined by the providerName.

Type Parameters:

O - type of bean to validate

Parameters:

providerName - name of NuitonValidator to use

type - type of bean to validate

context - context of validation

scopes - authorized scopes (if null, will use all scopes)

Returns:

the new instanciated SimpleBeanValidator.

Throws:

NullPointerException - if type is null

See Also:

NuitonValidatorFactory.getProvider(String)

getBean

public O getBean()

Obtain the actual bean attached to the validator.

Returns:

the bean attached to the validor or null if no bean is attached

setBean

public void setBean(O bean)

Change the attached bean.

As a side effect, the internal AbstractNuitonValidatorContext.messages will be reset.

Parameters:

bean - the bean to attach (can be null to reset the validator).

getParentValidator

public SimpleBeanValidator<?> getParentValidator()

setParentValidator

public void setParentValidator(SimpleBeanValidator<?> parentValidator)

hasFatalErrors

public boolean hasFatalErrors()

Specified by:

hasFatalErrors in class AbstractValidator<O>

hasErrors

public boolean hasErrors()

Specified by:

hasErrors in class AbstractValidator<O>

hasWarnings

public boolean hasWarnings()

Specified by:

hasWarnings in class AbstractValidator<O>

hasInfos

public boolean hasInfos()

Specified by:

hasInfos in class AbstractValidator<O>

isValid

public boolean isValid(String fieldName)

Specified by:

isValid in class AbstractValidator<O>

getHighestScope

public NuitonValidatorScope getHighestScope(String field)

Specified by:

getHighestScope in class AbstractValidator<O>

convert

public <T> T convert(O bean,
            String fieldName,
            String value,
            Class<T> valueClass)

Specified by:

convert in class AbstractValidator<O>

doValidate

public void doValidate()

Specified by:

doValidate in class AbstractValidator<O>

convert

public <T> T convert(String fieldName,
            String value,
            Class<T> valueClass)

Convert a value.

If an error occurs, then add an error in validator.

Type Parameters:

T - the type of conversion

Parameters:

fieldName - the name of the bean property

value - the value to convert

valueClass - the type of converted value

Returns:

the converted value, or null if conversion was not ok

addSimpleBeanValidatorListener

public void addSimpleBeanValidatorListener(SimpleBeanValidatorListener listener)

removeSimpleBeanValidatorListener

public void removeSimpleBeanValidatorListener(SimpleBeanValidatorListener listener)

getSimpleBeanValidatorListeners

public SimpleBeanValidatorListener[] getSimpleBeanValidatorListeners()

doValidate

protected void doValidate(O bean)

Specified by:

doValidate in class AbstractValidator<O>

getDelegate

protected NuitonValidator<O> getDelegate()

Specified by:

getDelegate in class AbstractValidator<O>

rebuildDelegateValidator

protected void rebuildDelegateValidator(Class<O> beanType,
                            String context,
                            NuitonValidatorScope... scopes)

Specified by:

rebuildDelegateValidator in class AbstractValidator<O>

validate

protected void validate()

il faut eviter le code re-intrant (durant une validation, une autre est demandee). Pour cela on fait la validation dans un thread, et tant que la premiere validation n'est pas fini, on ne repond pas aux solicitations. Cette method est public pour permettre de force une validation par programmation, ce qui est utile par exemple si le bean ne supporte pas les PropertyChangeListener

Note: la methode est protected et on utilise la methode doValidate() car la méthode ne modifie pas les etats internes et cela en rend son utilisation delicate (le validateur entre dans un etat incoherent par rapport aux messages envoyés).

fireFieldChanged

protected void fireFieldChanged(SimpleBeanValidatorEvent evt)

mergeMessages

protected void mergeMessages(NuitonValidatorResult newMessages)