Directive Page  

La directive page définit les attributs dépendants des pages, comme par exemple le langage de script, les page d'erreur et la configuration de mémoire tampon requise.

Une unité de traduction JSP (le fichier source et tous les fichiers inclus via la directive include) peut contenir plusieurs directives page sous réserve que tous les attributs, à l'exception de l'attribut import, n'y figurent qu'une seule fois. Si plusieurs valeurs d'attribut import sont utilisées, elles sont combinées en une seule et même liste de définitions import.

Exemple :

<%@ page language="java" 
  contentType="text/html;charset=Shift_JIS"%>
<%@ page import="java.util.*, java.text.*" %>
<%@ page import="java.sql.Date" %>
autoFlush Valeur par défaut : true

Définir sur true si la mémoire tampon de la page doit être vidée automatiquement lorsqu'elle est pleine ou bien sur false si une exception doit être déclenchée lorsqu'elle est pleine.

buffer Valeur par défaut : 8 kb

Spécifie la taille de la mémoire tampon de la page. Cette valeur doit être exprimée sous forme de taille en kilo-octets suivie de kb, ou correspondre au mot-clé none pour pouvoir désactiver la mise en mémoire tampon.

contentType Valeur par défaut : text/html

Le type MIME de la réponse générée par la page, et éventuellement le jeu de caractères de la page source (par exemple, text/html;charset=Shift_JIS).

errorPage Aucune valeur par défaut

Un chemin d'URI d'une page ou d'un contexte sur lequel la page JSP enverra les utilisateurs si une exception est déclenchée par un code de la page.

extends Aucune valeur par défaut

Le nom qualifié complet d'une classe Java étendue par la classe d'implémentation de page JSP générée. Cette classe doit implémenter l'interface JspPage ou HttpJspPage dans la classe javax.servlet.jsp package.

Notez qu'il est recommandé de ne pas utiliser cet attribut. En spécifiant votre propre superclasse, vous limitez la capacité du container web à fournir une superclasse spécialisée très performante.

import Aucune valeur par défaut

Une déclaration d'importation de Java ; c'est-à-dire une liste séparée par des virgules des noms qualifiés complets des classes ou des noms de paquets suivie de .* (pour toutes les classes publiques du paquet).

info Aucune valeur par défaut

Texte qu'un container web peut utiliser pour décrire la page dans son interface utilisateur d'administration.

isErrorPage Valeur par défaut : false

Définir sur true pour une page utilisée comme page d'erreur afin que les éléments de script puissent accéder à la variable d'exception implicite. Utiliser false pour les pages JSP normales.

isThreadSafe Valeur par défaut : true

Définir sur true si le container est autorisé à exécuter plusieurs threads dans la page (c'est-à-dire laisser la page envoyer des demandes parallèles). Si défini sur false, le container sérialise toutes les demandes de la page. Il peut également utiliser un pool d'instances de classe d'implémentation de page JSP pour envoyer plusieurs demandes en même temps. Il est recommandé de toujours utiliser la valeur true et de gérer les problèmes de multithread en contournant les déclarations JSP et en vérifiant que tous les objets utilisés par la page sont thread-safe.

language Valeur par défaut : java

Le langage de script utilisé dans la page.

session Valeur par défaut : true

Définir sur true si la page doit participer à une session utilisateurs. Si défini sur false, la variable session implicite n'est pas disponible pour les éléments de script de la page.