Las directivas, se trata de palabras clave fundamentales a la hora de realizar nuestra pagina JSP, podemos diferencias dos directivas: Page, Include.
Directiva Include
Esta directiva se usa para incluir un fichero dentro de la propia pagina JSP en construcción. Se pueden añadir páginas JSP, HTML o ficheros de texto, incluso ficheros con código Java. Sobre todo hay que tener cuidado que los ficheros de texto que anexemos no incluyan las etiquetas <html>, </html>, <body>, o </body>, ya que podrian confundirse con las propias de nuestra página JSP.
Hay dos tipos de Include, estatico o dinamico:
- Estatico: Es un fichero que es analizado y su contenido es anexado a la página JSP resultante.
- Dinamico: La página JSP realiza una solicitud a la URL indicada que envia de vuelta un resultado que es anexado a la página JSP.
La manera de realizar un include en una posicion especifica de una página JSP es:
<%@ include file="URL" %>
Directiva Page
Esta directiva se usa para definir las propiedades de la página JSP que estemos realizando. Esta directiva la podemos usar varias veces a lo largo de la pagina JSP, pero solo podemos asignar el valor de un atributo una vez por cada uno excepto para el atributo import; este es similar al import que usamos cuando hacemos programas en java.
La directiva page la podemos poner en cualquier sitio de la pagina JSP, ya que su valor se aplicara a toda la pagina.
Síntaxis de Page
Los valores por defecto se muestran en negrita. Los corchetes ([...]) indican un término opcional. La barra vertical (|) proporciona una elección entre dos valores como true y false.
Sintaxis:
<%@ 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="URLrelativa"]
[ contentType="text/html; charset=ISO-8859-1"]
[ isErrorPage="true|false"]
%>
Atributos de la Directiva Page
language="java"
Este atributo define el lenguaje de script usado en los scriptles, declaraciones y expresiones en el fichero JSP y en cualquier fichero incluido. En JSP 1.0 el único lenguaje permitido es Java.
extends="package.class"
Este atributo especifica un nombre totalmente cualificado de una superclase que será extendida por la clase Java en el fichero JSP. Sun recomienda que usemos este atributo con cuidado, ya puede limitar la habilidad del motor del JSP a proporcionar la superclase especializada que mejora la calidad del fichero compilado.
import= "{ package.class | package.* }, ..."
Esta lista especifica una lista separada por comas de uno o más paquetes o clases que el fichero JSP debería importar. Las clases de los paquetes se ponen a disposición de los scriptlets, expresiones, declaraciones y etiquetas dentro del fichero JSP.
Como cabría esperar, el atributo import debe aparecer antes de cualquier etiqueta que refiera la clase importada. Para importar varios paquetes, podemos usar una lista separada por comas, más de una directiva import o una combinación de ambas.
session="true|false"
Todo cliente debe unirse a una sesión HTTP para poder usar una página JSP. Si el valor es true, el objeto session se refiere a la sesión actual o a una nueva sesión. Si el valor es false, no podemos utilizar el objeto session en el fichero JSP. El valor por defecto es true.
buffer="none|8kb|sizekb"
Este atributo especifica el tamaño del buffer en kilobytes que será usado por el objeto out para manejar la salida envíada desde la página JSP compilada hasta el navegador cliene. El valor por defecto es 8kb.
"true|false"
Este atributo especifica si la salida sería envíada o no cuando el buffer esté lleno. Por defecto, el valor es true, el buffer será descargado. Si especificamos false, se lanzará una excepción cuando el buffer se sobrecargue.
isThreadSafe="true|false"
Este atributo especifica si la seguridad de threads está implementada en el fichero JSP. El valor por defecto, true, significa que el motor puede enviar multiples solicitudes concurrentes a la página.
Si usamos el valor por defecto, varios threads pueden acceder a la página JSP. Por lo tanto, debemos sincronizar nuestros métodos para proporcionar seguridad de threads.
Con false, el motor JSP no envía solicitudes concurrentes a la página JSP. Probablemente no querremos forzar esta restricción en servidores de gran volumen porque puede dañar la habilidad del servidor de envíar nuestra página JSP a múltiples clientes.
info="text"
Este atributo nos permite especificar una cadena de texto que es incorporada en el página JSP compilada. Podemos recuperar el string más tarde con el método getServletInfo().
errorPage="URLrelativa"
Este atributo especifica un path a un fichero JSP al que este fichero JSP envía excepciones. Si el path empieza con una "/", el path es relativo al directorio raíz de documentos de la aplicación JSP y es resuelto por el servidor Web. Si no, el path es relativo al fichero JSP actual.
isErrorPage="true|false"
Este atributo especifica si el fichero JSP muestra una página de error. Si es true, podemos usar el objeto exception, que contiene una referencia a la excepción lanzada, en el fichero JSP. Si es false (el valor por defecto), significa que no podemos uar el objeto exception en el fichero JSP.
contentType="mimeType [ ; charset=characterSet ]" | "text/html;charset=ISO-8859-1"
Este atributo especifica el tipo MIME y la codificación de caracteres que use el fichero JSP cuando se envía la respuesta al cliente. Podemos usar cualquier tipo MIME o conjunto de caracteres que sean válidos para el motor JSP.