BEAN VALIDATION. Waldemar Korłub. Narzędzia i aplikacje Java EE KASK ETI Politechnika Gdańska

Transkrypt

1 BEAN VALIDATION Waldemar Korłub Narzędzia i aplikacje Java EE KASK ETI Politechnika Gdańska

2 Bean Validation Uniwersalny mechanizm walidacji danych we wszystkich warstwach aplikacji Warstwa interfejsu, np. JSF Warstwa biznesowa, np. EJB, CDI Warstwa dostępu do danych, np. JPA Jednorazowo definiowane walidatory i reguły walidacji do wykorzystania we wszystkich warstwach Nie ma potrzeby duplikowania logiki walidującej

3 Standardowe walidatory Adnotacja Typ pola Dowolny Wartość inna niż Dowolny Wartość równa Ciągi znaków, Rozmiar w przedziale [X, Y] min=x, max=y) Ciągi znaków Ciąg znaków pasuje do wyrażenia Liczby Wartość liczbowa minimum Liczby Wartość liczbowa maksimum Daty Data w Daty Data w Boolean Flaga ma wartość Boolean Flaga ma wartość false

4 Dodatkowe walidatory: Biblioteka Hibernate Validator Adnotacja Typ pola Ciągi znaków, kolekcje Element nie zawiera wartości null i nie jest Ciągi znaków Element nie zawiera wartości null i nie jest pusty, ignoruje białe znaki na końcu max=y) Liczby Ciągi znaków Liczba leży w podanym zakresie w jednej adnotacji) Długość ciągu znaków mieści się w przedziale [X, Y]

5 Dodatkowe walidatory: Biblioteka Hibernate Validator Adnotacja Typ pola Ciągi znaków Ciąg znaków zawiera poprawny adres Ciągi znaków Ciąg znaków zawiera poprawny adres Ciągi znaków Ciąg znaków zawiera poprawny numer karty Ciągi znaków Ciąg znaków zawiera bezpieczny z punktu widzenia ataków XSS kod HTML

6 Przykłady public class = GenerationType.IDENTITY) private Integer private private Date = private List<Author> authors = new ArrayList<>();

7 Własny walidator Definicja własnego walidatora obejmuje dwa elementy: Klasę z interfejsem ConstraintValidator n Zawiera logikę weryfikującą poprawność przekazywanej wartości Adnotację znakującą n Pozwala wskazać pola mające podlegać walidacji n Opatrzona n Może posiadać dodatkowe parametry do sprecyzowania reguł walidacji

8 Adnotacja ElementType.METHOD) = InPast { String message() default "{pl.gda.pg.eti.kask.inpast.in_past"; Class<?>[] groups() default {; Class<? extends Payload>[] payload() default {; String date() default "";

9 Meta-adnotacje Semantykę adnotacji definiuje się za pomocą jakże by inaczej innych określa jakie elementy mogą być oznaczane określa jak długo będzie dostępna informacja o obecności adnotacji: RUNTIME w czasie działania aplikacji CLASS w skompilowanych klasach SOURCE tylko w kodzie wystąpienia adnotacji zostaną udokumentowane w klasach, które ich używają

10 Adnotacje opatrzone są rozpoznawane jako adnotacje znakujące walidatorów Atrybut validatedby określa klasę z logiką walidatora Adnotacja znakująca musi zawierać pola: message komunikat informujący o błędzie walidacji n Może odnosić się do klucza wielojęzycznego zasobu (ValidationMessages.properties w domyślnym pakiecie) groups lista grup, w których reguła walidacji jest aktywna payload dodatkowa informacja do wykorzystania przez dewelopera (nie jest używana przez Bean Validation API)

11 Klasa walidująca public class InPastValidator implements ConstraintValidator<InPast, Date> { public static final String DATE_PATTERN = "yyyy-mm-dd"; private Date date = new public void initialize(inpast constraintannotation) { if (!constraintannotation.date().equals("")) { try { date = new SimpleDateFormat(DATE_PATTERN).parse(constraintAnnotation.date()); catch (ParseException ex) public boolean isvalid(date value, ConstraintValidatorContext context) { return date.after(value);

12 Przykłady public class Book { = private Date publishdate;

13 Walidacja powiązanych pól W wielu sytuacjach obiekty posiadają pola o powiązanych ze sobą wartościach, np.: Nowe hasło oraz powtórz nowe hasło (w formularzu rejestracji/zmiany hasła) Miasto oraz kod pocztowy (w formularzu zamówienia) Walidacja wymaga dostępu do wartości wszystkich powiązanych pól Bean Validation umożliwia zadeklarowanie walidatora na poziomie klasy Z dostępem do wszystkich składowych obiektów tej klasy

14 Przykład: formularz rejestracji public class RegistrationForm String String String passwordrepeat;

15 @Constraint(validatedBy = RepeatPassword { String message() default "Hasła muszą być takie same"; Class<?>[] groups() default {; Class<? extends Payload>[] payload() default {;

16 Klasa walidująca public class RepeatPasswordValidator implements ConstraintValidator<RepeatPassword, RegistrationForm> public void initialize(repeatpassword constraintannotation) public boolean isvalid(registrationform value, ConstraintValidatorContext context) { return value.getpassword().equals(value.getpasswordrepeat());

17 Wykorzystanie public class RegistrationForm String String String passwordrepeat;

18 Grupowanie reguł walidacji Ten sam obiekt może wymagać innych reguł walidacji na różnych etapach przetwarzania Dane wpisywane w formularzu przez użytkownika Pola o wartościach wyliczanych w warstwie logiki biznesowej Weryfikacja wszystkich pól przed zapisem do bazy danych Bean Validation pozwala na przypisywanie reguł walidacji do grup W czasie walidacji należy wskazać, która grupa ma zostać zweryfikowana

19 Grupowanie reguł walidacji Grupy deklarowane są jako interfejsy znakujące (interfejsy bez metod) z braku bardziej adekwatnego mechanizmu w języku Przykładowo: Grupa dla informacji wprowadzanych przez użytkownika w formularzu na stronie: public interface UserInput { Grupa dla informacji dodawanych przez wydawcę: public interface PublisherAddons {

20 Przypisywanie public class Book private Integer private String title; Grupa domyślna = private Date = "...", groups = PublisherAddons.class) private String = 1, groups = private List<Author> authors = new ArrayList<>();

21 Walidacja wybranych grup Obiekt klasy Validator sterowanie procesem walidacji: Validator validator = /*...*/; Tylko grupa domyślna: Set<ConstraintViolation<Book>> errors = validator.validate(book); Grupa domyślna oraz UserInput validator.validate(book, Default.class, UserInput.class); Tylko grupa PublisherAddons validator.validate(book, PublisherAddons.class); W widoku JSF: <f:validatebean validationgroups="pl.edu.pg.eti.userinput"/>

22 Pytania?