Как работает валидация в vaadin 8?

Question

[VaneS Ri_Lax]

Добрый день! Изучаю vaadin 8, необходимо по работе.
накидал форму, создал класс Person:

package org.example;
import java.util.Date;

public class Person {

    private String surname;
    private String name;
    private String middleName;
    private Date birthday;
    private String snils;

    public void setSurname(String surname){
        this.surname = surname;
    }
    public String getSurname(){
        return surname;
    }

    public void setName(String name) { this.name = name; }
    public String getName() { return name; }

    public void setMiddleName(String middleName) { this.middleName = middleName; }
    public String getMiddleName() { return middleName; }

    public void setBirthday(Date birthday) { this.birthday = birthday; }
    public Date getBirthday() { return birthday; }

    public void setSnils(String snils) { this.snils = snils; }
    public String getSnils() { return snils; }
}

Далее создал поле textField и пытаюсь сделать валидацию:

final TextField surname = new TextField("Фамилия");
        surname.setWidth("50%");
        surname.setMaxLength(100);

        new Binder<Person>().forField(surname)
                .asRequired("Поле обязательно для заполнения")
                .withValidator(str -> str.length() >= 4, "Фамилия не должна быть короче 4 символов")
                .bind(Person::getSurname, Person::setSurname);

И тут у меня появились некоторые вопросы. Во первых для чего нужно передавать класс Person? Не совсем понятна строка:
.bind(Person::getSurname, Person::setSurname);
То есть если валидация проходит, то данные записываются в соответствующее поле класса?
Извиняюсь за возможно глупые вопросы)

Answer 1

[acwartz]

Класс Binder связывает элемент UI c классом Person, и сам управляет передачей данных в в геттер/сеттер когда поле считает валидным, для этого и передаются ссылки на методы геттера/сеттера класса Person в .bind

Comments

[VaneS Ri_Lax]

Спасибо большое за ответ! Можете подсказать еще пожалуйста, как через объект биндер проверить поле DateField на корректность введенных данных?
В документации привели вот такой пример:

DateField date = new DateField("My Date") {
    @Override
    protected Result<LocalDate> handleUnparsableDateString(
          String dateString) {
        try {
            // try to parse with alternative format
            LocalDate parsedAtServer = LocalDate.parse(dateString, DateTimeFormatter.ISO_DATE);
            return Result.ok(parsedAtServer);
        } catch (DateTimeParseException e) {
           return Result.error("Bad date");
        }
    }
};

Как теперь это связать, не совсем понятно.

[acwartz]

VaneS Ri_Lax, да так же. В валидатор

.withValidator(str -> str.length() >= 4, "Фамилия не должна быть короче 4 символов")

вместо str будет тип данных которым заведует DateField (судя по всему LocalDate), соотв. для него же в классе Person заводите поле такого же типа и пишите геттер и сеттер который потом передаете в bind.
Так же возможно что без этого куска кода в поле вообще строка, а handleUnparsableDateString преобразует результат в нужный класс и уже его типа возвращает поле в валидаторах и т.д.

[VaneS Ri_Lax]

acwartz, Спасибо за ответ!
Со строкой понятно как проверять, а вот как с датой, а именно проверка на то, что являются введенные значения датой или нет.

[acwartz]

VaneS Ri_Lax, ну сами же кусок кода скинули который этим занимается.
вставьте в проект, запустите и проверьте...

Справка говорит что поле оборачивает java.util.Date класс а handleUnparsableDateString вызвается когда класс Date не может разобрать строку что ввел пользователь. Ьак что примерно такое может быть рабочим:

package org.example;
import java.util.Date;

public class Person {

    private Date birthday;
  //...
    public void setBirthday(Date birthday) { this.birthday= birthday; }
    public String getBirthday() { return birthday; }
}

....
final DateField bdate = new  DateField("Дата рождения");
        bdate.setWidth("50%");
       bdate.setDateFormat("dd.MM.yyyy"); //Наш руский формат дат
       bdate.setPlaceholder("ДД.ММ.ГГГГ"); //плейсхолдер чтоб юзер не тупил
        new Binder<Person>().forField(birthday)
                .asRequired("Поле обязательно для заполнения")
                .withValidator(d /*d это Java.util.Date */ -> d == null, "дата должна быть заполнена!")
                .bind(Person::getBirtday, Person::setBirtday);

тип того, писал прям тут.

[VaneS Ri_Lax]

acwartz, То есть если ввели что то кроме даты то приходит null, я понял, спасибо!

[acwartz]

VaneS Ri_Lax, нет, не знаю будет ли это работать в принципе. Просто написал такой вот валидатор, если d получился null то увы и ах.

Answer 2

[Yuriy Vorobyov]

По сути, Binder - функция привязки к формам, т.е. мы связываем объект с полями для отображения. Binder помимо валидации также будет преобразовывать значения полей в значения полей класса. И функция .bind() обычно является завершением процесса привязки, именно в ней мы делаем биндинг на наш основной класс для проверки.
По сути, можно сказать и так:

То есть если валидация проходит, то данные записываются в соответствующее поле класса?

Мы могли бы изобретать велосипед, но Binder все делает за нас и является той самой связующей прослойкой между нашим кодом класса и формами пользовательского интерфейса

Comments

[VaneS Ri_Lax]

Мне нужно при клике на кнопку "сохранить" получить все значения с полей, как понять что все эти поля прошли проверку?