JSP - A diretiva da página

o pagediretiva é usada para fornecer instruções ao contêiner que pertencem à página JSP atual. Você pode codificar as diretivas de página em qualquer lugar em sua página JSP. Por convenção, as diretivas de página são codificadas na parte superior da página JSP.

A seguir está a sintaxe básica da diretiva de página -

<%@ page attribute = "value" %>

Você pode escrever o equivalente em XML da sintaxe acima da seguinte maneira -

<jsp:directive.page attribute = "value" />

Atributos

A tabela a seguir lista os atributos associados à diretiva da página -

S.No. Atributo e finalidade
1

buffer

Especifica um modelo de buffer para o fluxo de saída.

2

autoFlush

Controla o comportamento do buffer de saída do servlet.

3

contentType

Define o esquema de codificação de caracteres.

4

errorPage

Define a URL de outro JSP que relata exceções de tempo de execução não verificadas do Java.

5

isErrorPage

Indica se esta página JSP é um URL especificado pelo atributo errorPage de outra página JSP.

6

extends

Especifica uma superclasse que o servlet gerado deve estender.

7

import

Especifica uma lista de pacotes ou classes para uso no JSP como a instrução de importação Java faz para classes Java.

8

info

Define uma string que pode ser acessada com o servlet getServletInfo() método.

9

isThreadSafe

Define o modelo de encadeamento para o servlet gerado.

10

language

Define a linguagem de programação usada na página JSP.

11

session

Especifica se a página JSP participa ou não das sessões HTTP.

12

isELIgnored

Especifica se a expressão EL na página JSP será ignorada ou não.

13

isScriptingEnabled

Determina se os elementos de script podem ser usados.

O atributo buffer

o buffer atributo especifica as características de buffer para o objeto de resposta de saída do servidor.

Você pode codificar um valor de "none"para não especificar nenhum buffer para que a saída do servlet seja imediatamente direcionada ao objeto de resposta ou você pode codificar um tamanho máximo de buffer em kilobytes, que direciona o servlet para gravar no buffer antes de gravar no objeto de resposta.

Para direcionar o servlet para gravar a saída diretamente no objeto de saída de resposta, use o seguinte -

<%@ page buffer = "none" %>

Use o seguinte para direcionar o servlet para gravar a saída em um buffer de tamanho não inferior a 8 kilobytes -

<%@ page buffer = "8kb" %>

O atributo autoFlush

o autoFlush attribute especifica se a saída do buffer deve ser liberada automaticamente quando o buffer é preenchido ou se uma exceção deve ser levantada para indicar o estouro do buffer.

Um valor de true (default) indica liberação de buffer automática e um valor false lança uma exceção.

A diretiva a seguir faz com que o servlet lance uma exceção quando o buffer de saída do servlet está cheio -

<%@ page autoFlush = "false" %>

Esta diretiva faz com que o servlet esvazie o buffer de saída quando estiver cheio -

<%@ page autoFlush = "true" %>

Normalmente, o buffer e os atributos autoFlush são codificados em uma única diretiva de página da seguinte maneira -

<%@ page buffer = "16kb" autoflush = "true" %>

O atributo contentType

O atributo contentType define a codificação de caracteres para a página JSP e para a página de resposta gerada. O tipo de conteúdo padrão étext/html, que é o tipo de conteúdo padrão para páginas HTML.

Se você quiser escrever XML de seu JSP, use a seguinte diretiva de página -

<%@ page contentType = "text/xml" %>

A instrução a seguir direciona o navegador para processar a página gerada como HTML -

<%@ page contentType = "text/html" %>

A diretiva a seguir define o tipo de conteúdo como um documento do Microsoft Word -

<%@ page contentType = "application/msword" %>

Você também pode especificar a codificação de caracteres para a resposta. Por exemplo, se você quiser especificar que a página resultante que é retornada ao navegador useISO Latin 1, você pode usar a seguinte diretiva de página -

