com.vaadin.data.
Class BindingValidationStatus<TARGET>
- java.lang.Object
-
- com.vaadin.data.BindingValidationStatus<TARGET>
-
Type Parameters:
TARGET
- the target data type of the binding for which the validation status changed, matches the field type unless a converter has been setAll Implemented Interfaces:
public class BindingValidationStatus<TARGET> extends Object implements Serializable
Represents the status of field validation. Status can be
Status.OK
,Status.ERROR
orStatus.UNRESOLVED
. Status OK and ERROR are always associated with a ValidationResultgetResult()
.Use
Binder.BindingBuilder.withValidationStatusHandler(BindingValidationStatusHandler)
to register a handler for field level validation status changes.Since:
8.0
Author:
Vaadin Ltd
See Also:
Binder.BindingBuilder.withValidationStatusHandler(BindingValidationStatusHandler)
,Binder.Binding.validate()
,BindingValidationStatusHandler
,BinderValidationStatus
, Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
BindingValidationStatus.Status
Status of the validation.
-
Constructor Summary
Constructors Constructor Description BindingValidationStatus(Binder.Binding<?,TARGET> source, BindingValidationStatus.Status status, ValidationResult result)
Deprecated.
BindingValidationStatus(Binder.Binding<?,TARGET> source, ValidationResult result)
Deprecated.
BindingValidationStatus(Result<TARGET> result, Binder.Binding<?,TARGET> source)
Creates a new status change event.
-
Method Summary
All Methods Modifier and Type Method Description static <TARGET> BindingValidationStatus<TARGET>
createUnresolvedStatus(Binder.Binding<?,TARGET> source)
Convenience method for creating a
BindingValidationStatus.Status.UNRESOLVED
validation status for the given binding.Binder.Binding<?,TARGET>
getBinding()
Gets the source binding of the validation status.
HasValue<?>
getField()
Gets the bound field for this status.
Optional<String>
getMessage()
Gets error validation message if status is
BindingValidationStatus.Status.ERROR
.Optional<ValidationResult>
getResult()
Gets the validation result if status is either
BindingValidationStatus.Status.OK
orBindingValidationStatus.Status.ERROR
or an empty optional if status isBindingValidationStatus.Status.UNRESOLVED
.BindingValidationStatus.Status
getStatus()
Gets status of the validation.
List<ValidationResult>
getValidationResults()
Gets all the validation results related to this binding validation status.
boolean
isError()
Gets whether the validation failed or not.
-
-
-
Constructor Detail
-
BindingValidationStatus
@Deprecated public BindingValidationStatus(Binder.Binding<?,TARGET> source, ValidationResult result)
Deprecated.Creates a new validation status for the given binding and validation result.
Parameters:
source
- the source bindingresult
- the result of the validation
-
BindingValidationStatus
@Deprecated public BindingValidationStatus(Binder.Binding<?,TARGET> source, BindingValidationStatus.Status status, ValidationResult result)
Deprecated.Creates a new status change event.
The
message
must benull
if thestatus
isBindingValidationStatus.Status.OK
.Parameters:
source
- field whose status has changed, notnull
status
- updated status value, notnull
result
- the related result, may benull
-
BindingValidationStatus
public BindingValidationStatus(Result<TARGET> result, Binder.Binding<?,TARGET> source)
Creates a new status change event.
If
result
isnull
, thestatus
isBindingValidationStatus.Status.UNRESOLVED
.Parameters:
result
- the related result object, may benull
source
- field whose status has changed, notnull
Since:
8.2
-
-
Method Detail
-
createUnresolvedStatus
public static <TARGET> BindingValidationStatus<TARGET> createUnresolvedStatus(Binder.Binding<?,TARGET> source)
Convenience method for creating a
BindingValidationStatus.Status.UNRESOLVED
validation status for the given binding.Type Parameters:
TARGET
- the target data type of the binding for which the validation status was resetParameters:
source
- the source bindingReturns:
unresolved validation status
-
getStatus
public BindingValidationStatus.Status getStatus()
Gets status of the validation.
Returns:
status
-
isError
public boolean isError()
Gets whether the validation failed or not.
Returns:
true
if validation failed,false
if validation passed
-
getMessage
public Optional<String> getMessage()
Gets error validation message if status is
BindingValidationStatus.Status.ERROR
.Returns:
an optional validation error status or an empty optional if status is not an error
-
getResult
public Optional<ValidationResult> getResult()
Gets the validation result if status is either
BindingValidationStatus.Status.OK
orBindingValidationStatus.Status.ERROR
or an empty optional if status isBindingValidationStatus.Status.UNRESOLVED
.Returns:
the validation result
-
getValidationResults
public List<ValidationResult> getValidationResults()
Gets all the validation results related to this binding validation status.
Returns:
list of validation results
Since:
8.2
-
getBinding
public Binder.Binding<?,TARGET> getBinding()
Gets the source binding of the validation status.
Returns:
the source binding
-
getField
public HasValue<?> getField()
Gets the bound field for this status.
Returns:
the field
-
-