Interface Binder.Binding<BEAN,​TARGET>

Method Detail

• getField

  HasValue<?> getField()

  Gets the field the binding uses.

  Returns:

  the field for the binding

• validate

  default BindingValidationStatus<TARGET> validate()

  Validates the field value and returns a ValidationStatus instance representing the outcome of the validation. This method is a short-hand for calling validate(boolean) with fireEvent true.

  Returns:

  the validation result.

  See Also:

  validate(boolean), Binder.validate(), Validator.apply(Object, ValueContext)

• validate

  BindingValidationStatus<TARGET> validate​(boolean fireEvent)

  Validates the field value and returns a ValidationStatus instance representing the outcome of the validation. Note: Calling this method will not trigger the value update in the bean automatically. This method will attempt to temporarily apply all current changes to the bean and run full bean validation for it. The changes are reverted after bean validation.

  Parameters:

  fireEvent - true to fire status event; false to not

  Returns:

  the validation result.

  Since:

  8.2

  See Also:

  validate(), Binder.validate()

• getValidationStatusHandler

  BindingValidationStatusHandler getValidationStatusHandler()

  Gets the validation status handler for this Binding.

  Returns:

  the validation status handler for this binding

  Since:

  8.2

• unbind

  void unbind()

  Unbinds the binding from its respective Binder Removes any ValueChangeListener Registration from associated HasValue.

  Since:

  8.2

• read

  void read​(BEAN bean)

  Reads the value from given item and stores it to the bound field.

  Parameters:

  bean - the bean to read from

  Since:

  8.2

• setReadOnly

  void setReadOnly​(boolean readOnly)

  Sets the read-only status on for this Binding. Setting a Binding read-only will mark the field read-only and not write any values from the fields to the bean.

  This helper method is the preferred way to control the read-only state of the bound field.

  Parameters:

  readOnly - true to set binding read-only; false to enable writes

  Throws:

  IllegalStateException - if trying to make binding read-write and the setter is null

  Since:

  8.4

• isReadOnly

  boolean isReadOnly()

  Gets the current read-only status for this Binding.

  Returns:

  true if read-only; false if not

  Since:

  8.4

  See Also:

  setReadOnly(boolean)

• getGetter

  ValueProvider<BEAN,​TARGET> getGetter()

  Gets the getter associated with this Binding.

  Returns:

  the getter

  Since:

  8.4

• getSetter

  Setter<BEAN,​TARGET> getSetter()

  Gets the setter associated with this Binding.

  Returns:

  the setter

  Since:

  8.4

• setAsRequiredEnabled

  void setAsRequiredEnabled​(boolean asRequiredEnabled)

  Enable or disable asRequired validator. The validator is enabled by default.

  Parameters:

  asRequiredEnabled - false if asRequired validator should be disabled, true otherwise (default)

  Since:

  8.10

  See Also:

  Binder.BindingBuilder.asRequired(String), Binder.BindingBuilder.asRequired(ErrorMessageProvider)

• isAsRequiredEnabled

  boolean isAsRequiredEnabled()

  Returns whether asRequired validator is currently enabled or not.

  Returns:

  false if asRequired validator is disabled true otherwise (default)

  Since:

  8.10

  See Also:

  Binder.BindingBuilder.asRequired(String), Binder.BindingBuilder.asRequired(ErrorMessageProvider)

• setValidatorsDisabled

  void setValidatorsDisabled​(boolean validatorsDisabled)

  Define whether validators are disabled or enabled for this specific binding.

  Parameters:

  validatorsDisabled - A boolean value

  Since:

  8.11

• isValidatorsDisabled

  boolean isValidatorsDisabled()

  Returns if validators are currently disabled or not

  Returns:

  A boolean value

  Since:

  8.11

• setConvertBackToPresentation

  void setConvertBackToPresentation​(boolean convertBackToPresentation)

  Define whether the value should be converted back to the presentation in the field when a converter is used in binding.

  Parameters:

  convertBackToPresentation - A boolean value

  Since:

  8.13

• isConvertBackToPresentation

  boolean isConvertBackToPresentation()

  Returns whether the value is converted back to the presentation in the field when a converter is used in binding.

  Returns:

  A boolean value

  Since:

  8.13

• hasChanges

  boolean hasChanges()

  Checks whether the field that the binding uses has uncommitted changes.

  Returns:

  true if the field the binding uses has uncommitted changes, otherwise false.

  Throws:

  IllegalStateException - if the binding is no longer attached to a Binder.

• getEqualityPredicate

  SerializableBiPredicate<TARGET,​TARGET> getEqualityPredicate()

  Used in comparison of the current value of a field with its initial value.

  Once set, the value of the field that binding uses will be compared with the initial value for hasChanged.

  Returns:

  the predicate to use for equality comparison