Bean Validation 1.1 On n est plus au pays des Beansounours 14h35-15h25 - Salle E. Fitzgerald & L. Armstrong

Transcription

1 Bean Validation 1.1 On n est plus au pays des Beansounours 14h35-15h25 - Salle E. Fitzgerald & L. Armstrong 27 au 29 mars 2013

2 Bean Validation 1.1 On n est plus au pays des Beansounours Emmanuel Bernard Plombier de la donnée - Red 27 au 29 mars 2013

3 Avertissement Tout ce que je peux dire c est que le futur est devant nous Je ne suis pas de la famille de Nostradamus

4 Ce que vous allez apprendre Piqure de rappel sur ce qu est Bean Validation Les nouveautés de Bean Validation 1.1 En quoi cela sera utile pour vous

5 Emmanuel ou JBoss by Red Hat architecte plateforme données Codeur: Hibernate OGM, Search, Validator ; Ceylon Membre de spécifications: JPA, Bean Validation Balladodiffuseur:

6 Bean Validation 1.0 6

7 Bean Validation Avant duplication de contraintes implementations multiples / inconsistances Java Client Side Presentation Layer Business Layer Data Access Layer Database

8 Apres constrain once, run anywhere standardisé intégration avec l écosystème JPA JSF - GWT, Wicket, Tapestry CDI - Spring

