Groupe 1A (socle)
Date de création :	05 juillet 2005
Dernière modification :
Diffusion :	Esup-Portail

Canal des préférences

Les formats

But

Dans le fichier de configuration, il est possible (pas obligatoire) de définir un format de validité des données saisies (pour chaque champs "write"). Ce format pourra vérifier les données et éventuellement transformer la saisie dans un autre formatage pour la sauvegarde.

Les méthodes d'une classe format

Une classe de format doit hériter de la classe "Format" et doit se trouver dans le package "org.esupportail.portal.channels.CPref.formats".

En héritant de "Format", il y 2 méthodes obligatoires :

• boolean check(String value) : permet de savoir si la valeur en paramètre vérifie certaines expressions régulières.
  Par exemple, on veut que la chaine ne contienne que des caractères alphanumériques :

  if (value.matches("^\\w$")){
    return true;
  }
  return false;

• String transform(String before) : permet de transformer la valeur en paramètre en une chaine dont le formatage est imposé.
  Par exemple la chaine doit être en majuscule :
  

  return before.toUpperCase();

Mécanisme de mise en oeuvre

Tous les appels à ces méthodes sont fait automatiquement. Vous n'avez donc qu'a décrire les 2 méthodes et à déclares les champs en "write" qui répondent à ce format.

Dans la classe "UpdateAction", la méthode verifAttribLDAP() regarde pour tous les champs en "write" si le format est correct. Si oui, elle transforme la valeur saisie selon la méthode du format. Si non, elle met dans les runtimeData les champs mal rensigné. Une fois qu'elle a scrutée tous les champs, elle retourne un boolean qui précise s'il y a eu une erreur.

La méthode verifAttribLDAP() est appellée sur l'action MAG de validation des données. Le code retour de la fonction est testé. S'il est "false" alors le MAG redirige l'action courant sur l'action de modification. Comme il s'agit d'une redirection, les informations dans les runtimeData sont gardées et donc l'action de modification va connaître tous les champs mal renseignés et va pouvoir les mettre en exergue.

retour au sommaire

Création : 05 juillet 2005 - Sébastien GAUDIN (Université Nancy 2)
Modifications :