Struts

Struts est un framework proposant un cadre logiciel pour l'organisation des échanges avec l'utilisateur et la dynamique de l'application. Il promeut une structuration de la couche Servlet-JSP suivant le modèle MVC II. La définition de la dynamique de l'application est partiellement déclarative, via un fichier de configuration, partiellement implémentée, au sein des classes Action.

Struts est un projet Open Source développé par la communauté Jakarta d'Apache. Il a débuté en mai 2000 sous la direction de Craig R Mc Clanahan, qui participe également au développement de Tomcat. Aujourd'hui, Struts est géré par plusieurs committers. Sa mailing-list comporte un millier de personnes. C'est un projet très actif. Expliquons tout d'abord ce qu'est un framework (lit. Structure) : architecture et ensemble d'outils de développement. J2EE est un Framework Java pour les développements web. Les Frameworks ont l'avantage de structurer, simplifier, segmenter les développements et donc les accélérer. Struts fournit un framework MVC comprenant les composants suivants :

• un contrôleur facilement configurable permettant d'associer des actions (méthode d'un objet Java) à des requêtes HTTP ;

• des bibliothèques de tags spécifiques pour créer facilement une vue ;

• un Digester, permettant de parser un fichier XML et d'en récupérer seulement les informations voulues.

II-A. Le modèle▲

II-B. La vue▲

II-C. Taglibs de Struts▲

II-D. Le contrôleur▲

II-E. Le framework Struts ▲

II-F. Les frameworks MVC2 les plus avancés▲

Struts Struts est un Framework MVC pour développer des applications web, développé en Open Source dans le cadre du projet Jakarta de l'ASF ( Apache Software Foundation ).

