A codificação de caracteres de página é a codificação na qual é escrito o arquivo JSP. A especificação de JSP 2.0 distingue entre duas sintaxes ao detectar a codificação de caracteres de página:
Para arquivos em sintaxe JSP padrão, a codificação é detectada através da busca de duas fontes primárias de informação: Primeiro, no descritor de implantação (o arquivo web.xml), por um elemento page-encoding em um jsp-property-group cujo padrão de URL concorde com o arquivo; em seguida, por um atributo pageEncoding na própria página. Se não forem encontrados, será usado o charset do atributo contentType do arquivo JSP ou, em último caso, a codificação de caracteres ISO 8859-1.
Para arquivos em sintaxe de documentos JSP, a codificação é detectada conforme descrito na especificação de XML. O que indica que o padrão é UTF-8 e que qualquer outra codificação deve ser declarada na declaração XML no início do arquivo.
Para configurar a codificação de caracteres de página de um arquivo em sintaxe JSP padrão:
Para arquivos JSP (sintaxe padrão), a codificação de página é definida da seguinte maneira:
Crie um arquivo JSP que utilize a sintaxe JSP padrão. Clique com o botão direito do mouse no arquivo JSP e escolha Propriedades. Observe que a propriedade Codificação está definida como UTF-8. Essa é a codificação de página do arquivo JSP. Não é possível alterar a codificação de página em Propriedades.
O local de configuração da codificação de página depende se a configuração for realizada para um arquivo JSP individual ou para um grupo de arquivos JSP. As etapas abaixo guiam você na configuração da codificação de página para arquivos JSP.
Para alterar a codificação de página do arquivo JSP, adote um dos seguintes procedimentos:
Defina a codificação de caracteres de página de um arquivo JSP individual. Clique duas vezes no arquivo JSP para abri-lo no Editor de código. O atributo pageEncoding padrão de um arquivo JSP criado no IDE corresponde a:
<%@page pageEncoding="UTF-8"%>
Você pode alterar a codificação de página no arquivo JSP e salvá-lo. Observe que o IDE exibe um aviso se você tentar salvar um conjunto de caracteres que não é válido para páginas JSP.
Em vez disso, como alternativa, defina a codificação de página no atributo contentType da diretiva page. O atributo contentType padrão de um arquivo JSP não contém valores charset porque o atributo pageEncoding manipula a codificação de página por padrão. No entanto, você pode adicionar um valor charset como se segue:
<%@page contentType="text/html;charset=UTF-8"%>
Defina a codificação de caracteres de página de grupos de arquivos JSP. Expanda o nó Páginas da Web, depois o nó WEB-INF e, em seguida, clique duas vezes no arquivo web.xml. Clique em Páginas na parte superior do editor e, em seguida, clique no cabeçalho Grupo de propriedades JSP para abrir a seção Grupo de propriedades JSP. Use a seção Grupo de propriedades JSP para adicionar, remover e exibir grupos de propriedades JSP de um aplicativo da Web. Um grupo de propriedades JSP consiste em um conjunto de propriedades definidas para um grupo de arquivos JSP em um aplicativo da Web. Uma das propriedades que pode ser definida aqui é o valor de codificação de página de um grupo de arquivos JSP.
Somente se os outros dois estiverem ausentes é que o atributo contentType da diretiva page de um arquivo JSP será usado como codificação de página. Se nenhum for proporcionado, o ISO-8859-1 é usado como codificação de página. Se você definir a codificação de página com um valor no grupo de propriedades JSP e lhe der outro valor em uma diretiva pageEncoding do arquivo JSP individual, ocorrerá um erro no tempo de tradução.
Para configurar a codificação de caracteres de página de um arquivo em sintaxe de documento JSP:
Para documentos JSP (sintaxe XML), a codificação de página é definida da seguinte maneira:
Crie um arquivo JSP que use sintaxe XML. Clique com o botão direito do mouse no documento JSP e escolha Propriedades. Observe que a propriedade Codificação está definida como UTF-8. Essa é a codificação de página do documento JSP. Não é possível alterar a codificação de página em Propriedades. Para os documentos JSP, a codificação de caracteres de página pode ser alterada somente em um lugar:
O atributo encoding de uma declaração XML no início do arquivo. A declaração XML é conhecida também como prólogo XML.
A codificação de página de documentos JSP também pode ser descrita em uma diretiva de página do documento JSP individual ou em um grupo de propriedades JSP, contanto que os valores aí descritos correspondam ao valor derivado do prólogo XML. Consiste em um erro no tempo de tradução especificar codificações diferentes no prólogo XML e nas declarações em um documento ou grupo de propriedades JSP. Do contrário, se o prólogo XML não especificar uma codificação, a codificação UTF-8 é obtida.
Clique duas vezes no arquivo JSP para abri-lo no Editor de código. A declaração XML padrão de um documento JSP criado no IDE inclui o seguinte atributo de codificação:
<?xml version="1.0" encoding="UTF-8"?>
Você pode alterar a codificação na declaração XML e salvar o documento JSP.