<%@ page contentType = "text/html:charset=ISO-8859-1" %>

O atributo errorPage

o errorPageatributo informa ao mecanismo JSP qual página exibir se houver um erro enquanto a página atual é executada. O valor do atributo errorPage é um URL relativo.

A diretiva a seguir exibe MyErrorPage.jsp quando todas as exceções não capturadas são lançadas -

<%@ page errorPage = "MyErrorPage.jsp" %>

O atributo isErrorPage

o isErrorPage atributo indica que o JSP atual pode ser usado como a página de erro para outro JSP.

O valor de isErrorPage é verdadeiro ou falso. O valor padrão do atributo isErrorPage é falso.

Por exemplo, o handleError.jsp define a opção isErrorPage como true porque é para lidar com erros -

<%@ page isErrorPage = "true" %>

O atributo extends

o extends attribute especifica uma superclasse que o servlet gerado deve estender.

Por exemplo, a diretiva a seguir direciona o conversor JSP para gerar o servlet de forma que o servlet estenda somePackage.SomeClass -

<%@ page extends = "somePackage.SomeClass" %>

O atributo de importação

o importattribute tem a mesma função e se comporta como a instrução de importação Java. O valor da opção de importação é o nome do pacote que você deseja importar.

Importar java.sql.*, use a seguinte diretiva de página -

<%@ page import = "java.sql.*" %>

Para importar vários pacotes, você pode especificá-los separados por vírgula da seguinte forma -

<%@ page import = "java.sql.*,java.util.*"  %>

Por padrão, um contêiner importa automaticamente java.lang.*, javax.servlet.*, javax.servlet.jsp.*, e javax.servlet.http.*.

O atributo info

o infoatributo permite fornecer uma descrição do JSP. A seguir está um exemplo de codificação -

<%@ page info = "This JSP Page Written By ZARA"  %>

O atributo isThreadSafe

o isThreadSafeopção marca uma página como thread-safe. Por padrão, todos os JSPs são considerados thread-safe. Se você definir a opção isThreadSafe como false, o mecanismo JSP garante que apenas um encadeamento por vez esteja executando seu JSP.

A seguinte diretiva de página define o isThreadSafe opção para falso -

<%@ page isThreadSafe = "false"  %>

O atributo da linguagem

o language atributo indica a linguagem de programação usada no script da página JSP.

Por exemplo, como você geralmente usa Java como linguagem de script, sua opção de linguagem se parece com isto -

<%@ page language = "java" %>

O atributo da sessão

o sessionatributo indica se a página JSP usa ou não sessões HTTP. Um valor true significa que a página JSP tem acesso a um builtinsession object e um valor false significa que a página JSP não pode acessar o objeto de sessão integrado.

A diretiva a seguir permite que a página JSP use qualquer um dos métodos de sessão de objeto embutido, como session.getCreationTime() ou session.getLastAccessTime() -

<%@ page session = "true" %>

O Atributo isELIgnored

O atributo isELIgnored oferece a capacidade de desabilitar a avaliação de expressões Expression Language (EL) que foram introduzidas no JSP 2.0.

O valor padrão do atributo é verdadeiro, o que significa que as expressões, ${...}, são avaliados conforme ditado pela especificação JSP. Se o atributo for definido como falso, as expressões não serão avaliadas, mas tratadas como texto estático.

A diretiva a seguir define uma expressão a não ser avaliada -

<%@ page isELIgnored = "false" %>

O atributo isScriptingEnabled

o isScriptingEnabled atributo determina se os elementos de script têm permissão para uso.

o default value (true)habilita scriptlets, expressões e declarações. Se o valor do atributo for definido como falso, um erro de tempo de tradução será gerado se o JSP usar qualquer scriptlets, expressões (não EL) ou declarações.

O valor do atributo pode ser definido como falso se você quiser restringir o uso de scriptlets, expressões (não EL) ou declarações -

<%@ page isScriptingEnabled = "false" %>