Les directives de Java Server Pages (JSP)

D├ęcembre 2016

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

A voir également :

Ce document intitulé «  Les directives de Java Server Pages (JSP)  » issu de CommentCaMarche (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.