9 Déclarer une contrainte class String getstreet1() { return street1 Postal code does not look right ) String getzipcode() { public Country getcountry() { return country; class Country String getiso2() { return iso2; 9

10 Contrainte de Zipcode not valid for country ) class String getstreet1() { return String getzipcode() { return public Country getcountry() { return country; 10

11 Groupes Sous ensemble de contraintes Cas d utilisation validation partielle défini des états ordonne les contraintes

12 class Address String street1; String String String doorcode; Set<ConstraintViolation> violations = validator.validate(address, BasicPostal.class); 12

13 Ecrire une METHOD, FIELD, ANNOTATION_TYPE, @interface ZipCode { String message() default {com.jboss.sample.zipcode.message ; Class<?>[] groups() default {; Class<? extends Payload> payload() default {; String country() default fr ; 13

14 class StringZipCodeValidator implements ConstraintValidator<ZipCode,String> { private String country; private Set<String> validdept = new HashSet<>(); public void initialize(zipcode zipcode) { this.country = zipcode.country(); if (! fr.equalsignorecase( this.country ) ) { throw new IllegalStateException(UNKNOWN_COUNTRY); public boolean isvalid(string value, ConstraintValidationContext context) { if ( value == null ) return true; return validdept.contains( value.substring(0,2) ); 14

15 Bean Validation

16 Bean Validation est 100% ouvert Fidèle à ses racines libres Site web dernière snapshot de la spécification Mailing list et bug tracker ouverts Open source (spec, RI, TCK, site web) Compatible Fork me on GitHub

17 Injection de dépendance Laisser les conteneurs gérer les composants Bean Validation Offrir les contrats nécessaires à l intégration Intégration native avec CDI dans Java EE mais Spring, Guice, Avalon?! peuvent s intégrer

18 Où peut-on utiliser l injection de dépendance les implémentation de ConstraintValidator MessageInterpolator, TraversableResolver, ConstraintValidatorFactory

19 Example class ZipCodeValidator implements private ZipCodeChecker checker; private Pattern zippattern = Pattern.compile("\\d{5"); public void initialize(zipcode zipcode) { public boolean isvalid(string value, ConstraintValidationContext context) { if (value==null) return true; Matcher m = p.matcher(value); if (!m.matches()) return false; return checker.iszipcodevalid(zipcode); 19

20 Validation de méthodes Valide les paramètres et les valeurs de retour lors des appels de méthode comme AroundInvoke Client Bean Validation interceptor Method client calling validated method call method return value Validate parameters Validate return value call method return value Method executes

21 Nécessite une technologie d interception CDI Spring AOP Hérite ses limitations

22 Pour les méthodes et les constructeurs

23 On l utilise quand? Validation d entrée / sortie métier Simplifie le code de la méthode validation devient un problème transversal Programmation par Contrat

24 A l class Client AccountService service; public void createclient() { class AccountService { public User createuser( String username, String firstname, String lastname, String , Date birthdate) { if (username==null) throw new IllegalStateException(); if ( ==null) throw new IllegalStateException(); if (!valid ( ) throw new IllegalStateException(); // business 24

25 Validons les class Client AccountService service; public void createclient() { class AccountService { public User String username, String firstname, String Date birthdate) { // parameters are validated and an exception // is raised upon failure // business 25

26 ..., grappes d class Client AccountService service; public void createclient() { class AccountService { public Order User String creditcard) { // parameters are validated including the object user // business 26

27 ..., les valeurs de class Client AccountService service; public void createclient() { class public Order User String creditcard) { // business // return value is validated before returning the method 27

28 et les contraintes class Client AccountService service; public void createclient() { class @Valid public User String username, String password, String Date birthdate) { // parameters are validated and an exception // is raised upon failure // business 28

29 ConstraintValidator METHOD, FIELD, ANNOTATION_TYPE, @interface ValidatePasswordConsistency { String message() default {com.jboss.sample.validatepasswordconsistency.message ; Class<?>[] groups() default {; Class<? extends Payload> payload() default class PasswordConsistencyValidator implements ConstraintValidator<ValidatePasswordConsistency,Object[]> { [...] public boolean isvalid(object[] params, ConstraintValidationContext context) { if ( value == null ) return true; String password = params[1]; String repeatpassword = params[2]; return password.equals(repeatpassword); 29

30 Quelques règles à ne pas oublier Fonctionne tant que la technologie d interception fonctionne Principe de substitution de Liskov Interdit de raffiner les contraintes de paramètres dans les sous-classes dans les méthodes implémentant une interface Peut raffiner les contraintes des valeurs de retour

31 Liskov par l class AccountService service; public void createclient() { class AccountService { public User createuser(@notempty String username, String firstname, String Date class EvilAccountService extends AccountService { public User createuser( String username, String String lastname, String Date birthdate) {... 31

32 Les getters Les getters ne sont pas validés par si class AccountService { public User createuser(@notempty String username, String firstname, String Date public Integer getfortytwo() NON_GETTER_METHODS, class public Integer public String getinvalid () {...

33 Conversion de groupe Quand le groupe A est validé valide le groupe B pour un sous-graphe donné Oui Bean Validation intègre une technologie de NAT Facilite la réutilisation des graphes d objects

34 Exemple class User String String Address homeaddress; class Address String street1; String String String doorcode; 34

35 Exemple class User String to=fullpostal.class) ) Address homeaddress; class Address String street1; String String String doorcode; 35

36 Intégration avec JAX-RS Valide les valeurs de requête Headers HTTP, paramètres de requête, entity bodies, etc Exactement comme la validation de méthode sauf que les getter action sont validés Les exceptions de validation liées aux codes d erreur HTTP 400 pour la violation de paramètres 500 pour la violation de valeur de retour

37 Headers, param requêtes et /user ) class public firstname ) lastname ) @FormParam( ) String ) {... //works on fields and getters too 37

38 les entity /user ) class public void Item item) {... //works on fields and getters too class Item String 0 ) BigDecimal price; 38

39 Autres Support des CharSequence, et pas juste les String Interpolation des messages d erreur support des EL javax.validation.constraints.decimalmax.message=\ must be less than ${inclusive == true? 'or equal to ' : ''{value Exclusion des limites

40 Quand? Le Final Approval Ballot a démarré cette semaine Spec livrée mi avril Hibernate Validator 5 CR4 la finale quand la spec sort Couverture du TCK 98.8% (1500 tests)

41 Plus d info Avez-vous participé?

42 Questions Réponses