Binder.BindingBuilderImpl (Vaadin Platform (vaadin-platform-javadoc) 14.12.5 API)

java.lang.Object
- com.vaadin.flow.data.binder.Binder.BindingBuilderImpl<BEAN,FIELDVALUE,TARGET>

Type Parameters:

BEAN - the bean type, must match the Binder bean type

FIELDVALUE - the value type of the field

TARGET - the target data type of the binding, matches the field type until a converter has been set

All Implemented Interfaces:

Binder.BindingBuilder<BEAN,TARGET>, Serializable

Enclosing class:

Binder<BEAN>
```
protected static class Binder.BindingBuilderImpl<BEAN,FIELDVALUE,TARGET>
extends Object
implements Binder.BindingBuilder<BEAN,TARGET>
```
An internal implementation of BindingBuilder.

See Also:

Serialized Form

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`BindingBuilderImpl(Binder<BEAN> binder, HasValue<?,FIELDVALUE> field, Converter<FIELDVALUE,TARGET> converterValidatorChain, BindingValidationStatusHandler statusHandler)` Creates a new binding builder associated with the given field.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Binder.BindingBuilder<BEAN,TARGET>`	`asRequired(ErrorMessageProvider errorMessageProvider)` Sets the field to be required.
`Binder.BindingBuilder<BEAN,TARGET>`	`asRequired(Validator<TARGET> customRequiredValidator)` Sets the field to be required and delegates the required check to a custom validator.
`Binder.Binding<BEAN,TARGET>`	`bind(String propertyName)` Completes this binding by connecting the field to the property with the given name.
`Binder.Binding<BEAN,TARGET>`	`bind(ValueProvider<BEAN,TARGET> getter, Setter<BEAN,TARGET> setter)` Completes this binding using the given getter and setter functions representing a backing bean property.
`protected void`	`checkUnbound()` Throws if this binding is already completed and cannot be modified anymore.
`protected Binder<BEAN>`	`getBinder()` Returns the `Binder` connected to this `Binding` instance.
`HasValue<?,FIELDVALUE>`	`getField()` Gets the field the binding is being built for.
`<NEWTARGET> Binder.BindingBuilder<BEAN,NEWTARGET>`	`withConverter(Converter<TARGET,NEWTARGET> converter)` Maps the binding to another data type using the given `Converter`.
`protected <NEWTARGET> Binder.BindingBuilder<BEAN,NEWTARGET>`	`withConverter(Converter<TARGET,NEWTARGET> converter, boolean resetNullRepresentation)` Implements `withConverter(Converter)` method with additional possibility to disable (reset) default null representation converter.
`Binder.BindingBuilder<BEAN,TARGET>`	`withValidationStatusHandler(BindingValidationStatusHandler handler)` Sets a `BindingValidationStatusHandler` to track validation status changes.
`Binder.BindingBuilder<BEAN,TARGET>`	`withValidator(Validator<? super TARGET> validator)` Adds a validator to this binding.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.vaadin.flow.data.binder.Binder.BindingBuilder
asRequired, asRequired, withConverter, withConverter, withNullRepresentation, withStatusLabel, withValidator, withValidator, withValidator, withValidator

- Constructor Detail
  - BindingBuilderImpl
```
protected BindingBuilderImpl(Binder<BEAN> binder,
                             HasValue<?,FIELDVALUE> field,
                             Converter<FIELDVALUE,TARGET> converterValidatorChain,
                             BindingValidationStatusHandler statusHandler)
```
    Creates a new binding builder associated with the given field. Initializes the builder with the given converter chain and status change handler.
    
    Parameters:
    
    binder - the binder this instance is connected to, not null
    
    field - the field to bind, not null
    
    converterValidatorChain - the converter/validator chain to use, not null
    
    statusHandler - the handler to track validation status, not null
- Method Detail
  - bind
```
public Binder.Binding<BEAN,TARGET> bind(ValueProvider<BEAN,TARGET> getter,
                                        Setter<BEAN,TARGET> setter)
