Création d'une première application Struts avec Eclipse


précédentsommairesuivant

3. Développement de l'application

3.1. Création du projet

La configuration étant à présent terminée, nous allons pouvoir rentrer dans le vif du sujet, c'est à dire le développement de notre première application web basée sur le framework Struts.

La première chose à faire est de créer un nouveau projet.
Pour ce faire, nous devons aller dans le menu "File --> New --> Project".

Image non disponible
  • Choisissez "Jonas Project"
  • Cliquez sur "next"
  • Choisissez le nom du projet: par exemple "FirstStruts
  • Cliquez sur "next"
  • Cochez la case "Create a web application"
  • Cliquez sur "Finish"

Voici normalement à quoi ressemblera l'arborescence de votre projet.

Image non disponible

Nous voilà maintenant prêt à ajouter le support de Struts à notre application.

  • Choisissez votre projet dans l'explorateur
  • Faites un click droit pour faire apparaître le menu
  • Choisissez "New --> Add Easy Struts support"
Image non disponible
  • Modifiez la valeur du champs "Webapp folder" par : "/webApplication"
  • Modifiez également la valeur dans le champs "Base package for generation". Par exemple : com.personalStruts.struts .
Image non disponible

3.2. Création de l'ActionForm, de l'Action et de la page jsp

Struts étant maintenant ajouté à notre application, nous allons pouvoir créer notre premier ActionForm, notre premier Action ainsi que la page jsp correspondante.

  • Choisissez votre projet dans l'arborescence
  • Faites un click droit
  • Choisissez New --> Easy Action associated with a form
Image non disponible
  • Cet écran va vous permettre de configurer votre ActionForm ainsi que votre page jsp
  • Dans le champs Use case, mettez la valeur "userinput"
  • Dans le champs "Form properties", vous pouvez ajoutez des éléments tels que le "nom", le "prenom" et l'"email".
  • Cliquez sur "next"
Image non disponible
  • L'écran suivant va vous permettre de configurer la classe Action. Vous ne devez rien modifier dans cet écran.
  • Cliquez sur "next" et sur "Finish"
Image non disponible

Vous remarquerez qu'une série de classes ont été générées lors de la création de notre premier ActionForm, Action et page jsp. Sans rentrer dans les détails, ces classes vont servir à valider les données entrées par l'utilisateur ainsi qu'à la redirection vers d'autres pages.

3.3. Code généré

Voici le code de la page jsp générée par le plugin.

userinput.jsp
Sélectionnez
 <%@ taglib uri="/WEB-INF/struts-bean.tld" prefix="bean"%> 
<%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html"%> 
<html> 
	<head>
		<meta name = "Generator" content = "Easy Struts Xslt generator for Eclipse (http://easystruts.sf.net).">

		<title>Struts Form for userinputForm</title>
	</head>
	<body>
		<html:form action="/userinput">
			email : <html:text property="email"/><html:errors property="email"/></br>
			nom : <html:text property="nom"/><html:errors property="nom"/></br>
			prenom : <html:text property="prenom"/><html:errors property="prenom"/></br>
			<html:submit/><html:cancel/>
		</html:form>
	<body>
</html>

Voici le code des 2 classes générées.

UserinputForm.java
Sélectionnez
// Created by Xslt generator for Eclipse.
// XSL :  not found (java.io.FileNotFoundException:  (Bad file descriptor))
// Default XSL used : easystruts.jar$org.easystruts.xslgen.JavaClass.xsl

package com.personalStruts.struts.form;
import javax.servlet.http.HttpServletRequest;
import org.apache.struts.action.ActionErrors;
import org.apache.struts.action.ActionForm;
import org.apache.struts.action.ActionMapping;
/** 
 * UserinputForm.java created by EasyStruts - XsltGen.
 * http://easystruts.sf.net
 * created on 05-17-2004
 * 
 * XDoclet definition:
 * @struts:form name="userinputForm"
 */
