Java Server Pages - Les directives

---

Présentation des directives JSP

Les directives JSP sont des instructions insérées dans des tags HTML spéciaux. La syntaxe des directives JSP est la suivante :

<%@ directive { attribut="valeur"} %>

Les directives JSP permettent d'indiquer :

• le langage utilisé
• les classes à inclure
• les classes à étendre
• ...

Présentation des directives JSP

La version 1.0 Revision B des Java Server Pages propose trois directives JSP :

• la directive page proposant des informations relatives à la page JSP. Cette directive possède de nombreux attributs (explicités ci-dessous)

  <%@ page
  [language="java"] [extends="package.class"]
  [import="{package.class|package.*}, ..."] [session="true|false"]
  [buffer="none|8kb|sizekb"] [autoflush="true|false"]
  [isThreadSafe="true|false"] [info="text"]
  [errorPage="relativeURL"]
  [contentType="mimeType [charset=characterSet]" |
  			 "text/html;charset=ISO-8859-17"]
  [iserrorPage="true|false"]
  %>

• la directive include permettant d'inclure des fichiers au sein de la page HTML

  <%@ include file="relativeURL" %>

• la directive taglib définissant l'adresse et le préfixe d'une librairie de balises (tags) pouvant être utilisées dans la page

  <%@ taglib uri="URIToTagLibrary" prefix="tagPrefix" %>

  Cette directive permet d'aller créer de nouveaux tags de la forme :

  <tagPrefix:name attribute="value" ... %> ... </tagPrefix:name%>

Attributs de la directive de page

Voici la liste des attributs de la directive de page

Attribut	Valeurs possibles	Description
language	java	Permet de spécifier le langage à utiliser pour traiter les instructions de la page. Java est le langage utilisé majoritairement, mais on peut imaginer des servlets écrites dans un autre langage
extends	package.class	Permet de définir une classe à étendre, c'est-à-dire la classe parente de la servlet générée par JSP
import	package.class|pakage.*	Permet d'importer une liste de classes ou de packages en début de page, au même titre que dans une application Java.
session	true|false	Permet de définir si la page actuelle peut accèder aux données stockées dans la session. Cet attribut est true par défaut
buffer	none|8kb|sizekb	Permet de définir si le flot de sortie est placé dans un tampon avant envoi. Par défaut la taille du tampon est de 8kb, mais il est possible de définir la taille en kb. Cet attribut s'utilise avec l'attribut autoflush
autoflush	true|false	La valeur true (par défaut) indique que le tampon doit être vidé lorsqu'il est plein
isThreadSafe	true|false	La valeur true (par défaut) indique que plusieurs clients peuvent utilise simultanément la servlet. Lorsqu'elle vaut false, la servlet passe en mode monothread, ce qui signifie qu'un seul client\ peut accèder à la servlet à la fois. Cela est particulièrement utile si la servlet accède à une ressource qui ne peut être partagée
info	Texte	Permet de retourner une description grâce à la méthode servlet.getServletInfo()
errorPage	URL	Permet de spécifier une page JSP chargée de gérer les exceptions non gérées par celle-ci
isErrorPage	true|false	Permet de spécifier si la page en cours est une page d'erreur
contentType	text/html;charset=ISO-8859-1	Indique le type MIME de la page ainsi que le jeu de caractères utilisés

Ce document intitulé« Java Server Pages - Les directives » issu de l'encyclopédie informatique Comment Ça Marche (www.commentcamarche.net) est mis à disposition sous les termes de la licence Creative Commons. Vous pouvez copier, modifier des copies de cette page, dans les conditions fixées par la licence, tant que cette note apparaît clairement.