Présentation
La librairie Nuiton-validator propose une api neutre de validation intégrant la notion de niveau de validation.
Note
Nuiton-validator quitte le projet nuiton-utils pour devenir un projet autonome.
Voici quelques liens sur le nouveau projet:
A noter que le GAV de l'artefact ne change pas (org.nuiton:nuiton-validator).
La dernière version stable dans nuiton-utils est la 2.7; vous pouvez dès à présent utiliser la version 3.0-alpha-1 de nuiton-validator.
Pour plus de détails sur les changements importants entre chaque version, vous pouvez consulter les Notes de versions.
Implantation (xwork2)
Actuellement la seule implantation disponible se base sur XWork2.
Configuration
La configuration des validateurs se font via des fichier xml.
Ajout d'un validateur
Pour enregister un nouveau validateur sur un bean, il suffit de placer dans le même paquetage que le bean un fichier XXX[-context]-scope-validation.xml où XXX est le nom non qualifié du bean.
Le context optionel permet de définir plusieurs contexts de validation.
Le scope parmi les suivants : fatal, error, warning, info donne le niveau de validation.
Ajout d'un nouveau type de validateur
Il est aussi possible de définir de nouveau type de validateurs :
- créer une classe qui étend FieldValidator
- ajouter un fichier validators.xml (ou ajouter dans un tel fichier la définition du nouveau validator) à la racine du class-path.
I18n
Afin de rendre le mécanisme multi-langue, on propose dans les fichiers de validations d'utiliser des clef i18n pour les messages.
Un nouveau parseur dans notre plugin i18n a été ajouté pour détecter ces clefs. (i18n:parserValidation)
Veuillez consulter la JavaDoc pour de plus ample détails sur les différentes librairies.