Java EE / Spring

JSTL.

JSP Standard Tag Library (JSTL) est une librairie qui étend les fonctionnalités de JSP en mettant à disposition de nouveaux tags à utiliser dans le HTML. L'objectif est de permettre d'écrire du code plus facilement et de manière plus cohérente avec le reste du HTML.
Ainsi, un développeur front-end ne sera pas trop perdu dans l'utilisation de ces balises, même si il ne connait rien à JAVA.

L'implémentation de base fourni différents types de balises regroupées dans différents espaces de nommage XML. Comprenez différents module dont on identifiera le nom dans le préfixe de la balise. Il existe ainsi les tags "core" (c), les tags "xml" (x), les tags "format" (fmt) et les tags "sql" (sql).

JSTL 1.2 offre également des facilités pour la manipulation et l'affichage des données provenant du "model". Cela va se faire par ce qui est nommé "Expression Language" (EL). Une expression est une chaine du type ${expression}. "expression" peut simplement être le nom d'une variable du modèle ou une fonction plus aboutie fournie par EL.

Pour indiquer à notre compilateur JSP que notre page utilisera JSTL et EL, il suffit de placer cette déclaration de la taglib en haut de notre page JSP.
<%@ taglib prefix="c" uri="http://java.sun.com/jstl/core" %>
Ensuite les balises préfixées par "c" seront interprétées par le compilateur et généreront du code java particulier.

Liste des tags du "core"

La taglib "core" fourni un ensemble de tag permettant de gérer de l'affichage et affectation de variable, des boucles, des conditions, de la création d'url en fonction du contexte, des redirections ...

Les autres taglibs ne devraient pas vous être utile dans le cadre de ce cours.

• "xml" : permet de traiter ou requêter une structure xml
• "format" : permet de gérer l'internationnalisation des contenus de page et des formats (date, monnaies ...)
• "sql" : permet d'exécuter des requêtes SQL directement et facilement depuis une page JSP.
  Dans le cadre de nos développements cela ne s'avère pas être une bonne pratique.
  Cela reste toutefois utile pour de petits développements dont le périmètre est restreint à un type de base.

Mise en oeuvre dans notre projet avec Spring

Tous les objets affectés au modèle sont exposés de manière immédiate par les EL.
Pour reprendre l'exemple de la liste des auteurs, si l'on a fait ceci dans notre contrôleur :

    List<Author> authors = dao.listAll();
    model.addAttribute("authors", authors);
  

    <%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>
    <h1>Auteurs</h1>

    <c:choose>
      <c:when test="${empty authors}">
      Liste des auteurs vide
      </c:when>
      <c:otherwise>
      <ul>
       <c:forEach items="${authors}" var="author">
        <li>${author.firstname} ${author.lastname}</li>
       </c:forEach>
      </ul>
      </c:otherwise>
    </c:choose>
  

La taglib form de spring

De nouvelles taglib peuvent être créées afin d'enrichir les fonctionnalités offertes dans les vues.
Spring fournit une taglib "form" bien pratique pour manipuler les objets java à éditer dans des formulaires HTML.
Apprenons par l'exemple en observant ce que cela peut donner sur nos auteurs.

  <%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>
  <%@ taglib prefix="form" uri="http://www.springframework.org/tags/form" %>

  <h1>Author</h1>

  <form:form modelAttribute="author">
  <form:input type="hidden" path="id" /> <br/>
  firstname : <form:input path="firstname" /> <br/>
  lastname :<form:input path="lastname" /> <br/>
  <input type="submit" value="Enregistrer"/>
  </form:form>

Du côté de notre contrôleur il sera nécessaire de distinguer deux opérations. Une première pour traiter l'affichage du formulaire (en GET) et une deuxième pour gérer l'enregistrement des données du formulaire (en POST) et mettre à jour les données dans la base. Quelques annotations nous serons utiles pour distinguer les deux opérations branchées sur la même URL. Une annotation @PathVariable nous permettra d'extraire facilement une variable depuis l'url. L'annotation @ModelAttribute permettra de créer un objet automatiquement à partir des données du formulaire envoyé en POST. Toutefois, pour que cela fonctionne vous devez exposer des "setter" sur les propriétés de votre model selon la convention "javabeans".
Le code du contrôleur ressemblera au final à cela :

	@RequestMapping(value="/author/{id}.html", method=RequestMethod.GET)
	public String edit( Model model, @PathVariable("id") int id ) {
		Author author = dao.find(id);
		model.addAttribute("author", author);
		return "author/edit";
	}
	
	@RequestMapping(value="/author/{id}.html", method=RequestMethod.POST)
	public String save( Model model, @ModelAttribute Author author ) {
		dao.update(author);
		model.addAttribute("author", author);
		return "author/edit";
	}

complément sur les objets injectables avec spring web-mvc

Dans notre contrôleur, nous définissons un ensemble d'opération et nous les branchons sur des URL.
Spring est capable de gérer les appels à ces opérations en fournissant automatiquement en paramètre les objets nécessaires.
Ainsi, si pour des besoins particuliers vous avez besoin d'un paramètre fourni en GET ou en POST, vous pourriez ajouter un paramètre annoté @RequestParam

  	@RequestMapping(value="/authors.html", method=RequestMethod.GET)
  	public String listByName( Model model, @RequestParam("nameLike") String name ) {
  		List<Author> authors = dao.findAuthorsLikeName( name );
  		model.addAttribute("authors", authors);
  		return "authors";
  	}

Si vous avez besoin d'accéder à l'objet HttpServletRequest (ou Response) il vous suffit de l'ajouter à la liste des paramètres de votre opération et spring vous le passera lors de l'invocation de la méthode.
Il n'est pas recommandable de créer ce type de dépendance vers l'API servlet car votre contrôleur pourrait être utilisé dans un tout autre contexte que celui d'une application web. Toutefois, il est parfois nécessaire de le faire et spring vous en offre la possibilité.
Consulter cette page pour voir la liste des types de paramètres que spring peut vous fournir !

Projet

Avant de commencer ...

★ Rendez-vous sur cette page et estimons ensemble, en "Story Point", chacune des fonctionnalités.
https://www.pointingpoker.com/xxxxxx remplacer les xxxx par le numéro de session fourni durant le TD.

• « Spring
• ^ Sommaire ^
• ( a suivre )