Add javadoc for validate() call in Binder (#11318)

* Add javadoc for validate() call in Binder

1 files changed, 6 insertions, 0 deletions

diff --git a/server/src/main/java/com/vaadin/data/Binder.java b/server/src/main/java/com/vaadin/data/Binder.java
index d2aff412f6..22ef7d7782 100644
--- a/server/src/main/java/com/vaadin/data/Binder.java
+++ b/server/src/main/java/com/vaadin/data/Binder.java
@@ -139,7 +139,13 @@ public class Binder<BEAN> implements Serializable {
          * Validates the field value and returns a {@code ValidationStatus}
          * instance representing the outcome of the validation.
          *
+         * <strong>Note:</strong> 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.
+         *
          * @see #validate()
+         * @see Binder#validate()
          *
          * @param fireEvent
          *            {@code true} to fire status event; {@code false} to not