Les framewoks sont des structures logicielles qui définissent des cadres dans lesquels viennent s'insérer les objets et concepts spécifiques à une application. En pratique, un framework (traduction littérale : squelette d'application) est un ensemble de classes et de mécanismes associés à une architecture logicielle qui fournissent un ou plusieurs services techniques ou métiers aux applications qui s'appuient dessus. Alors qu'un framework métier fournit des services à forte plus-value fonctionnelle (gestion de clients, d'abonnements, de news…) un framework technique apporte les concepts, entités et mécanismes qui permettent, dans le cadre d'une architecture logicielle retenue, de s'abstraire d'un certain nombre de problématiques conceptuelles et techniques récurrentes. J2EE est un Framework Java pour les développements web. Les Frameworks ont l'avantage de structurer, simplifier, segmenter les développements et donc les accélérer. Struts prend en compte les problématiques de performance, sécurité, multilangue…


Le MVC : acronyme synonyme de séparation des composants de type « Model » (logique métier et accès aux données), « View » (présentation des informations) et « Controller » (la gestion des interactions des utilisateurs).
Le modèle MVC s'appuie essentiellement sur la séparation en deux couches verticales regroupant d'un côté les objets métier (Modèle) et de l'autre les objets IHM, ces derniers étant eux-mêmes regroupés en objets chargés de l'acquisition d'informations, en provenance de l'utilisateur (contrôleur) et en objets chargés de la restitution d'informations vers l'utilisateur (Vue).

Le modèle MCV II hérite des propriétés du modèle MVC. Son organisation cependant capitalise sur la longue expérience acquise avec MVC et s'adapte au contexte des applications Internet et de la plateforme J2EE.
Dans le modèle MVC II, le servlet est unique, en classe et en instance. Il garantit l'unicité du point d'entrée de l'application. Il prend en charge une partie du contrôle de l'application. Les contrôleurs MVC se retrouvent alors partiellement déportés dans l'entité dynamique de l'application qui assure le contrôle de la dynamique de l'application et qui gère les relations entre les objets métier et la présentation. Les contrôleurs deviennent essentiellement des contrôleurs du dialogue entre l'utilisateur et les objets métier.

• 1. Le client envoie une requête à l'application. La requête est prise en charge par le servlet d'entrée.

• 2. Le servlet d'entrée analyse la requête et réoriente celle-ci vers un contrôleur adapté.

• 3. Le contrôleur sélectionné par le servlet d'entrée est responsable de l'exécution des traitements nécessaires à la satisfaction de la requête. Il sollicite les objets métier lorsque nécessaire.

• 4. Les objets métier fournissent des données au contrôleur.

• 5. Le contrôleur encapsule les données métier dans des JavaBeans, sélectionne la JSP qui sera en charge de la construction de la réponse et lui transmet les JavaBeans contenant les données métier.

• 6. La JSP construit la réponse en faisant appel aux JavaBeans qui lui ont été transmis et l'envoie au navigateur.

• 7. Lorsque nécessaire, pour le traitement d'erreurs essentiellement, le servlet d'entrée traite la requête directement, sélectionne la JSP de sortie et lui transmet par JavaBean les informations dont elle a besoin.
  
  
  
  La taglib bean
  
  Les tags de cette bibliothèque peuvent être vus comme des améliorations des tags JSP <jsp :useBean> <jsp :getProperty> et <jsp :setProperty>. En effet, ils permettent de rendre accessibles des objets dans les contextes standards (page, session, application) via des variables de scripting. Il est ensuite possible de récupérer, de modifier ou d'afficher les valeurs des propriétés de ces objets.
  Par exemple si la session contient un objet nommé « item » disposant d'une méthode getPrize() et que l'on veut afficher son prix, il suffira d'écrire :

<bean:write name='item' property='prize'/>

Struts supporte également les nested et indexed properties. Par exemple si la session contient un objet nommé « items » et a une méthode getItem(int item) qui renvoie un item. il est possible d'écrire :

<bean:write name='items' property='item[2].prize'/>

La taglib bean propose également un tag permettant d'afficher un message en fonction de la langue de l'utilisateur. Dans l'optique de créer une application supportant plusieurs langues, les pages JSP ne doivent pas contenir de texte mais faire appel à ce tag. Dans Struts, les messages destinés à l'utilisateur sont associés à une clé et définis dans des fichiers spéciaux. Chaque fichier contient les messages dans une langue donnée. Le tag

<bean :message key='titre.index'/>

affichera le texte sous la clé titre.index dans la langue principale définie par le browser si disponible ou sinon dans la langue par défaut.


La taglib HTML
Cette bibliothèque contient les tags nécessaires à la création d'interfaces utilisateur dynamiques, et notamment des formulaires.

Les tags permettent de remplir automatiquement les champs à afficher et de retourner les valeurs en vue de leur gestion par le contrôleur. Ceci se fait en spécifiant dans le tag le nom de la propriété qui doit être affichée/modifiée. Cette propriété correspond à une propriété JavaBeans d'un objet Formulaire qui aura été spécialement écrit par le développeur pour servir d'interface entre la vue et le contrôleur.

Les autres tags de la bibliothèque permettent :

• d'afficher les messages d'erreur relatifs à l'application ou au remplissage d'un champ donné ;

• de gérer plus facilement les liens et les sessions.
  
  Voici par exemple comment créer un formulaire permettant de se loguer :

<html:form action= &#8216;/logon' focus='username'>
Username : <HTML:text property='username'/> <br>
Password: <html:password property='password'/>
<HTML:submit property="submit" value="Submit"/>
</html:form>

L'utilisation de ce formulaire est plus détaillée dans la section exemple.


La taglib logic

Cette bibliothèque définit un ensemble de tags permettant d'inclure ou de ne pas inclure le corps des tags en fonction de critères logiques portant sur la valeur des propriétés d'un objet. Il est également possible d'effectuer des itérations.
Par exemple, pour afficher un message en fonction de l'âge de l'utilisateur :

<logic:greaterThan name='utilisateur' property='age' value='17'>
Vous êtes majeurs !
</logic:greaterThan>

Ou pour afficher tous les prénoms des enfants d'une personne :

<logic:iterate name='user' property='enfants' id='enfant'>
<bean:write name='enfant'/><br> </logic :iterate>

La taglib template

Cette dernière bibliothèque est destinée à faciliter la création de pages suivant un modèle. Pour un exemple courant, imaginons la barre de navigation en haut de la page, une zone centrale et un copyright en bas. Les templates permettent de définir la barre de navigation et le copyright, puis de les inclure aisément dans toutes les pages.

IV-A. Easy Way to start▲

IV-B. Expert and Full installation▲

Struts est fourni avec une application exemple très simple. Celle-ci montre comment effectuer des tâches courantes comme afficher un formulaire, récupérer les données, les réafficher, afficher des listes dynamiques, etc.

Fonctionnalités

L'application exemple permet à un utilisateur de s'enregistrer et de maintenir une liste des différents comptes mails qu'il a sur Internet. Les actions qu'il est possible d'effectuer avec cette application sont :

- se loguer (associé par le contrôleur à la classe Logon Action) ;
- se déloguer (classe LogoffAction) ;
- enregistrer ses coordonnées (classe SaveRegistrationAction) ;
- enregistrer les propriétés d'un compte mail (classe SaveSubscriptionAction) ;
- afficher ses coordonnées (classe EditRegistrationAction) ;
- afficher les propriétés d'un compte mail (classe EditSubscriptionAction).

L'application est composée de cinq pages :

- la page d'accueil, index.jsp ;
- la page de login, logon.jsp ;
- le menu principal, mainMenu.jsp ;
- la page permettant d'afficher les propriétés de l'utilisateur, registration.jsp ;
- la page permettant d'afficher la configuration d'un compte mail de l'utilisateur, subscription.jsp.

Grâce à l'emploi de la taglib logic, les pages servant à l'affichage des propriétés de l'utilisateur et de ses comptes servent aussi pour la création, la modification et la suppression. Les pages contenant des formulaires (logon.jsp, registration.jsp, subscription.jsp) sont chacune associées à un objet Form (on trouve respectivement les classes LogonForm, RegistrationForm et SubscriptionForm).


Ensemble des composants formant un traitement
Examinons en détail le processus permettant de se loguer.
La page logon.jsp contient les tags suivants :

<html:form action= &#8216;/logon' focus='username'> &#8230;
<HTML:text property='username'/> &#8230; <HTML:password property='password'/> &#8230; <HTML:submit property="submit" value="Submit"/> &#8230;
</html:form> &#8230;

ce qui provoque l'affichage d'un formulaire avec deux champs login/password et un bouton submit.

Voici ce qui se passe lorsqu'on clique sur submit :

1. La requête est envoyée à l'adresse logon.do à laquelle va répondre le contrôleur de Struts.

2. Le contrôleur utilise le fichier struts-config.xml pour déterminer quel est le formulaire qui va permettre la validation des données (dans notre exemple il s'agit de LogonForm) et quelle est l'action associée à cette requête (dans notre exemple il s'agit de LogonAction).

Extraits du fichier struts-config.xml  :

… 
<!-- Logon form bean --> 
<form-bean name="logonForm"type="org.apache.struts.example.LogonForm"/> &#8230;
<!-- Process a user logon -->
<action path="/logon" type="org.apache.struts.example.LogonAction" name="logonForm" 
scope="request" input="/logon.jsp">
</action> &#8230;

3. Le servlet va donc instancier un LogonForm et l'initialiser avec les valeurs des attributs fournis dans la requête (password et username). Pour ce faire LogonForm propose les méthodes setUsername et setPassword :

public class LogonForm extends ActionForm { … public void setPassword(String password) { …} public void setUsername(String username) {…} public String getUsername() {…} public String getPassword() {…} … }

4. Le servlet va ensuite appeler la méthode validate() de LogonForm. Celle-ci renvoie une erreur si au moins un des deux champs est vide.

public class LogonForm extends ActionForm { … public ActionErrors validate( ActionMapping mapping, HttpServletRequest request) { ActionErrors errors = new ActionErrors(); 

if ((username == null) || (username.length() < 1)) errors.add("username", new 
ActionError("error.username.required")); 

if ((password == null) || (password.length() < 1)) errors.add("password", new ActionError( "error.password.required")); return errors; } }

5. S'il n'y a pas d'erreur, le contrôleur va appeler la méthode perform() de LogonAction. Sinon il va renvoyer à la page de login.

6. La méthode perform() contient le code métier associé à une opération d'authentification.

public class LogonAction extends Action { … public ActionForward perform( ActionMapping mapping, ActionForm form, HttpServletRequest request, HttpServletResponse response) throws … 
{
// récupération des paramètres 
String username = ((LogonForm) form).getUsername(); 
String password = ((LogonForm) form).getPassword(); 
// récupération de la base de données 
Hashtable database = (Hashtable) servlet.getServletContext().getAttribute(..) ; 

// création de l'utilisateur // (utilisation du modèle) 
User user = (User) database.get(username); 
if (user!=null && (!user.getPassword().equals(password))) user=null; 
if (user==null) 
errors.add(ActionErrors.GLOBAL_ERROR, new ActionError("error.password.mismatch")); 

// si on a des erreurs, retour à la page de login 
if (!errors.empty()) { saveErrors(request, errors); 
return (new ActionForward(mapping.getInput())); } 

// OK, sauvegarde de l'utilisateur 
HttpSession session = request.getSession(); 
session.setAttribute(Constants.USER_KEY, user); … 
// renvoie à la page suivante 
return (mapping.findForward("success")); }

Le code source complet de l'application est fourni avec Struts.

Extension du framework Struts a été conçu de façon à pouvoir être aisément modifié par les développeurs pour répondre à leurs besoins particuliers. Cela se voit dans l'application exemple, qui redéfinit la classe ActionMapping pour introduire la notion de « success » et de « failure » pour une action. Des tags spécifiques sont également introduits pour vérifier si un utilisateur est logué ou non et pour écrire plus facilement certains liens.

Struts est un framework qui permet de développer des applications web en utilisant le modèle MVC2. Les applications conçues ainsi sont plus facilement maintenables et évolutives, de par la séparation des fonctionnalités du modèle, du contrôle, et de la vue. L'utilisation du framework permet au développeur de se concentrer sur le modèle, Struts fournissant le cadre nécessaire au contrôle et à l'interface de l'application, permettant un développement rapide de ces parties. Struts préfigure une nouvelle méthode de développement, succession de la programmation par servlets. Néanmoins, il convient d'ajouter que l'écriture d'une application utilisant Struts ne doit pas se décider à la légère : un certain temps est nécessaire pour prendre en main le concept et les API.

Le déploiement d'un servlet unique dont le comportement est configuré par fichier donne une grande flexibilité à la gestion de la navigation de l'application. Ce fonctionnement limite, par ailleurs, considérablement les adhérences entre les applications développées et les serveurs d'application sur lesquels elles sont déployées. Cet avantage est cependant estompé par la généralisation du support, par les différents serveurs d'application, des formats de déploiement standardisés (format WAR notamment).

La centralisation des accès à l'application permet un contrôle fin et personnalisé des accès aux traitements (Actions) et offre une grande marge de manœuvre pour la gestion des profils ou des rôles utilisateurs. L'abstraction des traitements et des ressources par le modèle des commandes, en occultant les informations relatives à la structuration de l'application, apporte une plus grande sécurité de cette dernière. Struts fait partie des projets Open Source Jakarta de l'ASF (Apache Software Foundation). À ce titre les sources du framework sont publiques. Le framework Struts en conséquence aisément adaptable et extensible. Son appartenance au projet Jakarta d'Apache garantit par ailleurs sa pérennité et la capacité importante de développement, dans un but opérationnel et non de recherche et développement, que la communauté Java lui consent.

Enfin, Struts suscitant un grand intérêt de la part de la communauté Java, de nombreux articles et exemples de mises en œuvre ainsi que diverses extensions sont aujourd'hui publiés sur divers sites Internet, que ce soit ou non sous l'égide du projet officiel.

Tutoriel en version HTML, pour obtenir tous les liens disponibles à

http://www.nuxora.com/download.php

Bibliographie :

http://arkzoyd.free.fr/struts902/struts-01.html http://www.application-servers.com/

http://www.jspinsider.com/tutorials/jsp/struts/struts.view

http://www.waferproject.org/index.html

http://www.improve-institute.com/formation_jakarta_struts.html

http://struts.application-servers.com/

http://www-106.ibm.com/developerworks/library/j-struts/?dwzone=java

http://www.waferproject.org/index.html

Le projet Struts http://jakarta.apache.org/struts

Le serveur Tomcat http://jakarta.apache.org/tomcat

Le parseur XML de Sun http://java.sun.com/xml