```
    Description copied from interface: Binder.BindingBuilder
    Completes this binding using the given getter and setter functions representing a backing bean property. The functions are used to update the field value from the property and to store the field value to the property, respectively.
    When a bean is bound with Binder.setBean(Object), the field value is set to the return value of the given getter. The property value is then updated via the given setter whenever the field value changes. The setter may be null; in that case the property value is never updated and the binding is said to be read-only.
    If the Binder is already bound to some bean, the newly bound field is associated with the corresponding bean property as described above.
    If the bound field implements HasValidator, then the binding instance returned by this method will subscribe for field's ValidationStatusChangeEvents and will validate itself upon receiving them.
    The getter and setter can be arbitrary functions, for instance implementing user-defined conversion or validation. However, in the most basic use case you can simply pass a pair of method references to this method as follows:
```
 class Person {
     public String getName() { ... }
     public void setName(String name) { ... }
 }

 TextField nameField = new TextField();
 binder.forField(nameField).bind(Person::getName, Person::setName);
 
```
    Note: when a null setter is given the field will be marked as readonly by invoking HasValue.setReadOnly(boolean).
    Specified by:
    
    bind in interface Binder.BindingBuilder<BEAN,TARGET>
    
    Parameters:
    
    getter - the function to get the value of the property to the field, not null
    
    setter - the function to write the field value to the property or null if read-only
    
    Returns:
    
    the newly created binding
  - bind
```
public Binder.Binding<BEAN,TARGET> bind(String propertyName)
```
    Description copied from interface: Binder.BindingBuilder
    
    Completes this binding by connecting the field to the property with the given name. The getter and setter of the property are looked up using a PropertySet.
    For a Binder created using the Binder.Binder(Class) constructor, introspection will be used to find a Java Bean property. If a JSR-303 bean validation implementation is present on the classpath, a BeanValidator is also added to the binding.
    The property must have an accessible getter method. It need not have an accessible setter; in that case the property value is never updated and the binding is said to be read-only. Nested property, when supported, can be referenced using the bean path, starting from the root class, for example 'address.streetName'. All intermediate getters must exist (e.g. getAddress()), and should never return null, otherwise binding will fail.
    Note: when the binding is read-only the field will be marked as readonly by invoking HasValue.setReadOnly(boolean).
    
    Specified by:
    
    bind in interface Binder.BindingBuilder<BEAN,TARGET>
    
    Parameters:
    
    propertyName - the name of the property to bind, not null
    
    Returns:
    
    the newly created binding
    
    See Also:
    
    Binder.BindingBuilder.bind(ValueProvider, Setter)
  - withValidator
```
public Binder.BindingBuilder<BEAN,TARGET> withValidator(Validator<? super TARGET> validator)
```
    Description copied from interface: Binder.BindingBuilder
    
    Adds a validator to this binding. Validators are applied, in registration order, when the field value is written to the backing property. If any validator returns a failure, the property value is not updated.
    
    Specified by:
    
    withValidator in interface Binder.BindingBuilder<BEAN,TARGET>
    
    Parameters:
    
    validator - the validator to add, not null
    
    Returns:
    
    this binding, for chaining
    
    See Also:
    
    Binder.BindingBuilder.withValidator(SerializablePredicate, String), Binder.BindingBuilder.withValidator(SerializablePredicate, ErrorMessageProvider)
  - withConverter
```
public <NEWTARGET> Binder.BindingBuilder<BEAN,NEWTARGET> withConverter(Converter<TARGET,NEWTARGET> converter)
```
    Description copied from interface: Binder.BindingBuilder
    
    Maps the binding to another data type using the given Converter.
    A converter is capable of converting between a presentation type, which must match the current target data type of the binding, and a model type, which can be any data type and becomes the new target type of the binding. When invoking Binder.BindingBuilder.bind(ValueProvider, Setter), the target type of the binding must match the getter/setter types.
    For instance, a TextField can be bound to an integer-typed property using an appropriate converter such as a StringToIntegerConverter.
    The converted value is not applied back to the field by default, this can be controlled with the method Binder.Binding.setConvertBackToPresentation(boolean).
    
    Specified by:
    
    withConverter in interface Binder.BindingBuilder<BEAN,TARGET>
    
    Type Parameters:
    
    NEWTARGET - the type to convert to
    
    Parameters:
    
    converter - the converter to use, not null
    
    Returns:
    
    a new binding with the appropriate type
    
    See Also:
    
    Binder.Binding.setConvertBackToPresentation(boolean)
  - withValidationStatusHandler
```
public Binder.BindingBuilder<BEAN,TARGET> withValidationStatusHandler(BindingValidationStatusHandler handler)
```
    Description copied from interface: Binder.BindingBuilder
    
    Sets a BindingValidationStatusHandler to track validation status changes.
    The validation state of each field is updated whenever the user modifies the value of that field.
    This method allows to customize the way a binder displays error messages.
    The method may be called only once. It means there is no chain unlike Binder.BindingBuilder.withValidator(Validator) or Binder.BindingBuilder.withConverter(Converter). Also it means that the shorthand method Binder.BindingBuilder.withStatusLabel(HasText) also may not be called after this method.
    
    Specified by:
    
    withValidationStatusHandler in interface Binder.BindingBuilder<BEAN,TARGET>
    
    Parameters:
    
    handler - status change handler
    
    Returns:
    
    this binding, for chaining
    
    See Also:
    
    Binder.BindingBuilder.withStatusLabel(HasText)
  - asRequired
```
public Binder.BindingBuilder<BEAN,TARGET> asRequired(ErrorMessageProvider errorMessageProvider)
```
    Description copied from interface: Binder.BindingBuilder
    Sets the field to be required. This means two things:
    1. the required indicator is visible
    2. the field value is validated for not being empty*
    *Value not being the equal to what HasValue.getEmptyValue() returns.
    Specified by:
    
    asRequired in interface Binder.BindingBuilder<BEAN,TARGET>
    
    Parameters:
    
    errorMessageProvider - the provider for localized validation error message
    
    Returns:
    
    this binding, for chaining
    
    See Also:
    
    HasValue.setRequiredIndicatorVisible(boolean), HasValue.isEmpty()
  - asRequired
```
public Binder.BindingBuilder<BEAN,TARGET> asRequired(Validator<TARGET> customRequiredValidator)
```
    Description copied from interface: Binder.BindingBuilder
    Sets the field to be required and delegates the required check to a custom validator. This means two things:
    1. the required indicator will be displayed for this field
    2. the field value is validated by customRequiredValidator
    Specified by:
    
    asRequired in interface Binder.BindingBuilder<BEAN,TARGET>
    
    Parameters:
    
    customRequiredValidator - validator responsible for the required check
    
    Returns:
    
    this binding, for chaining
    
    See Also:
    
    HasValue.setRequiredIndicatorVisible(boolean)
  - withConverter
```
protected <NEWTARGET> Binder.BindingBuilder<BEAN,NEWTARGET> withConverter(Converter<TARGET,NEWTARGET> converter,
                                                                          boolean resetNullRepresentation)
