JSP: la directiva de páginas
los pageLa directiva se utiliza para proporcionar instrucciones al contenedor que pertenecen a la página JSP actual. Puede codificar las directivas de la página en cualquier lugar de su página JSP. Por convención, las directivas de página se codifican en la parte superior de la página JSP.
A continuación se muestra la sintaxis básica de la directiva de página:
<%@ page attribute = "value" %>
Puede escribir el equivalente XML de la sintaxis anterior de la siguiente manera:
<jsp:directive.page attribute = "value" />
Atributos
La siguiente tabla enumera los atributos asociados con la directiva de página:
S.No. | Atributo y propósito |
---|---|
1 | buffer Especifica un modelo de almacenamiento en búfer para el flujo de salida. |
2 | autoFlush Controla el comportamiento del búfer de salida del servlet. |
3 | contentType Define el esquema de codificación de caracteres. |
4 | errorPage Define la URL de otra JSP que informa sobre las excepciones de tiempo de ejecución no comprobadas de Java. |
5 | isErrorPage Indica si esta página JSP es una URL especificada por el atributo errorPage de otra página JSP. |
6 | extends Especifica una superclase que debe ampliar el servlet generado. |
7 | import Especifica una lista de paquetes o clases para su uso en JSP como lo hace la declaración de importación de Java para las clases de Java. |
8 | info Define una cadena a la que se puede acceder con el servlet getServletInfo() método. |
9 | isThreadSafe Define el modelo de subprocesamiento para el servlet generado. |
10 | language Define el lenguaje de programación utilizado en la página JSP. |
11 | session Especifica si la página JSP participa o no en sesiones HTTP. |
12 | isELIgnored Especifica si se ignorará o no la expresión EL dentro de la página JSP. |
13 | isScriptingEnabled Determina si se permite el uso de los elementos de secuencias de comandos. |
El atributo de búfer
los buffer atributo especifica las características de almacenamiento en búfer para el objeto de respuesta de salida del servidor.
Puede codificar un valor de "none"para especificar que no hay almacenamiento en búfer para que la salida del servlet se dirija inmediatamente al objeto de respuesta o puede codificar un tamaño máximo de búfer en kilobytes, lo que indica al servlet que escriba en el búfer antes de escribir en el objeto de respuesta.
Para indicar al servlet que escriba la salida directamente en el objeto de salida de respuesta, utilice lo siguiente:
<%@ page buffer = "none" %>
Utilice lo siguiente para indicar al servlet que escriba la salida en un búfer de tamaño no inferior a 8 kilobytes:
<%@ page buffer = "8kb" %>
El atributo autoFlush
los autoFlush atributo especifica si la salida almacenada en el búfer debe vaciarse automáticamente cuando se llena el búfer o si se debe generar una excepción para indicar el desbordamiento del búfer.
Un valor de true (default) indica el vaciado automático del búfer y un valor de falso lanza una excepción.
La siguiente directiva hace que el servlet lance una excepción cuando el búfer de salida del servlet está lleno:
<%@ page autoFlush = "false" %>
Esta directiva hace que el servlet vacíe el búfer de salida cuando está lleno -
<%@ page autoFlush = "true" %>
Por lo general, el búfer y los atributos de autoFlush se codifican en una directiva de una sola página de la siguiente manera:
<%@ page buffer = "16kb" autoflush = "true" %>
El atributo contentType
El atributo contentType establece la codificación de caracteres para la página JSP y para la página de respuesta generada. El tipo de contenido predeterminado estext/html, que es el tipo de contenido estándar para páginas HTML.
Si desea escribir XML desde su JSP, use la siguiente directiva de página:
<%@ page contentType = "text/xml" %>
La siguiente declaración indica al navegador que represente la página generada como HTML:
<%@ page contentType = "text/html" %>
La siguiente directiva establece el tipo de contenido como un documento de Microsoft Word:
<%@ page contentType = "application/msword" %>
También puede especificar la codificación de caracteres para la respuesta. Por ejemplo, si desea especificar que la página resultante que se devuelve al navegador utilizaISO Latin 1, puede utilizar la siguiente directiva de página:
<%@ page contentType = "text/html:charset=ISO-8859-1" %>
El atributo errorPage
los errorPageEl atributo le dice al motor JSP qué página mostrar si hay un error mientras se ejecuta la página actual. El valor del atributo errorPage es una URL relativa.
La siguiente directiva muestra MyErrorPage.jsp cuando se lanzan todas las excepciones no detectadas:
<%@ page errorPage = "MyErrorPage.jsp" %>
El atributo isErrorPage
los isErrorPage El atributo indica que la JSP actual se puede utilizar como página de error para otra JSP.
El valor de isErrorPage es verdadero o falso. El valor predeterminado del atributo isErrorPage es falso.
Por ejemplo, el handleError.jsp establece la opción isErrorPage en true porque se supone que maneja errores -
<%@ page isErrorPage = "true" %>
El atributo extiende
los extends atributo especifica una superclase que el servlet generado debe extender.
Por ejemplo, la siguiente directiva ordena al traductor JSP que genere el servlet de manera que el servlet se extienda somePackage.SomeClass -
<%@ page extends = "somePackage.SomeClass" %>
El atributo de importación
los importEl atributo tiene la misma función y se comporta como la declaración de importación de Java. El valor de la opción de importación es el nombre del paquete que desea importar.
Importar java.sql.*, use la siguiente directiva de página -
<%@ page import = "java.sql.*" %>
Para importar varios paquetes, puede especificarlos separados por comas de la siguiente manera:
<%@ page import = "java.sql.*,java.util.*" %>
De forma predeterminada, un contenedor importa automáticamente java.lang.*, javax.servlet.*, javax.servlet.jsp.*, y javax.servlet.http.*.
El atributo info
los infoEl atributo le permite proporcionar una descripción de la JSP. El siguiente es un ejemplo de codificación:
<%@ page info = "This JSP Page Written By ZARA" %>
El atributo isThreadSafe
los isThreadSafeLa opción marca una página como segura para subprocesos. De forma predeterminada, todas las JSP se consideran seguras para subprocesos. Si establece la opción isThreadSafe en false, el motor JSP se asegura de que solo un hilo a la vez esté ejecutando su JSP.
La siguiente directiva de página establece el isThreadSafe opción a falso -
<%@ page isThreadSafe = "false" %>
El atributo del idioma
los language El atributo indica el lenguaje de programación utilizado en la creación de scripts de la página JSP.
Por ejemplo, debido a que normalmente usa Java como lenguaje de scripting, su opción de idioma se ve así:
<%@ page language = "java" %>
El atributo de sesión
los sessionEl atributo indica si la página JSP utiliza sesiones HTTP. Un valor de verdadero significa que la página JSP tiene acceso a unsession object y un valor de false significa que la página JSP no puede acceder al objeto de sesión incorporado.
La siguiente directiva permite que la página JSP utilice cualquiera de los métodos de sesión de objetos integrados, como session.getCreationTime() o session.getLastAccessTime() -
<%@ page session = "true" %>
El atributo isELIgnored
El atributo isELIgnored le brinda la capacidad de deshabilitar la evaluación de expresiones de lenguaje de expresión (EL) que se ha introducido en JSP 2.0.
El valor predeterminado del atributo es verdadero, lo que significa que las expresiones, ${...}, se evalúan según lo dicta la especificación JSP. Si el atributo se establece en falso, las expresiones no se evalúan sino que se tratan como texto estático.
La siguiente directiva establece una expresión que no se evaluará:
<%@ page isELIgnored = "false" %>
El atributo isScriptingEnabled
los isScriptingEnabled El atributo determina si se permite el uso de los elementos de secuencias de comandos.
los default value (true)habilita scriptlets, expresiones y declaraciones. Si el valor del atributo se establece en falso, se generará un error de tiempo de traducción si la JSP usa scriptlets, expresiones (no EL) o declaraciones.
El valor del atributo se puede establecer en falso si desea restringir el uso de scriptlets, expresiones (no EL) o declaraciones:
<%@ page isScriptingEnabled = "false" %>