Package com.vaadin.data

Class BinderValidationStatus<BEAN>

java.lang.Object

com.vaadin.data.BinderValidationStatus<BEAN>

Type Parameters:

BEAN - the bean type of the binder

All Implemented Interfaces:

Serializable

public class BinderValidationStatus<BEAN>
extends Object
implements Serializable

Binder validation status change. Represents the outcome of binder level validation. Has information about the validation results for the field level and binder level validation.

Note: if there are any field level validation errors, the bean level validation is not run.

Note: if the status change is triggered via automatic validation due to a changed field value, the field validation statuses will only cover the changed fields.

Use Binder.setValidationStatusHandler(BinderValidationStatusHandler) to handle form level validation status changes.

Since:

8.0

Author:

Vaadin Ltd

See Also:

BinderValidationStatusHandler, Binder.setValidationStatusHandler(BinderValidationStatusHandler), Binder.validate(), BindingValidationStatus, Serialized Form

Constructor Summary

Constructors

Constructor	Description
BinderValidationStatus(Binder<BEAN> source, List<BindingValidationStatus<?>> bindingStatuses, List<ValidationResult> binderStatuses)	Creates a new binder validation status for the given binder and validation results.

Method Summary

Modifier and Type	Method	Description
static <BEAN> BinderValidationStatus<BEAN>	createUnresolvedStatus(Binder<BEAN> source)	Convenience method for creating a unresolved validation status for the given binder.
List<ValidationResult>	getBeanValidationErrors()	Gets the failed bean level validation results.
List<ValidationResult>	getBeanValidationResults()	Gets the bean level validation results.
Binder<BEAN>	getBinder()	Gets the source binder of the status.
List<BindingValidationStatus<?>>	getFieldValidationErrors()	Gets the failed field level validation statuses.
List<BindingValidationStatus<?>>	getFieldValidationStatuses()	Gets the field level validation statuses.
List<ValidationResult>	getValidationErrors()	Gets both field and bean level validation errors.
boolean	hasErrors()	Gets whether the validation for the binder failed or not.
boolean	isOk()	Gets whether validation for the binder passed or not.
void	notifyBindingValidationStatusHandlers()	Notifies all validation status handlers in bindings.
void	notifyBindingValidationStatusHandlers(SerializablePredicate<BindingValidationStatus<?>> filter)	Notifies validation status handlers for bindings that pass given filter.

Methods inherited from class java.lang.Object

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

Constructor Detail

BinderValidationStatus

public BinderValidationStatus(Binder<BEAN> source,
                              List<BindingValidationStatus<?>> bindingStatuses,
                              List<ValidationResult> binderStatuses)

Creates a new binder validation status for the given binder and validation results.

Parameters:

source - the source binder

bindingStatuses - the validation results for the fields

binderStatuses - the validation results for binder level validation

Method Detail

createUnresolvedStatus

public static <BEAN> BinderValidationStatus<BEAN> createUnresolvedStatus(Binder<BEAN> source)

Convenience method for creating a unresolved validation status for the given binder.

In practice this status means that the values might not be valid, but validation errors should be hidden.

Type Parameters:

BEAN - the bean type of the binder

Parameters:

source - the source binder

Returns:

a unresolved validation status

isOk

public boolean isOk()

Gets whether validation for the binder passed or not.

Returns:

true if validation has passed, false if not

hasErrors

public boolean hasErrors()

Gets whether the validation for the binder failed or not.

Returns:

true if validation failed, false if validation passed

getBinder

public Binder<BEAN> getBinder()

Gets the source binder of the status.

Returns:

the source binder

getValidationErrors

public List<ValidationResult> getValidationErrors()

Gets both field and bean level validation errors.

Returns:

a list of all validation errors

getFieldValidationStatuses

public List<BindingValidationStatus<?>> getFieldValidationStatuses()

Gets the field level validation statuses.

The field level validators have been added with Binder.BindingBuilder.withValidator(Validator).

Returns:

the field validation statuses

getBeanValidationResults

public List<ValidationResult> getBeanValidationResults()

Gets the bean level validation results.

Returns:

the bean level validation results

getFieldValidationErrors

public List<BindingValidationStatus<?>> getFieldValidationErrors()

Gets the failed field level validation statuses.

The field level validators have been added with Binder.BindingBuilder.withValidator(Validator).

Returns:

a list of failed field level validation statuses

getBeanValidationErrors

public List<ValidationResult> getBeanValidationErrors()

Gets the failed bean level validation results.

Returns:

a list of failed bean level validation results

notifyBindingValidationStatusHandlers

public void notifyBindingValidationStatusHandlers()

Notifies all validation status handlers in bindings.

Since:

8.2

See Also:

notifyBindingValidationStatusHandlers(SerializablePredicate)

notifyBindingValidationStatusHandlers

public void notifyBindingValidationStatusHandlers(SerializablePredicate<BindingValidationStatus<?>> filter)

Notifies validation status handlers for bindings that pass given filter. The filter should return true for each BindingValidationStatus that should be delegated to the status handler in the binding.

Parameters:

filter - the filter to select bindings to run status handling for

Since:

8.2

See Also:

notifyBindingValidationStatusHandlers()