public class UserinputForm extends ActionForm {
	// --------------------------------------------------------- Instance Variables
	/** prenom property */
	private String prenom;
	/** email property */
	private String email;
	/** nom property */
	private String nom;
	// --------------------------------------------------------- Methods
	/** 
	 * Method validate
	 * @param ActionMapping mapping
	 * @param HttpServletRequest request
	 * @return ActionErrors
	 */
	public ActionErrors validate(
		ActionMapping mapping,
		HttpServletRequest request) {
		throw new UnsupportedOperationException("Generated method 'validate(...)' not implemented.");
	}
	/** 
	 * Method reset
	 * @param ActionMapping mapping
	 * @param HttpServletRequest request
	 */
	public void reset(ActionMapping mapping, HttpServletRequest request) {
		prenom = "";
		email = "";
		nom = "";
	}
	/** 
	 * Returns the prenom.
	 * @return String
	 */
	public String getPrenom() {
		return prenom;
	}
	/** 
	 * Set the prenom.
	 * @param prenom The prenom to set
	 */
	public void setPrenom(String prenom) {
		this.prenom = prenom;
	}
	/** 
	 * Returns the email.
	 * @return String
	 */
	public String getEmail() {
		return email;
	}
	/** 
	 * Set the email.
	 * @param email The email to set
	 */
	public void setEmail(String email) {
		this.email = email;
	}
	/** 
	 * Returns the nom.
	 * @return String
	 */
	public String getNom() {
		return nom;
	}
	/** 
	 * Set the nom.
	 * @param nom The nom to set
	 */
	public void setNom(String nom) {
		this.nom = nom;
	}
}
UserinputAction.java
Sélectionnez
// Created by Xslt generator for Eclipse.
// XSL :  not found (java.io.FileNotFoundException:  (Bad file descriptor))
// Default XSL used : easystruts.jar$org.easystruts.xslgen.JavaClass.xsl

package com.personalStruts.struts.action;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.apache.struts.action.Action;
import org.apache.struts.action.ActionForm;
import org.apache.struts.action.ActionForward;
import org.apache.struts.action.ActionMapping;
import com.personalStruts.struts.form.UserinputForm;

/** 
 * UserinputAction.java created by EasyStruts - XsltGen.
 * http://easystruts.sf.net
 * created on 05-17-2004
 * 
 * XDoclet definition:
 * @struts:action path="/userinput" name="userinputForm" input="/userinput.jsp" validate="true"
 */
public class UserinputAction extends Action {

	// --------------------------------------------------------- Instance Variables
	// --------------------------------------------------------- Methods
	/** 
	 * Method execute
	 * @param ActionMapping mapping
	 * @param ActionForm form
	 * @param HttpServletRequest request
	 * @param HttpServletResponse response
	 * @return ActionForward
	 * @throws Exception
	 */
	public ActionForward execute(
		ActionMapping mapping,
		ActionForm form,
		HttpServletRequest request,
		HttpServletResponse response)
		throws Exception {
		UserinputForm userinputForm = (UserinputForm) form;
		throw new UnsupportedOperationException("Generated method 'execute(...)' not implemented.");
	}
}

3.4. Création de la vue useroutput.jsp

Cette vue est la deuxième vue. Elle sera affichée lorsque les valeurs entrées dans la vue userinput.jsp seront valides.
Pour créer cette vue :

Image non disponible
  • allez dans le menu "File --> New --> File"
  • Choisissez le repertoire webApplication
  • Nommez la page jsp "useroutput.jsp"

Voici le code à ajouter à la vue pour l'affichage des valeurs valides.

useroutput.jsp
Sélectionnez
<html>
	<head>
		<title>useroutput</title>
	</head>
	<body>
		<table width="300" border="0" cellspacing="0" cellpadding="0">
			<tr>
				<td>Nom : </td>
				<td><%=request.getAttribute("nom")%></td>
			</tr>
			<tr>
				<td>Prénom : </td>
				<td><%=request.getAttribute("prenom")%></td>
			</tr>
			<tr>
				<td>Email : </td>
				<td><%=request.getAttribute("email")%></td>
			</tr>
		</table>
	</body>