```
    Implements withConverter(Converter) method with additional possibility to disable (reset) default null representation converter.
    The method withConverter(Converter) calls this method with true provided as the second argument value.
    
    Type Parameters:
    
    NEWTARGET - the type to convert to
    
    Parameters:
    
    converter - the converter to use, not null
    
    resetNullRepresentation - if true then default null representation will be deactivated (if not yet), otherwise it won't be removed
    
    Returns:
    
    a new binding with the appropriate type
    
    Throws:
    
    IllegalStateException - if bind has already been called
    
    See Also:
    
    withConverter(Converter)
  - getBinder
```
protected Binder<BEAN> getBinder()
```
    Returns the Binder connected to this Binding instance.
    
    Returns:
    
    the binder
  - checkUnbound
```
protected void checkUnbound()
```
    Throws if this binding is already completed and cannot be modified anymore.
    
    Throws:
    
    IllegalStateException - if this binding is already bound
  - getField
```
public HasValue<?,FIELDVALUE> getField()
```
    Description copied from interface: Binder.BindingBuilder
    
    Gets the field the binding is being built for.
    
    Specified by:
    
    getField in interface Binder.BindingBuilder<BEAN,TARGET>
    
    Returns:
    
    the field this binding is being built for

Class Binder.BindingBuilderImpl<BEAN,FIELDVALUE,TARGET>

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface com.vaadin.flow.data.binder.Binder.BindingBuilder

Constructor Detail

BindingBuilderImpl

Method Detail

bind

bind

withValidator

withConverter

withValidationStatusHandler

asRequired

asRequired

withConverter

getBinder

checkUnbound

getField