org.nuiton.validator.bean.list

Class BeanListValidator<O>

java.lang.Object

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

org.nuiton.validator.bean.list.BeanListValidator<O>

public class BeanListValidator<O>
extends AbstractValidator<O>

To validate a list of beans.

Each bean of the list will be associated with a BeanListValidator.NuitonValidatorContext.

Since:

2.5.2

Author:

tchemit

Nested Class Summary

Nested Classes

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

Field Summary

Fields

Modifier and Type	Field and Description
protected Map<O,BeanListValidator.NuitonValidatorContext<O>>	contexts Context for each bean registred.
protected NuitonValidator<O>	delegate The delegate validator used to validate the bean.

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
BeanListValidator(NuitonValidatorProvider validatorProvider, Class<O> beanClass, String context)
BeanListValidator(NuitonValidatorProvider validatorProvider, Class<O> beanClass, String context, NuitonValidatorScope... scopes)

Method Summary

Methods

Modifier and Type	Method and Description
void	addAllBeans(Collection<O> beansToAdd)
void	addBean(O bean) Add a bean to validate.
void	addBeanListValidatorListener(BeanListValidatorListener listener)
<T> T	convert(O bean, String fieldName, String value, Class<T> valueClass) Convert a value.
void	doValidate()
protected void	doValidate(O bean)
protected void	fireFieldChanged(BeanListValidatorEvent evt)
BeanListValidatorListener[]	getBeanListValidatorListeners()
Set<O>	getBeans()
BeanListValidator.NuitonValidatorContext<O>	getContext(O bean)
protected NuitonValidator<O>	getDelegate()
NuitonValidatorScope	getHighestScope(String field)
boolean	hasErrors()
boolean	hasFatalErrors()
boolean	hasInfos()
boolean	hasWarnings()
boolean	isValid(String fieldName)
protected boolean	isValid0()
protected void	mergeMessages(BeanListValidator.NuitonValidatorContext<O> context, NuitonValidatorResult newMessages)
static <O> BeanListValidator<O>	newValidator(Class<O> type, String context, NuitonValidatorScope... scopes) Obtain a new BeanListValidator for the given parameters.
static <O> BeanListValidator<O>	newValidator(String providerName, Class<O> type, String context, NuitonValidatorScope... scopes) Obtain a new BeanListValidator for the given parameters.
protected void	rebuildDelegateValidator(Class<O> beanType, String context, NuitonValidatorScope... scopes)
void	removeAllBeans() Shortcut method to unregister all previously registred beans from this validator.
void	removeAllBeans(Collection<O> beansToRemove) Remove all the given beans fro this validator.
void	removeBean(O bean) Remove the given bean from the validaotr.
void	removeBeanListValidatorListener(BeanListValidatorListener listener)
protected void	validate() il faut eviter le code re-intrant (durant une validation, une autre est demandee).
protected void	validate(O bean)

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

contexts

protected final Map<O,BeanListValidator.NuitonValidatorContext<O>> contexts

Context for each bean registred.

Since:

2.5.2

delegate

protected NuitonValidator<O> delegate

The delegate validator used to validate the bean.

Since:

2.5.2

Constructor Detail

BeanListValidator

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

BeanListValidator

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

Method Detail

newValidator

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

Obtain a new BeanListValidator 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 BeanListValidator.

Throws:

NullPointerException - if type is null

See Also:

NuitonValidatorFactory.getDefaultProviderName()

newValidator

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

Obtain a new BeanListValidator 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 BeanListValidator.

Throws:

NullPointerException - if type is null

See Also:

NuitonValidatorFactory.getProvider(String)

addBean

public void addBean(O bean)

Add a bean to validate.

The bean can not be null, nor registered twice in the validator.

Parameters:

bean - the bean to attach (can not be null).

addAllBeans

public void addAllBeans(Collection<O> beansToAdd)

removeBean

public void removeBean(O bean)

Remove the given bean from the validaotr.

The bean can not be null, nor not has been previously registred in this validator.

Parameters:

bean - the bean to unregister

removeAllBeans

public void removeAllBeans(Collection<O> beansToRemove)

Remove all the given beans fro this validator.

Like in method removeBean(Object), each bean must be not null and has been previously registred in this validator.

Parameters:

beansToRemove - beans to remove from this validator

removeAllBeans

public void removeAllBeans()

Shortcut method to unregister all previously registred beans from this validator.

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>

doValidate

public void doValidate()

Specified by:

doValidate in class AbstractValidator<O>

convert

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

Convert a value.

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

Specified by:

convert in class AbstractValidator<O>

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

addBeanListValidatorListener

public void addBeanListValidatorListener(BeanListValidatorListener listener)

removeBeanListValidatorListener

public void removeBeanListValidatorListener(BeanListValidatorListener listener)

getBeanListValidatorListeners

public BeanListValidatorListener[] getBeanListValidatorListeners()

getBeans

public Set<O> getBeans()

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).

validate

protected void validate(O bean)

isValid0

protected boolean isValid0()

mergeMessages

protected void mergeMessages(BeanListValidator.NuitonValidatorContext<O> context,
                 NuitonValidatorResult newMessages)

fireFieldChanged

protected void fireFieldChanged(BeanListValidatorEvent evt)

getContext

public BeanListValidator.NuitonValidatorContext<O> getContext(O bean)