Historique de la page

...

Les balises <h:messages> et <h:message> sont traitées dans un paragraphe à suivre.

 <%@include file="_include.jsp"%>

 <%@include file="_navigation.jsp"%>

<%@include file="_include.jsp"%>
<%@include file="_navigation.jsp"%>
  <h:form>
    <h:commandButton value="Move"
	action="gotoWelcome"/>
  </h:form>

<navigation-rule>
  <from-view-id>/stylesheets/test1.jsp</from-view-id>
  <navigation-case>
    <from-outcome>gotoWelcome</from-outcome>
    <to-view-id>/stylesheets/welcome.jsp</to-view-id>
    <redirect />
   </navigation-case>
</navigation-rule>

...

package org.esupportail.example.web.beans;

import javax.validation.constraints.NotNull;
import javax.validation.constraints.Size;

public class UserBean{
	/**
	 * Id of the user.
	 */
	@NotNull
	private String id;
	
        /**
	 * Display Name of the user.
	 */
	@Size(max = 10, min = 1)
        private String displayName;
	
	 
[...]
}

Pour utiliser javax.validation il faudra alors ajouter dans le pom.xml la dépendance suivante :

		<dependency>
			<groupId>javax.validation</groupId>
			<artifactId>validation-api</artifactId>
			<version>1.0.0.GA</version>
			<scope>provided</scope>
		</dependency>

ou

		<dependency>
			<dependency>
 <groupId>org.hibernate</groupId>
			 <artifactId>hibernate-validator</artifactId>
			 <version>4.0.2.GA</version>
		</dependency>

Exemple de contraintes :

• @AssertFalse : doit être faux
• @AssertTrue : doit être vrai
• @DecimalMax : doit être un nombre inférieur ou égal à la valeur indiquée (représentation String d'un BigDecimal)
• @DecimalMin : doit être un nombre supérieur ou égal à la valeur indiquée (représentation String d'un BigDecimal)
• @Digits(integer=, fraction=) : doit être un chiffre (pour BigDecimal, BigInteger, String, byte, short, int, long)
• @Future : doit être une date dans le future
• Max @Max : doit être un nombre inférieur ou égal à la valeur indiquée
• @Min : doit être un nombre supérieur ou égal à la valeur indiquée
• @NotNull : ne doit pas être null
• @Null : doit être null
• @Past : doit être une date dans le passé
• @Size(min=, max=) : doit avoir une taille comprise entre min et max (pour String et tableaux)
• @Pattern(regex=, flag=) : doit respecter la regex indiquée
• @Valid : doit être valide (pour un objet propriété d'un autre)

...

<h:inputText value="#{sampleBean.userName}">
    <f:validateBean disabled="true" />
</h:inputText>

Gestion des messages

On peut définir le message qui sera affiché en cas d'erreur de validation en précisant un attribut message dans l'annotation

@Size(max = 10, min = 1, message="{toto}")

Ici on utilise une clé (chaîne entre accolades) afin d'aller chercher le message dans un fichier de propriétés. Ce fichier doit se trouver dans le classpath et porter le nom ValidationMessages.properties

On peut le décliner ne fonction des langues ValidationMessages_en.properties, ValidationMessages_fr.properties

Mise à jour de propriétés par les formulaires (updateActionlistener)

...

private String value;
public String getValue() {
  return value;
}
public void setValue(String value) {
  this.value = value;
}

<bean id="test2Controller"
      class="org.esupportail.formation.web.controllers.Test2Controller"
      parent="abstractContextAwareController"
      scope="session">
  <description>A bean to manage the test2 page.</description>
</bean>

<%@include file="_include.jsp"%>
<%@include file="_navigation.jsp"%>
 <h:form>
   <h:outputText value="#{test2Controller.value}"/>
 </h:form>

<navigation-rule>
  <from-view-id>/stylesheets/test1.jsp</from-view-id>
  <navigation-case>
    <from-outcome>gotoWelcome</from-outcome>
    <to-view-id>/stylesheets/welcome.jsp</to-view-id>
    <redirect />
  </navigation-case>
  <navigation-case>
    <from-outcome>gotoTest2</from-outcome>
    <to-view-id>/stylesheets/test2.jsp</to-view-id>
    <redirect />
  </navigation-case>
</navigation-rule>

<%@include file="_include.jsp"%>
<%@include file="_navigation.jsp"%>
  <h:form>
    <h:messages/>
    <h:inputText value="#{test1Controller.myInput}" validator="#{test1Controller.validateMyInput}"/>
    <h:commandButton value="Move" action="#{test1Controller.callback}"/>
    <h:commandButton value="SetTest2Value" action="gotoTest2">
       <t:updateActionListener value="#{test1Controller.myInput}"
	                       property="#{test2Controller.value}"/>
    </h:commandButton>
  </h:form>

...