Editor visual sun-web.xml: Sessão

Consulte também

O editor visual sun-web.xml permite que você edite o descritor de implantação específico para plataforma do servidor de aplicativos Sun Java System. Você pode abrir o editor visual expandindo o nó Arquivos de configuração do projeto na janela Projetos e clicando duas vezes no arquivo sun-web.xml. Um aplicativo da Web contém um descritor de implantação sun-web.xml somente se seu servidor de destino for o servidor de aplicativos Sun Java System.

A guia Sessão do editor ajuda você a configurar o tipo de persistência e as propriedades de sessão para uma sessão do aplicativo da Web. As propriedades de sessão são agrupadas nas categorias seguintes:

Tipo de persistência

Selecione o tipo de persistência na lista suspensa. Esta tabela descreve os tipos de persistência suportados pelo servidor de aplicativos.

Tipo Descrição
Memory

Use este tipo de persistência para armazenar dados de sessão na memória do sistema.

Arquivo

Use este tipo de persistência para armazenar dados de sessão em um arquivo. Se a instância se tornar não diposnível e se reiniciar, ela pode recuperar a informação de sessão escrita pela última vez nos arquivos.

Propriedades do gerenciador

As propriedades do gerenciador ajudam você a configurar como as sessões serão criadas e destruídas, onde o estado da sessão será armazenado e o número máximo de sessões.

A tabela abaixo lista os parâmetros do gerenciador de sessão.

Nome Descrição
reapIntervalSeconds O número de segundos após os quais o servidor de aplicativos vai checar se há sessões que já expiraram. É esse também o intervalo no qual as sessões adotam a postura passiva se maxSessions for excedido.
maxSessions O número máximo de sessões ativas. Se não há limite no número de sessões ativas, digite -1. O gerenciador de sessão faz as sessões adotarem a postura passiva para o armazenamento persistente quando o número máximo for atingido. Esta propriedade vale somente se o tipo de persistência for Arquivo.
sessionFilename O caminho de nome absoluto ou relativo do arquivo em que o estado de sessão é preservado entre os reinícios do aplicativo, desde que seja possível a preservação do estado. Um nome de caminho relativo é relativo com respeito ao diretório temporário para este módulo da Web.

Propriedades de armazenamento

As propriedades de armazenamento controlam como as sessões são armazenadas no servidor de aplicativos.

A tabela seguinte lista os parâmetros de armazenamento de sessão.

Nome Valor
directory O caminho de nome absoluto ou relativo do diretório em que são escritos os arquivos de sessão individual. Um caminho relativo é relativo com respeito ao diretório de trabalho temporário para este módulo da Web. Esta propriedade vale somente se o tipo de persistência for Arquivo.

Propriedades de sessão

As propriedades de sessão ajudam você a configurar como as sessões se comportam no servidor de aplicativos.

A tabela seguinte lista as propriedades de sessão.

Nome Valor
timeoutSeconds O intervalo de inatividade máximo padrão, em segundos, para todas as sessões criadas neste módulo da Web. Se for definido como 0 ou com um valor menor, as sessões neste módulo da Web nunca expirarão. O valor do elemento session-timeout no web.xml substitui e anula este valor.
enableCookies Se esta propriedade estiver configurada como verdadeiro, os cookies serão usados para o rastreamento da sessão.
enableURLRewriting Se esta propriedade estiver configurada como verdadeiro, a reescrita da URL estará ativada. Isto provê rastreamento da sessão por meio da reescrita da URL quando o navegador não aceita cookies. Você deve usar também uma chamada encodeURL ou encodeRedirectURL no servlet ou na JSP.
idLengthBytes O número de bytes no ID de sessão deste módulo da Web.

Propriedades do cookie

As propriedades do cookie especificam os cookies gerados pelo servidor de aplicativos. A tabela seguinte lista as propriedades do cookie de sessão.

Nome Valor
cookiePath O nome de caminho definido quando o cookie é criado. O navegador envia o cookie se o nome de caminho da solicitação contém esse caminho. Se estiver configurado como / (barra inclinada), o navegador envia cookies para todos os URLs servidos pelo servidor de aplicativos. Você pode configurar o caminho para um mapeamento mais restrito, a fim de limitar os URLs aos quais o navegador envia cookies.
cookieMaxAgeSeconds O tempo de expiração, em segundos, após o qual o navegador faz expirar o cookie.
cookieDomain O domínio no qual o cookie é válido.
cookieComment O comentário que identifica o cookie de rastreamento de sessão no arquivo de cookie. Os aplicativos podem prover um comentário mais específico para o cookie.
Consulte também
Sobre os descritores de implantação
Editando os descritores de implantação do aplicativo da Web
Alterando o servidor de destino.
Editor visual sun-web.xml:
         Geral
         Sessão
         Mensagens
         Localidade
         Mapeamentos do cache
         Descritor de serviços da Web

Notificações legais