</html>

3.5. Modification du code

Nous allons modifier le code de telle sorte que les données entrées par l'utilisateur puissent être validées avant de poursuivre le traitement de l'application.
Pour cela vous devez surcharger la méthode validate() de la classe UserinputForm.

méthode validate()
Sélectionnez
public ActionErrors validate(
		ActionMapping mapping,
		HttpServletRequest request) 
		{
			ActionErrors errors = new ActionErrors();
			if(nom == null || nom.length()==0)
			{
				errors.add("nom",new ActionError("error.nom.required"));
			}
			if(prenom == null || prenom.length()==0)
			{
				errors.add("prenom",new ActionError("error.prenom.required"));
			}
			if(email == null || email.length()==0)
			{
				errors.add("email",new ActionError("error.email.required"));
			}
			return errors;
		}		

Nous allons ensuite surcharger la méthode execute() de la classe UserinputAction.

méthode execute()
Sélectionnez
public ActionForward execute(
		ActionMapping mapping,
		ActionForm form,
		HttpServletRequest request,
		HttpServletResponse response)
		throws Exception {
		UserinputForm userinputForm = (UserinputForm) form;
		
		request.setAttribute("prenom", userinputForm.getPrenom());
		request.setAttribute("nom",userinputForm.getNom());
		request.setAttribute("email",userinputForm.getEmail());
		
		return mapping.findForward("succes");
	}

3.6. Modification du fichier ApplicationResources

Comme vous l'avez peut-être remarqué, dans la méthode validate() de la classe UserinputForm, nous testons la validité des variables provenant de la balise <html:form /> pour vérifier que celles-ci ne contiennent pas de valeur null ou si la longueur est 0.
Une instance d'ActionErrors est créée et une instance d'ActionError décrivant l'erreur est ajoutée à l'ActionErrors en cas de valeur invalide.
2 paramètres sont également passés à la méthode errors.add()

  • Le premier paramètre correspond à la valeur du formulaire où a été décelée l'erreur.
  • Le second paramètre est une clé permettant de retrouver une ressource dans un fichier de ressources.

Pour que cette clé soit valide, nous devons la répertorier dans le fichier ApplicationResources.properties.
Voici les lignes à ajouter au fichier.

ApplicationResources.properties
Sélectionnez

error.prenom.required=<font color=red>Prénom requis</font>
error.nom.required=<font color=red>Nom requis</font>
error.email.required=<font color=red>email requis</font>

3.7. Modification du fichier struts-config.xml

Nous allons dès à présent modifier le fichier struts-config.xml.
Nous allons ajouter une redirection dans l'élément <action/>

struts-config.xml
Sélectionnez
<action-mappings>
        <action
            attribute="userinputForm"
            input="/userinput.jsp"
            name="userinputForm"
            path="/userinput"
            type="com.personalStruts.struts.action.UserinputAction">
            <forward name="succes" path="/useroutput.jsp" />
        </action>
      </action-mappings>

La ligne que vous devez rajouter est celle-ci.

 
Sélectionnez
<forward name="succes" path="/useroutput.jsp" />

3.8. Modification du fichier web.xml

Dernière petite modification pour l'application proprement dite.
Ajouter le nom du fichier de bienvenue. Ce fichier est envoyé par le conteneur quand il reçoit un URI de requête identifiant un répertoire au lieu d'une page web.
Voici le code à ajouter au fichier web.xml pour lui spécifier la page userinput.jsp comme page de bienvenue.

 
Sélectionnez
<welcome-file-list>
      <welcome-file>userinput.jsp</welcome-file>
   </welcome-file-list>

précédentsommairesuivant

Vous avez aimé ce tutoriel ? Alors partagez-le en cliquant sur les boutons suivants : Viadeo Twitter Facebook Share on Google+   

  

Les sources présentées sur cette page sont libres de droits et vous pouvez les utiliser à votre convenance. Par contre, la page de présentation constitue une œuvre intellectuelle protégée par les droits d'auteur. Copyright © 2004 Stessy. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents, images, etc. sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.