Propriedades Customizadas do Contêiner de Web

É possível configurar pares de dados nome-valor, em que o nome é uma chave de propriedade e valor é um valor de sequência que pode ser utilizado para configurar propriedades de configuração do sistema interno. A definição de uma nova propriedade permite configurar uma definição além daquela disponível no console administrativo. A seguir há uma lista de algumas das das propriedades customizadas disponíveis do contêiner da Web.

Para especificar as propriedades customizadas do contêiner da Web:

  1. No console administrativo, clique em Servidores > Tipos de Servidor > WebSphere Application Servers > server_name > Configurações do Contêiner de Web > Contêiner de Web.
  2. Em Propriedades Adicionais, selecione Propriedades Customizadas.
  3. Na página Propriedades Customizadas, clique em Novo.
  4. Na página de configurações, digite o nome da propriedade customizada que você deseja configurar no campo Nome e o valor que quer configurar para ele no campo Valor.
  5. Clique em Aplicar ou em OK.
  6. Clique em Salvar na barra de tarefas do console para salvar suas alterações na configuração.
  7. Reinicie o servidor.

A seguir está uma lista de propriedades customizadas que são fornecidas com o Servidor de Aplicativos. Os tópicos Propriedades customizadas do contêiner da web específicas de JavaServer Pages e Propriedades customizadas de transporte HTTP estão listados em um tópico separado.

É possível utilizar a página de Propriedades customizadas para definir as seguintes propriedades para utilização pela Java™ virtual machine.

BodyContentBuffSize

O tamanho do buffer de conteúdo de corpo para um arquivo JavaServer Pages (JSP) pode afetar o desempenho de alguns aplicativos. Por padrão, o tamanho do buffer de conteúdo de corpo é de 512 bytes. No entanto, é possível usar a propriedade customizada BodyContentBuffSize para configurar um valor de buffer diferente.

Nome Valor Padrão
BodyContentBuffSize 512

com.ibm.ws.jsf.disablealternatefacesconfigsearch

Desativa a procura de MyFaces por META-INF/*.faces-config.xml para todos os aplicativos da Web em um servidor.

Nome Valor Padrão
com.ibm.ws.jsf.disablealternatefacesconfigsearch falso

com.ibm.ws.jsp.doNotEscapeWhitespaceCharsInExpression

Geralmente, as expressões Expression Language (EL) em arquivos de tags são avaliadas antes da compilação de um JavaServer Page (JSP). No entanto, para assegurar que uma expressão EL que contém um caractere de retorno de linha (\r), de nova linha (\n) ou de tabulação (\t) na sintaxe não cause uma exceção javax.el.Exceptionable, configure a propriedade customizada com.ibm.ws.jsp.expressionistic como true no arquivo ibm-web-ext.xml.

Nome Valor Padrão
com.ibm.ws.jsp.doNotEscapeWhitespaceCharsInExpression false

com.ibm.ws.jsp.enableDefaultIsELIgnoredInTag

Geralmente, as expressões de Linguagem de Expressão (EL) em arquivos de tags são avaliadas antes dos arquivos de tags em um JavaServer Page (JSP) serem compilados. No entanto, em algumas condições, estas expressões EL em um arquivo de tags não serão avaliadas se o atributo <el-ignored> estiver configurado como true.

Para assegurar que as expressões EL sejam sempre avaliadas, configure a propriedade customizada com.ibm.ws.jsp.enableDefaultIsELIgnoredInTag para true. O valor-padrão para esta propriedade é false.

Nome Valor Padrão
com.ibm.ws.jsp.enableDefaultIsELIgnoredInTag falso

com.ibm.ws.jsp.expressionreturnemptystring

Essa propriedade permite que você indique se deseja que o contêiner JSP retorne uma sequência vazia ou null para os valores não configurados em uma expressão.

Uma expressão, como a seguinte, pode retornar um valor nulo quando testValue for nulo em testBean:
<input type='text' name='test' value='<%=testBean.getTestValue()%>'maxlength="16"> 

Alguns aplicativos esperam que uma sequência vazia seja retornada nessas situações, em vez de um valor null. Se os aplicativos em execução esperam que uma sequência vazia seja retornada, inclua essa propriedade customizada para as configurações de contêiner da web e configure a propriedade como true.

Nome Valor Padrão
com.ibm.ws.jsp.expressionreturnemptystring false

com.ibm.ws.jsp.getWriterOnEmptyBuffer

O serviço de cache dinâmico usa limpezas para determinar quando um fragmento da web armazenável em cache, como um JSP include ou um c:import termina e o próximo fragmento da web inicia. Se você configurar a propriedade customizada com.ibm.wsspi.jsp.usecdatatrim para true para seu mecanismo JSP, todas as linhas extras e de espaço em branco no código Java gerado são removidos. Nessa situação, pode não haver nenhum conteúdo para gravar antes do primeiro esvaziamento. Se o código Java gerado contiver texto ou outro código antes da primeira liberação, ocorrerá o processamento de serviço de cache dinâmico normal.

Se você configurar a propriedade customizada com.ibm.wsspi.jsp.usecdatatrim para true e estiver usando o serviço de cache dinâmico, também deve configurar a propriedade customizada com.ibm.ws.jsp.getWriterOnEmptyBuffer para true. Essa propriedade customizada exige que o Mecanismo JSP chame a função de limpeza quando ele atingir o final dos primeiros fragmentos da Web armazenáveis em cache mesmo se não houver nenhum dado para limpar. O valor-padrão para essa propriedade é false.

Nome Valor Padrão
com.ibm.ws.jsp.getWriterOnEmptyBuffer falso

com.ibm.ws.jsp.limitBuffer

O tamanho do buffer de conteúdo de corpo dos corpos de tag para um arquivo JavaServer Pages (JSP) é reutilizado para otimizar o desempenho. Se o tamanho de um corpo da tag aumentar além do tamanho do buffer de conteúdo de corpo padrão, o buffer é redimensionado para acomodar o corpo da tag. No entanto, o buffer não é reconfigurado para o tamanho padrão após atender um pedido. Como resultado, a memória heap que é usada pela implementação org.apache.jasper.runtime.BodyContentImpl pode aumentar com o tempo. É possível configurar o tamanho do buffer de conteúdo do corpo, configurando um valor de número inteiro para a propriedade customizada BodyContentBuffSize. Para obter informações adicionais, consulte o BodyContentBuffSize.

Use a propriedade customizada com.ibm.ws.jsp.limitBuffer para desalocar grandes tamanhos de buffer de conteúdo de corpo e criar um buffer com o tamanho de buffer padrão.

Nome Valor Padrão
com.ibm.ws.jsp.limitBuffer falso

com.ibm.ws.jsp.throwExceptionForAddELResolver

Configure a propriedade com.ibm.ws.jsp.throwExceptionForAddELResolver como true se não desejar permitir que um ELResolver seja registrado em um servlet ou filtro após o aplicativo receber uma solicitação do cliente. Quando esta propriedade é configurada como true, uma IllegalStateException é determinada, conforme especificado pela especificação JSP (Java Server Pages) para o método addELResolver() da interface JspApplicationContext.

O valor-padrão para essa propriedade é false.

Nome Valor Padrão
com.ibm.ws.jsp.throwExceptionForAddELResolver falso
[z/OS]

com.ibm.ws.jsp.zosFileLockRetrying

Use a propriedade com.ibm.ws.jsp.zosFileLockRetrying para especificar, em segundos, o período de tempo durante o qual um encadeamento continua tentando obter um bloqueio em um JSP.

Um arquivo JSP é bloqueado antes do início do processo de compilação e desbloqueado após o processo de compilação ser concluído. Se um encadeamento não conseguir bloquear uma JSP, o encadeamento continua tentando obter a trava de arquivo para essa JSP para até 240 segundos. Se o encadeamento não puder obter o bloqueio durante este intervalo de tempo, uma mensagem de erro será emitida. O encadeamento não faz nenhuma tentativa adicional para obter um bloqueio para o JSP.

Nome Valor Padrão
com.ibm.ws.jsp.zosFileLockRetrying 240
[z/OS]

com.ibm.ws.jsp.zosReCompile

Use a propriedade com.ibm.ws.jsp.zosReCompile para especificar quantas vezes um encadeamento tenta bloquear uma JSP.

Depois que um encadeamento obtiver o bloqueio para um JSP, o encadeamento determinará se o JSP já está compilado. Se o JSP não estiver compilado, o encadeamento tentará compilar o JSP.

Se após o número especificado de tentativas o encadeamento não puder compilar o JSP, uma mensagem de erro será emitida. O encadeamento não faz nenhuma tentativa adicional para compilar o JSP.

Nome Valor Padrão
Padrão 5

com.ibm.ws.webcontainer.allowDotsinName

Se o arquivo estático solicitado possuir diversos pontos consecutivos no nome, a solicitação será rejeitada pelo servidor como uma solicitação proibida.

Quando essa propriedade for configurada para true, o arquivo solicitado será entregue.

Nome Valor Padrão
com.ibm.ws.webcontainer.allowDotsinName false

com.ibm.ws.webcontainer.allowPrivAccessGetResource

O caminho para o arquivo definido com a opção EDR (extended document root) não é considerado parte dos artefatos do aplicativo instalado. Portanto, o acesso ao arquivo requer permissões especiais. Uma exceção Java.security.AccessControlException: Acesso negado (java.io.FilePermission) será emitida se as permissões necessárias não forem fornecidas para esse arquivo no aplicativo da web.

Quando esta propriedade for configurada como true, o aplicativo terá permissão de acesso ao arquivo cujo caminho é definido no EDR.

Nome Valor Padrão
com.ibm.ws.webcontainer.allowPrivAccessGetResource falso

com.ibm.ws.webcontainer.AllowQueryParamWithNoEqual

Se o parâmetro de consulta em uma URL contiver apenas a sequência "name" em vez do formato esperado "name=value", o servidor retornará o valor da consulta request.getParameter("name") como nulo.

Quando esta propriedade for configurada como true, se o parâmetro de consulta em uma URL contiver apenas a sequência "name", o servidor retornará uma sequência vazia como o valor para a consulta request.getParameter("name")

Nome Valor Padrão
com.ibm.ws.webcontainer.AllowQueryParamWithNoEqual falso

com.ibm.ws.webcontainer.appendMetaInfResourcesInLooseLib

Esta propriedade remove o caminho adicional quando um aplicativo é implementado em uma configuração flexível e é usada principalmente em um ambiente ou servidor de desenvolvimento.

Nome Valor Padrão
com.ibm.ws.webcontainer.appendMetaInfResourcesInLooseLib falso

com.ibm.ws.webcontainer.asyncmaxsizetaskpool

Essa propriedade customizada especifica o tamanho máximo da fila de tarefas que é usado para conter o servlet assíncrono despachado.

Nome Valor Padrão
com.ibm.ws.webcontainer.asyncmaxsizetaskpool 5000

com.ibm.ws.webcontainer.asyncpurgeinterval

Essa propriedade customizada especifica o intervalo em que o contêiner da web limpa a fila de tarefas para liberar o recurso das tarefas canceladas.

Nome Valor Padrão
com.ibm.ws.webcontainer.asyncpurgeinterval 30000

com.ibm.ws.webcontainer.channelwritetype

Por padrão, o contêiner da Web utiliza gravações assíncronas para gravar dados de resposta em partes até o tamanho de buffer de resposta. Para respostas maiores que forem maiores que o tamanho de buffer de resposta, o contêiner da Web continua a armazenar dados de resposta na memória em buffer enquanto aguarda a conclusão de uma gravação assíncrona de uma parte de dados de resposta. Esse processo pode resultar em parte de uma grande resposta sendo retida na memória, o que pode resultar em alto uso de memória e, possivelmente, em um erro de falta de memória. Uma interrupção do servidor de aplicativos pode ocorrer quando um servidor está simultaneamente processando mais solicitações do que os encadeamentos definidos no contêiner da Web.

Se a propriedade com.ibm.ws.webcontainer.channelwritetype estiver configurada como sync, a gravação síncrona será usada, caso contrário, a gravação assíncrona será usada por padrão. Com a gravação síncrona, dados de resposta são gravados de forma síncrona em partes de até o valor de responsebuffersize e nenhum dado de resposta é armazenado em buffer na memória durante a espera pela conclusão de uma gravação síncrona de uma parte de dados de resposta. Como resultado, a quantia máxima aproximadamente de dados de resposta que são mantidos na memória é igual ao responsebuffersize multiplicado pelo número de encadeamentos de contêiner da Web. O número máximo de solicitações que podem ser simultaneamente processadas pelo contêiner da Web é limitado pelo número de encadeamentos de contêineres da Web. Os pedidos adicionais são enfileirados, enquanto aguardam a conclusão de um pedido que está sendo processado.

A propriedade customizada do contêiner da web responsebuffersize define a quantidade máxima de dados de resposta que são gravados pelo contêiner da web em uma única parte, e é de 32k por padrão. Como resultado, ela é usada para mudar o número de gravações que são requeridas pelo contêiner da web para enviar dados de resposta completos. No entanto, se um aplicativo liberar dados de resposta, os dados de resposta que estão retidos pelo contêiner da web serão gravados imediatamente, independente de responsebuffersize.

Use o seguinte par nome-valor para gravar partes de dados usando gravações síncronas.

Nome Valor Padrão
com.ibm.ws.webcontainer.channelwritetype async

com.ibm.ws.webcontainer.checkEDRinGetRealPath

A API ServletContext.getRealPath() do Servlet Java não retorna o caminho correto para um recurso solicitado quando o recurso existe em um caminho extendedDocumentRoot e não existe no caminho do aplicativo instalado. Se você desejar que a API do Servlet Java ServletContext.getRealPath() procure o recurso solicitado no caminho extendedDocumentRoot se o recurso não for localizado no caminho do aplicativo instalado, configure a propriedade customizadacom.ibm.ws.webcontainer.checkEDRinGetRealPath como true.

Quando essa propriedade é configurada como true, e o recurso solicitado também não é localizado no caminho extendedDocumentRoot, um valor nulo é retornado.

Nome Valor Padrão
com.ibm.ws.webcontainer.checkEDRinGetRealPath falso

com.ibm.ws.webcontainer.copyattributeskeyset

Essa propriedade customizada endereça uma situação em que o método request.getAttributeNames retorna uma lista de valores. Se um servlet modificar a lista usando o método request.removeAttribute, as chamadas subsequentes do método nextElement causarão uma exceção java.util.ConcurrentModificationException. Para ativar um servlet para modificar a lista, configure a propriedade customizada com.ibm.ws.webcontainer.copyattributeskeyset para true. Ao configurar esta propriedade customizada para true, uma cópia da lista de atributos é retornada, permitindo que o servlet modifique a lista sem resultar em uma exceção java.util.ConcurrentModificationException quando o método nextElement for chamado.

Nome Valor Padrão
com.ibm.ws.webcontainer.copyattributeskeyset falso

com.ibm.ws.webcontainer.decodeParamViaReqEncoding

Quando o URI da solicitação de entrada não estiver codificado para UTF-8, e se a codificação da solicitação estiver configurada como UTF-8, os caracteres cujos valores codificados forem diferentes no ISO-8859 serão exibidos incorretamente na resposta. Por exemplo, se a solicitação for enviada usando o Microsoft Internet Explorer, os caracteres serão exibidos como caracteres n-til (Ñ). Para assegurar que os caracteres sejam codificados e decodificados corretamente, com base no conjunto de codificado da solicitação, inclua a propriedade customizada do contêiner da web com.ibm.ws.webcontainer.decodeParamViaReqEncoding nas configurações do contêiner da web e configure-a como true.

Nome Valor Padrão
com.ibm.ws.webcontainer.decodeParamViaReqEncoding falso

com.ibm.ws.webcontainer.deferServingRequestsUntilEarStarted

Essa propriedade customizada adia a entrega de solicitações até que o Archive Corporativo (EAR) inteiro seja iniciado.

Nome Valor Padrão
com.ibm.ws.webcontainer.deferServingRequestsUntilEarStarted false

com.ibm.ws.webcontainer.deferServletRequestListenerDestroyOnError

Se essa propriedade customizada for configurada para true, o contêiner da web ativará o CDI para funcionar adequadamente nas páginas de erro customizadas.

Nome Valor Padrão
com.ibm.ws.webcontainer.deferServletRequestListenerDestroyOnError false

com.ibm.ws.webcontainer.disableSetCharacterEncodingAfterParametersRead

O contêiner da Web processa um método setCharacterEncoding(String) da API ServletRequest mesmo se ele for chamado após os dados de postagem serem analisados. De acordo com o Java Servlet Specification, o contêiner da web ignorará um método setCharacterEncoding(String), se o método for chamado após os dados serem analisados.

Se desejar que o contêiner da Web ignore um método setCharacterEncoding(Sequência), se o método for chamado após a análise dos dados, inclua a propriedade customizada com.ibm.ws.webcontainer.disableSetCharacterEncodingAfterParametersRead em suas definições de configuração de contêiner de Web e configure essa propriedade como true.

O valor padrão para essa propriedade é false.

Nome Valor Padrão
com.ibm.ws.webcontainer.disableSetCharacterEncodingAfterParametersRead falso

com.ibm.ws.webcontainer.disableStaticMappingCache

A propriedade customizada com.ibm.ws.webcontainer.disableStaticMappingCache permite que o usuário desative o armazenamento em cache estático. Ela pode ser configurada no console administrativo ou pelo parâmetro de contexto no arquivo web.xml.

Para desativar o armazenamento em cache estático para todos os aplicativos implementados, use um asterisco. Se desejar desativar o armazenamento em cache estático para aplicativos específicos, use uma vírgula.

Por exemplo, com.ibm.ws.webcontainer.disableStaticMappingCache=* desativa o armazenamento em cache estático para todos os aplicativos implementados. com.ibm.ws.webcontainer.disableStaticMappingCache=SpecialApp,RareApp desativa o armazenamento em cache estático apenas para esses dois aplicativos.

Também é possível configurar um parâmetro de contexto no web.xml para desativar o armazenamento em cache estático para o aplicativo. O nome do parâmetro é com.ibm.ws.webcontainer.DISABLE_STATIC_MAPPING_CACHE e configure o valor do parâmetro para true.

Não existe valor padrão para esta propriedade.

Nome Valor Padrão
com.ibm.ws.webcontainer.disableStaticMappingCache Nenhum

com.ibm.ws.webcontainer.disableSystemAppGlobalListenerLoading

Se um aplicativo do sistema for o primeiro a ser iniciado, e o aplicativo tentar carregar um listener global em uma biblioteca compartilhada que está associada ao carregador de classe do servidor, o aplicativo não carregará esse listener e impedirá que ele seja carregado ou chamado por um aplicativo posterior que não seja do sistema. Configure a propriedade customizada com.ibm.ws.webcontainer.disableSystemAppGlobalListenerLoading como true para impedir que aplicativos do sistema carreguem listeners globais. Quando essa propriedade for configurada como true, o aplicativo de sistema não tentará carregar os listeners globais e os aplicativos que não são do sistema mais recentes poderão carregá-los de uma biblioteca compartilhada que está associada a um carregador de classes do servidor.

Nome Valor Padrão
com.ibm.ws.webcontainer.disableSystemAppGlobalListenerLoading false

com.ibm.ws.webcontainer.disablexPoweredBy

Ao configurar a segurança do servidor, você poderá desativar o cabeçalho X-Powered-By se não desejar revelar qual servidor está em execução. Utilize essa propriedade customizada para desativar o cabeçalho X-Powered-By, o que evita que o cabeçalho seja enviado na resposta HTTP. O valor padrão é false Entretanto, configure essa propriedade como true, se você desejar desativar esse cabeçalho.

Nome Valor Padrão
com.ibm.ws.webcontainer.disablexPoweredBy falso

com.ibm.ws.webcontainer.disallowAllFileServing

Use a propriedade customizada com.ibm.ws.webcontainer.disallowAllFileServing para desativar o serviço de arquivo em todos os aplicativos em um servidor de aplicativos específico.

É possível ativar a entrega de arquivos em um nível global em um servidor de aplicativos usando a propriedade customizada fileServingEnabled. Entretanto, a propriedade fileServingEnabled é substituída pelas informações de implementação específicas de cada aplicativo. Portanto, a propriedade customizada atual fileServingEnabled se aplica apenas como backup no caso de um aplicativo não definir a configuração fileServingEnabled sozinho.

Para substituir globalmente essa configuração em um servidor de aplicativos específico para evitar que o servidor de aplicativos entregue arquivos estáticos, independentemente de suas configurações de implementação individuais, configure a propriedade customizada de contêiner da web com.ibm.ws.webcontainer.disallowAllFileServing como true usando o seguinte par nome-valor.

Nome Valor Padrão
com.ibm.ws.webcontainer.disallowAllFileServing falso

com.ibm.ws.webcontainer.disallowServeServletsByClassname

Quando a propriedade ServeServletsByClassnameEnabled está ativada, é possível acessar servlets diretamente, resultando em um possível risco à segurança. Defina a seguinte propriedade customizada para proibir o uso da propriedade ServeServletsByClassnameEnabled em todo o nível do servidor de aplicativos.

Nome Valor Padrão Valor Válido
com.ibm.ws.webcontainer.disallowserveservletsbyclassname true false
Nota: O valor padrão é true para o IBM® WebSphere Application Server Versão 8.5.5.6. Qualquer versão anterior terá o valor padrão configurado como false, a menos que tenha sido instalado um iFix para PI31622.

com.ibm.ws.webcontainer.discernUnavailableServlet

Tipicamente, quando o contêiner da Web recebe um UnavailableException, ele não pode determinar se a exceção foi emitida a partir de um servlet ou um recurso despachado. Assim, o contêiner da Web automaticamente marca o servlet como indisponível mesmo se ele for o recurso despachado que está indisponível.

Se estiver em execução na Versão 7.0.0.5 ou mais recente, e configurar a propriedade customizada com.ibm.ws.webcontainer.discernUnavailableServlet como true, qualquer UnavailableException emitida de um recurso despachado será colocada em um wrapper. Esse wrapper permite que o contêiner da Web determine se a exceção foi emitida a partir do servlet ou de um recurso despachado. Se a exceção não for emitida pelo servlet, o contêiner da Web não marcará o servlet como indisponível.

Nome Valor Padrão
com.ibm.ws.webcontainer.discernUnavailableServlet falso

com.ibm.ws.webcontainer.dispatcherRethrowSER

O RequestDispatcher propaga as exceções dos servlets despachados de volta para os servlets de despacho. Esta é uma mudança no comportamento de liberações anteriores. Se não desejar que o aplicativo retorne exceções ao servlet que está fazendo o despacho, inclua a propriedade customizada com.ibm.ws.webcontainer.dispatcherRethrowSER nas configurações para o contêiner da web e configure a propriedade como false.

Nome Valor Padrão
com.ibm.ws.webcontainer.dispatcherRethrowSER true
Configurações suportadas Configurações suportadas: A propriedade customizada com.ibm.ws.webcontainer.dispatcherRethrowSError suplantará a propriedade customizada com.ibm.ws.webcontainer.dispatcherRethrowSER. Ao ativar a propriedade customizada com.ibm.ws.webcontainer.dispatcherRethrowSError, configurando seu valor para true, a propriedade customizada com.ibm.ws.webcontainer.dispatcherRethrowSER também será configurada como true.sptcfg

com.ibm.ws.webcontainer.dispatcherRethrowSError

Quando um arquivo JavaServer Page (JSP) contém um erro de compilação, o erro de tempo de execução é capturado e manipulado diretamente pelo contêiner. Exceções não são propagadas e endereçadas pelo recurso JSP despachado. Com a propriedade customizada com.ibm.ws.webcontainer.dispatcherRethrowSError, as exceções serão propagadas de volta para o recurso JSP despachado.

Nome Valor Padrão
com.ibm.ws.webcontainer.dispatcherRethrowSError falso
Configurações suportadas Configurações suportadas: A propriedade customizada com.ibm.ws.webcontainer.dispatcherRethrowSError suplanta a propriedade customizada com.ibm.ws.webcontainer.dispatcherRethrowSER. Ao ativar a propriedade customizada com.ibm.ws.webcontainer.dispatcherRethrowSError, configurando seu valor para true, a propriedade customizada com.ibm.ws.webcontainer.dispatcherRethrowSER também é configurada como true.sptcfg
[z/OS]

com.ibm.ws.webcontainer.divertrecursiveexceptiontoerrorlog

Quando um erro recursivo ocorre em um aplicativo, a mensagem de exceção é registrada pelo método de auditoria de rastreio, que direciona a mensagem para o console do sistema. Se, em vez disso, você precisar que a mensagem seja registrada no log de erro, inclua a propriedade customizada com.ibm.ws.webcontainer.divertrecursiveexceptiontoerrorlog nas configurações do contêiner da web e configure a propriedade para true. Quando com.ibm.ws.webcontainer.divertrecursiveexceptiontoerrorlog property estiver configurado como true, as mensagens de exceção serão enviadas para o log de erro em vez do console do sistema.

Nome Valor Padrão
com.ibm.ws.webcontainer.divertrecursiveexceptiontoerrorlog falso

com.ibm.ws.webcontainer.donotservebyclassname

A propriedade customizada com.ibm.ws.webcontainer.donotservebyclassname especifica uma lista de classes que não pode ser atendida pelo nome de classe.

Nome Valor Padrão
com.ibm.ws.webcontainer.donotservebyclassname Nenhum

com.ibm.ws.webcontainer.emptyServletMappings

Se configurado para true, a propriedade customizada com.ibm.ws.webcontainer.emptyServletMappings retornará uma coleção vazia quando os mapeamentos de servlet forem solicitados pelo método getMappings() e nenhum mapeamento tiver sido incluído ainda.

Nome Valor Padrão
com.ibm.ws.webcontainer.emptyServletMappings falso

com.ibm.ws.webcontainer.enabledefaultservletrequestpathelements

Para mapear corretamente um pedido em um servlet padrão, você deve determinar o caminho do servlet adequado e os valores PathInfo. A tabela a seguir mostra os efeitos nos valores Servlet Path e PathInfo durante a configuração da propriedade customizada com.ibm.ws.webcontainer.enabledefaultservletrequestpathelements como um valor true ou false.
Tabela 1. Valores de Caminho de Servlet e PathInfo. Valores para Caminho de Servlet e PathInfo
Valor Valor de Caminho de Servlet Valor de PathInfo
true Configurar para o conteúdo do URI após o Caminho de Contexto Configurar para um valor nulo
false (Padrão) Configurar para uma cadeia vazia Configurar baseado no conteúdo do URI após o Caminho de Contexto

com.ibm.ws.webcontainer.enableErrorExceptionTypeFirst

Quando uma exceção ocorre, o contêiner de Web procura uma página de erro para manipular essa exceção. A ordem de procura padrão é:
  1. Qualquer página de erro de código de erro correspondente
  2. Qualquer página de erro de tipo de exceção correspondente

A página de código de erro correspondida é sempre retornada, mesmo que também haja uma página de erro de tipo de exceção correspondente definida no arquivo web.xml. Para ter a procura de contêiner de web e usar o tipo de exceção antes do código de erro, configure essa propriedade como true.

Nome Valor Padrão
com.ibm.ws.webcontainer.enableErrorExceptionTypeFirst false

com.ibm.ws.webcontainer.enableExactMatchJSecurityCheck

Especifique essa propriedade se você permitir que a palavra-chave j_security_check seja usada como parte do nome de um recurso. Normalmente, se um URI contiver a palavra-chave j_security_check, o processo de login será iniciado.

Nome Valor Padrão
com.ibm.ws.webcontainer.enableExactMatchJSecurityCheck false

com.ibm.ws.webcontainer.enableJspMappingOverride

Quando um url-pattern for definido no jsp-property-group do web.xml, geralmente ele será mapeado e manipulado pelo mecanismo JavaServer Page (JSP). Se você tiver aplicativos que devem substituir esse mapeamento para que eles possam tratar e servir os próprios conteúdos JSP, configure a propriedade com.ibm.ws.webcontainer.enableJspMappingOverride como true.

Nome Valor Padrão
com.ibm.ws.webcontainer.enableJspMappingOverride false

com.ibm.ws.webcontainer.enableMultiReadOfPostData

Configure a propriedade customizada com.ibm.ws.webcontainer.enableMultiReadOfPostData como true se desejar ativar múltiplas leituras de pós-dados. Quando essa propriedade for configurada como true, os dados de postagem podem ser lidos diversas vezes como um InputStream ou Reader, e como parâmetros.

Quando o contêiner da web estiver ativado para várias leituras de dados postados, será possível configurar um aplicativo para concluir as seguintes ações, se você desejar que o aplicativo releia os dados postados a partir do início, usando um InputStream ou Leitor:
  1. Obtenha o InputStream ou Leitor
  2. Leia os dados
  3. Feche o InputStream ou Leitor

Se a primeira ou a terceira ação não ocorrer, a próxima leitura dos pós-dados não é reconfigurada para o início desses dados.

O contêiner da Web automaticamente completa essa sequência se um aplicativo reler os dados de postagem como parâmetros.

Nome Valor Padrão
com.ibm.ws.webcontainer.enableMultiReadOfPostData false

com.ibm.ws.webcontainer.excludehandledtypesclasses

Use a propriedade customizada com.ibm.ws.webcontainer.excludehandledtypesclasses para impedir que as classes de tipo de manipulação sejam passadas no método onStartup da classe de implementação ServletContainerInitializer.

Nome Valor Padrão
com.ibm.ws.webcontainer.excludehandledtypesclasses false

com.ibm.ws.webcontainer.extractHostHeaderPort and trusthostheaderport

O método getServerPort depende do método getVirtualPort do canal, que retorna um número de porta na seguinte ordem:
  1. Número da porta da URL do pedido
  2. O número da porta a partir do cabeçalho do host de pedido.
Esta ordem é compatível com HTTP/1.1 RFC, mas não com a API do Java Servlet Specification Versão 2.4, que requer que o número da porta seja retornado primeiro a partir do cabeçalho do host, se houver, ou do URL de pedido. A URL correta retornada para o exemplo anterior é: http://ProxyServer:8888. O contêiner da Web foi modificado para retornar um número da porta a partir do cabeçalho do host, se houver, ou a porta URL que aceitou a conexão do cliente. É necessário configurar trusthostheaderport e a propriedade customizada com.ibm.ws.webcontainer.extractHostHeaderPort como true para retornar primeiro o número da porta a partir do cabeçalho do host de solicitação. Usando o console administrativo, você configuraria essas propriedades da seguinte maneira:
trusthostheaderport = true     
com.ibm.ws.webcontainer.extractHostHeaderPort = true
Evitar Problemas Evitar Problemas: Você NÃO PODE configurar essas propriedades em web.xml para fazer com que entrem em vigor conforme pretendido.gotcha
É possível configurar essas propriedades como propriedades customizadas de contêiner da web no console administrativo, usando os dois seguintes conjuntos de pares nome-valor:
Nome Valor Padrão
com.ibm.ws.webcontainer.extractHostHeaderPort falso
trusthostheaderport falso
[z/OS]

com.ibm.ws.webcontainer.fileWrapperEvents

Os arquivos estáticos são manipulados por um wrapper de arquivos que não gera dados SMF e PMI para arquivos estáticos. Na Versão 5.1, o processamento dos arquivos estáticos foi executado por SimpleFileServlet, que gerou dados SMF e PMI. Se estiver migrando da Versão 5.1, e precisar gerar dados SMF e PMI ao entregar arquivos estáticos, inclua a propriedade customizada com.ibm.ws.webcontainer.fileWrapperEvents em suas configurações de contêiner da web e configure a propriedade para true.

Nome Valor Padrão
com.ibm.ws.webcontainer.fileWrapperEvents falso
[z/OS]

com.ibm.ws.webcontainer.FileWrapperEventsLessDetail

O registro SMF tipo 120 exibe o nome do recurso estático em vez do FileServletWrapper no campo de nome de um relatório de arquivo estático. Se você migrou de uma versão anterior do produto e desejar que seu registro 120 do tipo SMF exiba FileServletWrapper no campo de nome de um relatório de arquivo estático, inclua a propriedade customizada com.ibm.ws.webcontainer.FileWrapperEventsLessDetail em suas configurações de contêiner da web e configure-a como true.

Nome Valor Padrão
com.ibm.ws.webcontainer.FileWrapperEventsLessDetail false

com.ibm.ws.webcontainer.finishresponseonclose

Use a propriedade customizada com.ibm.ws.webcontainer.finishresponseonclose para indicar que você deseja que o contêiner da web feche uma conexão quando um servlet chamar close() em um gravador ou fluxo de saída.

Geralmente, quando um servlet chama close() em um gravador ou fluxo de saída, o contêiner da web envia os dados que são gravados no gravador ou fluxo de saída para o cliente e, em seguida, espera a conclusão do método service() do servlet antes de fechar a conexão. Esse atraso pode ser interpretado como um atraso de conclusão de resposta, especialmente se um método service() do servlet não for concluído até um tempo após o escritor ou fluxo de saída ser fechado.

Nome Valor Padrão
com.ibm.ws.webcontainer.finishresponseonclose false

com.ibm.ws.webcontainer.ForceDifferentCookiePaths

Quando você configura um aplicativo para usar um cookie para controlar a sessão, o caminho padrão para o cookie é configurado para a raiz de contexto do aplicativo. Portanto, o cookie só é enviado para pedidos que são feitos para esse aplicativo. Para alterar o caminho padrão para que seja "/" (barra), de tal forma que o cookie seja enviado às solicitações para qualquer aplicativo neste domínio, configure a propriedade customizada do gerenciador de sessões ForceDifferentCookiePaths.

Nome Valor Padrão
com.ibm.ws.webcontainer.ForceDifferentCookiePaths falso

com.ibm.ws.webcontainer.handlingRequestWithOverridenPath

Quando um aplicativo substituir o pathinfo do URI, o servidor não usará o caminho substituído para atender à solicitação mas, em vez disso, usará o pathinfo do URI da solicitação original. Se desejar que o servidor use o caminho do URI substituído, configure com.ibm.ws.webcontainer.handlingRequestWithOverridenPath como true. Normalmente, quando um aplicativo substitui o caminho do URI da solicitação, esse caminho do URI é usado pelo aplicativo e não pelo servidor.

Nome Valor Padrão
com.ibm.ws.webcontainer.handlingRequestWithOverridenPath falso

com.ibm.ws.webcontainer.HTTPOnlyCookies

A propriedade customizada com.ibm.ws.webcontainer.HTTPOnlyCookies fornece um nível de defesa contra um script do lado do cliente que acessa um cookie protegido e adquire seu conteúdo. Quando você usa essa propriedade customizada, é possível evitar que os scripts Java que são executados em um navegador acessem todos os cookies ou uma lista específica de cookies de sua escolha. O atributo HTTPOnly é incluído em cada cookie especificado nessa propriedade customizada e ativa a proteção contra acesso do script do lado do cliente.
Evitar Problemas Evitar Problemas: Especificar com.ibm.ws.webcontainer.HTTPOnlyCookies sem operandos significa que o atributo HTTPOnly NÃO será incluído em nenhum cookie e qualquer script Java do lado do cliente que é executado em um navegador pode acessar o conteúdo de todos os cookies.gotcha
É possível especificar os valores a seguir para essa propriedade:
  • * - Um valor de asterisco significa que todos os cookies recebem o atributo HTTPOnly.
  • Uma lista delimitada por vírgulas dos cookies específicos que recebem o atributo HTTPOnly. Os cookies podem conter caracteres curinga. O atributo HTTPOnly é fornecido somente aos cookies correspondidos que estão nessa lista.
Os exemplos a seguir ilustram como especificar estas duas configurações:
com.ibm.ws.webcontainer.HTTPOnlyCookies=*
com.ibm.ws.webcontainer.HTTPOnlyCookies=cookieName1,Account3Cookie,JsessionID 
Atenção: Os nomes de cookie que são usados ao especificar com.ibm.ws.webcontainer.HTTPOnlyCookies não fazem distinção entre maiúsculas e minúsculas.
Importante: O atributo HTTPOnly para cookies JSESSIONID e LTPA está ativado, por padrão. Antes do WebSphere Application Server Versão 8.0, o padrão de propriedade customizada com.ibm.ws.security.addHttpOnlyAttributeToCookies era false. Para WebSphere Application Server Versão 8.5, o padrão é true.
Para Usuários de Transição Para Usuários de Transição: O atributo HTTPOnly para cookies JSESSIONID e LTPA está ativado, por padrão. Antes do WebSphere Application Server Versão 8.0, o padrão de propriedade customizada com.ibm.ws.security.addHttpOnlyAttributeToCookies era false. O valor padrão atual é true.

Como o atributo HTTPOnly é configurado agora usando o campo Configurar cookies de sessão como HTTPOnly para ajudar a evitar ataques cross-site scripting no console administrativo, se for necessário desativar essa função, no console administrativo, clique em Tipos de servidor > Servidores de aplicativos > Gerenciamento de sessões > Cookies, e desmarque o campo Configurar cookies de sessão como HTTPOnly para ajudar a evitar ataques cross-site scripting.

trns

Para obter mais informações sobre a interação dessas duas propriedades customizadas, consulte Configurações do Cookie e Considerações de ativação e de migração dos Recursos de reforço de segurança.

Nome Valor Padrão
com.ibm.ws.webcontainer.HTTPOnlyCookies Nenhum

com.ibm.ws.webcontainer.ignoreinjectionfailure

Se um recurso ou uma injeção do Enterprise JavaBeans (EJB) falhar durante o processo de inicialização do servlet, uma mensagem de erro é gravada nos arquivos de log do servidor. No entanto, a mensagem de erro não é propagada para o cliente. Além disso, o servlet é colocado em serviço e não é reinicializado até que seu aplicativo seja reiniciado. Durante esse tempo, se um pedido for recebido que faça referência ao recurso, que anteriormente falhou ao injetar, uma exceção NullPointerException resulta. De forma semelhante, esse problema pode ocorrer durante os processos de inicialização do filtro e do listener.

A propriedade customizada com.ibm.ws.webcontainer.ignoreinjectionfailure permite especificar se serão propagadas essas mensagens de erro e se será colocado um servlet em serviço. Por padrão, a propriedade customizada é configurada como false, o que retém o comportamento descrito anteriormente. Para ativar a propagação dessas exceções de injeção para o cliente e para não colocar o servlet em serviço, é necessário deixar essa propriedade customizada configurada como false.

Nome Valor Padrão
com.ibm.ws.webcontainer.ignoreinjectionfailure falso

com.ibm.ws.webcontainer.ignoreInvalidQueryString

Quando o contêiner da Web encontra um caractere de codificação em um par de sequências de consultas que não é válido, ele gera uma exceção IllegalArgumentException e, pelo padrão, ignora a sequência de consultas inteira. Nos aplicativos em que cada campo na cadeia de consulta é um recurso essencial, pode não ser desejável ignorar a cadeia de consulta inteira. Se você configurar a propriedade customizada com.ibm.ws.webcontainer.ignoreInvalidQueryString como true, o contêiner da web ignora os pares de sequência de consultas que não são válidos e continua processando os pares de sequência de consultas válidos.

Nome Valor Padrão
com.ibm.ws.webcontainer.ignoreInvalidQueryString falso

com.ibm.ws.webcontainer.ignorePostConstructOverriddenMethod

Se a classe-pai tiver seu método @PostConstruct anotado que é substituído por uma subclasse, quando o método anotado de subclasse de destino for chamado, o contêiner da web chamará a subclasse de destino duas vezes. Se você configurar a propriedade customizada com.ibm.ws.webcontainer.ignorePostConstructOverriddenMethod como true, o contêiner da web chamará o método de subclasse de destino apenas uma vez e os métodos substituídos do pai serão ignorados.

Nome Valor Padrão
com.ibm.ws.webcontainer.ignorePostConstructOverriddenMethod false

com.ibm.ws.webcontainer.ignoreSemiColonOnRedirectToWelcomePage

Se essa propriedade for configurada para true, o contêiner de web ignorará o ponto-e-vírgula e tudo após ele ao redirecionar para a página de boas-vindas.

Nome Valor Padrão
com.ibm.ws.webcontainer.ignoreSemiColonOnRedirectToWelcomePage falso

com.ibm.ws.webcontainer.IgnoreSessiononStaticFileRequest

O contêiner da Web acessa uma sessão para as solicitações de arquivo estático que envolvem filtros. Essa ação pode resultar em uma degradação de desempenho, por exemplo, ao executar com persistência de sessão de banco de dados. Se você configurar a propriedade customizada com.ibm.ws.webcontainer.IgnoreSessiononStaticFileRequest como true, o contêiner de web não poderá acessar uma sessão para as solicitações de arquivos estáticos que envolvem filtros.

Nome Valor Padrão
com.ibm.ws.webcontainer.IgnoreSessiononStaticFileRequest false

com.ibm.ws.webcontainer.initFilterBeforeInitServlet

Configure a propriedade customizada com.ibm.ws.webcontainer.initFilterBeforeInitServlet como true para inicializar os filtros antes de inicializar os servlets de carregamento na inicialização durante o processo de início para um aplicativo.

Evitar Problemas Evitar Problemas: As propriedades com.ibm.ws.webcontainer.invokeFilterInitAtStartup e com.ibm.ws.webcontainer.initFilterBeforeInitServlet devem ser configuradas como true para que os filtros sejam inicializados primeiro no início do aplicativo.gotcha
Nome Valor Padrão
com.ibm.ws.webcontainer.initFilterBeforeInitServlet falso

com.ibm.ws.webcontainer.invokeFilterAfterService

A propriedade customizada com.ibm.ws.webcontainer.invokeFilterAfterService assegura que o contêiner da web não chamará o flush() com falha quando o OutputStream for fechado.

Nome Valor Padrão
com.ibm.ws.webcontainer.invokeFilterAfterService true

com.ibm.ws.webcontainer.invokeFilterInitAtStartup

A propriedade customizada com.ibm.ws.webcontainer.invokeFilterInitAtStartup permite que o contêiner da web chame o método de inicialização e inicialize um filtro durante o processo de início para um aplicativo.

Nome Valor Padrão
com.ibm.ws.webcontainer.invokeFilterInitAtStartup falso

com.ibm.ws.webcontainer.KeepUnreadPostDataAfterResponseSentToClient

Esta propriedade indica se dados de postagem estão disponíveis para leitura após a resposta do cliente estiver concluída, após a conclusão de uma solicitação de encaminhamento ou um retorno de um sendRedirect. Se essa propriedade for configurada como true, os dados postados estarão disponíveis para leitura após a conclusão da resposta do cliente, após a conclusão de uma solicitação de encaminhamento, que é o comportamento padrão, ou no retorno de um sendRedirect, que ocorre quando a propriedade customizada com.ibm.ws.webcontainer.SendResponseToClientAsPartOfSendRedirect é configurada como true. No entanto, a configuração dessa propriedade como true requer que os dados de postagem não lidos sejam retidos na memória até que o recurso de destino seja concluído e que o uso de memória seja aumentado.

Nome Valor Padrão
com.ibm.ws.webcontainer.KeepUnreadPostDataAfterResponseSentToClient falso

com.ibm.ws.webcontainer.logServletContainerInitializerClassloadingErrors

Ao examinar as classes de um aplicativo para ver se elas correspondem a algum dos critérios especificados pela anotação HandlesTypes de um ServletContainerInitializer, o contêiner pode ter problemas de carregamento de classes, se um ou mais dos arquivos JAR do aplicativo opcionais estiverem faltando. Como o contêiner não decide se esses tipos de carregamento de classes impedem o aplicativo de funcionar corretamente, ele ignora as falhas e fornece uma opção de configuração que os registra.

A configuração dessa propriedade como true ativa a criação de log.

Nome Valor Padrão
com.ibm.ws.webcontainer.logServletContainerInitializerClassloadingErrors falso

com.ibm.ws.webcontainer.mapFiltersToAsterisk

Quando o contêiner da web processa uma solicitação, ele reconhece mapeamentos de servlet para "*" como iguais aos mapeamentos de servlet para "/*". Para fornecer o mesmo comportamento com mapeamento de filtro, configure a propriedade customizada com.ibm.ws.webcontainer.mapFiltersToAsterisk como true. A configuração da propriedade customizada com.ibm.ws.webcontainer.mapFiltersToAsterisk para true faz com que o contêiner da web reconheça os mapeamentos de filtragem como "*" como um mapeamento de filtragem para "/*". Essa propriedade customizada não faz distinção entre maiúsculas e minúsculas.

Nome Valor Padrão
com.ibm.ws.webcontainer.mapFiltersToAsterisk falso

com.ibm.ws.webcontainer.maxParamPerRequest

É possível usar essa propriedade para mudar o número máximo de parâmetros que são permitidos nas solicitações de entrada, com base nos aplicativos e no ambiente. O número máximo de parâmetros que são permitidos por solicitação de entrada (GET ou POST) é padronizado para 10000.

É possível configurar essa propriedade como -1, se você não deseja limitar o número de parâmetros que podem ser incluídos em uma solicitação.

Nome Valor Padrão
com.ibm.ws.webcontainer.maxParamPerRequest 10000

com.ibm.ws.webcontainer.metainfresourcescachesize

É possível usar essa propriedade para mudar o número de entradas no cache do recurso META-INF. O padrão para essa propriedade é 20.

Nome Valor Padrão
com.ibm.ws.webcontainer.metainfresourcescachesize 20

com.ibm.ws.webcontainer.modifiedFileNotFoundExceptionBehavior

Quando um arquivo não existe e é o destino de uma operação de inclusão ou encaminhamento para um despachante da solicitação, ocorre um FileNotFoundException. Você ativa esse comportamento de exceção de arquivo não localizado configurando essa propriedade customizada para true e permitindo que a exceção seja lançada quando um arquivo não existe. Se você configurar essa propriedade para false, o FileNotFoundException será suprimido, bem como qualquer criação de log da falha. Além disso, se tal solicitação resulta em uma exceção 404, FFDCs não são mais criados.

Nome Valor Padrão
com.ibm.ws.webcontainer.modifiedFileNotfFoundExceptionBehavior true

com.ibm.ws.webcontainer.ModifiedSinceLaterThanFileTimeStamp

Quando essa propriedade é configurada como true, o contêiner da web retorna uma resposta 304 se o registro de data e hora de If-Modified-Since da variante solicitada for mais recente que o registro de data e hora da variante de destino.

Nome Valor Padrão
com.ibm.ws.webcontainer.ModifiedSinceLaterThanFileTimeStamp falso

com.ibm.ws.webcontainer.normalizerequesturi

Tipicamente, erros 404 do URI de solicitação não ocorrem se um URI de solicitação for enviado a partir de um navegador, porque a maioria dos navegadores mais modernos automaticamente normaliza um URI de solicitação antes de chamar o WebSphere Application Server. Assim, pelo padrão, o contêiner da Web não normaliza um URI de solicitação antes de tentar resolver essa UTI para um mapeamento de aplicativo ou de servlet.

Um URI de pedido, que inclui /./ ou /../ como parte de um contexto de aplicativo e que não foi normalizado, pode falhar com um erro 404. De forma semelhante, um URI de solicitação, que inclua /./" ou /../ como parte de um caminho de servlet, que não tenha sido normalizado, falha em corresponder a um mapeamento de servlet, o qual também resulta em um erro 404, mesmo apesar do URI ter sido normalizado antes da resolução do UTI para uma JavaServer Page (JSP) ou arquivo estático.

É possível configurar a propriedade customizada com.ibm.ws.webcontainer.normalizerequesturi como true e o contêiner da web normaliza esses tipos de URIs de solicitação.

Nome Valor Padrão
com.ibm.ws.webcontainer.normalizerequesturi false

com.ibm.ws.webcontainer.parseUTF8PostData

Se o contêiner da Web tentar processar uma solicitação que inclui dados de postagem UTF-8 que não são codificados para URL, o recurso de destino acessa os dados de postagem como parâmetros. Entretanto, os dados UTF-8 não são codificados corretamente e os dados resultantes podem ser perdidos.

Para resolver esta questão, configure a propriedade customizada com.ibm.ws.webcontainer.parseUTF8PostData como true. Quando o contêiner da Web processar os parâmetros, ele detectará dados de postagem UTF-8 que não são codificados de URL e incluirá os dados nos valores de parâmetros.

Para usar essa função, você deve configurar o valor como true.

Nome Valor Padrão
com.ibm.ws.webcontainer.parseUTF8PostData falso

com.ibm.ws.webcontainer.preserveRequestParameterValues

Use essa propriedade customizada para preservar os valores originais dos valores de parâmetros usado na solicitação.

O método javax.servlet.ServletRequest.getParameterValues() retorna uma matriz de Sequência dos valores de parâmetros de solicitação. Se essa matriz de Sequência for modificada diretamente, os valores de parâmetros de solicitação originais poderão ser perdidos. Qualquer chamada subsequente ao método javax.servlet.ServletRequest.getParameterValues() retornará os valores modificados.

Para usar essa função, deve-se configurar o valor como true.

Nome Valor Padrão
com.ibm.ws.webcontainer.preserveRequestParameterValues falso

com.ibm.ws.webcontainer.provideQStringToWelcomeFile

Normalmente, quando um pedido é inicialmente enviado à raiz de contexto do aplicativo, o pedido é encaminhado para um arquivo de boas-vindas. Se uma sequência de consultas for incluída em uma solicitação inicial, ela estará indisponível para o arquivo de boas-vindas se você tiver incluído o atributo request.getQueryString() no atributo de boas-vindas. No entanto, a cadeia de consultas ficará disponível para o arquivo de boas-vindas se você incluiu o atributo javax.servlet.forward.query_string no arquivo de boas-vindas.

Se você tiver que usar o atributo request.getQueryString(), em vez do atributo javax.servlet.forward.query_string, para disponibilizar a sequência de consulta para o arquivo de boas-vindas, inclua a propriedade customizada com.ibm.ws.webcontainer.provideQStringToWelcomeFile em sua configuração do contêiner da web e configure a propriedade para true.

Nome Valor Padrão
com.ibm.ws.webcontainer.provideQStringToWelcomeFile false

com.ibm.ws.webcontainer.RedirectWithPathInfo

Quando o local de redirecionamento fornecido for uma URL relativa e estiver sem uma barra inicial (" / "), durante a conversão do valor de URI relativo em uma URL absoluta, o servidor removerá o pathInfo do URI existente. Para assegurar que o pathInfo seja retido e não removido, configure com.ibm.ws.webcontainer.RedirectWithPathInfo como true.

Nome Valor Padrão
com.ibm.ws.webcontainer.RedirectWithPathInfo falso

com.ibm.ws.webcontainer.removeAttributeForNullObject

Por padrão, o método getAttributeNames() pode retornar um nome de atributo cujo valor é configurado como nulo se o valor transmitido para os métodos ServletRequest.setAttribute() ou ServleContextt.setAttribute() for nulo. Este comportamento padrão não está de acordo com a API.

Se desejar que o contêiner da web remova o atributo se o objeto nulo for passado para o método ServletRequest.setAttribute() ou ServleContextt.setAttribute(), inclua essa propriedade customizada com.ibm.ws.webcontainer.removeAttributeForNullObject para a configuração do contêiner da web e configure a propriedade para true.

Tipo de dados Padrão
Booleano false

com.ibm.ws.webcontainer.returnDefaultContextPath

Use a propriedade customizada com.ibm.ws.webcontainer.returnDefaultContextPath para retornar o caminho de contexto correto quando um aplicativo for instalado na raiz de contexto padrão. Por exemplo, quando a propriedade é configurada como true, o caminho do contexto é configurado para uma sequência vazia para qualquer aplicativo que está instalado na raiz de contexto padrão.

Tipo de dados Padrão
Booleano Falso

com.ibm.ws.webcontainer.searchMetaInfResourcesDuringAppStart

Use a propriedade customizada com.ibm.ws.webcontainer.searchMetaInfResourcesDuringAppStart para desativar o recurso aprimorado ao procurar por /META-INF/resources.

Tipo de dados Padrão
Booleano True

com.ibm.ws.webcontainer.SendResponseToClientAsPartOfSendRedirect

Esta propriedade indica se uma resposta foi concluída como parte de uma solicitação sendRedirect. Se essa propriedade for configurada como true, uma resposta será concluída como parte de uma solicitação sendRedirect e os dados postados que estão associados à solicitação não estarão disponíveis para leitura no retorno do sendRedirect.

O valor padrão é false.

Nome Valor Padrão
com.ibm.ws.webcontainer.SendResponseToClientAsPartOfSendRedirect falso

com.ibm.ws.webcontainer.SendResponseToClientWhenResponseIsComplete

Esta propriedade indica se uma resposta foi concluída no retorno de uma solicitação de encaminhamento.

Se essa propriedade for configurada como false, uma resposta não é concluída no retorno de uma solicitação de encaminhamento. Em vez disso, ela é atrasada até que o recurso de destino seja concluído. Os dados de postagem estão disponíveis para uma leitura após a conclusão do encaminhamento.

Nome Valor Padrão
com.ibm.ws.webcontainer.SendResponseToClientAsPartOfSendRedirect true

com.ibm.ws.webcontainer.setAsyncDispatchRequestURI

Se essa propriedade for configurada como true, o contêiner da web irá configurar o URI da solicitação atual como o destino do despacho assíncrono.

Nome Valor Padrão
com.ibm.ws.webcontainer.setAsyncDispatchRequestURI false

com.ibm.ws.webcontainer.setcontenttypebysetheader

Quando autoResponseEncoding for ativado ou quando a propriedade com.ibm.ws.webcontainer.contentTypeCompatibility for configurada, o servidor de aplicativos irá configurar o tipo de conteúdo da resposta usando um método interno. Para ativar a configuração do tipo de conteúdo usando o método ServletResponse.setContentType em substituição, é necessário configurar a propriedade customizada com.ibm.ws.webcontainer.setcontenttypebysetheader como false.

Nome Valor Padrão
com.ibm.ws.webcontainer.setcontenttypebysetheader true

com.ibm.ws.webcontainer.ServeWelcomeFileFromExtendedDocumentRoot

Tipicamente, na primeira vez em que o contêiner da Web trata um pedido para uma página de boas-vindas estática que não seja um arquivo JavaServer Pages (JSP), o contêiner da Web não procura por ExtendedDocumentRoot para o arquivo de boas-vindas a menos que a solicitação para esse arquivo seja completamente qualificada. Se o pedido for completamente qualificado, o contêiner da Web serve o arquivo de boas-vindas e a raiz de contexto do aplicativo exibe o arquivo de boas-vindas. Se a solicitação do arquivo de boas-vindas estático não for completa, o contêiner da Web retornará um erro 404, que indica que o contêiner da Web não localizou o arquivo de boas-vindas.

Depois do contêiner da Web servir com êxito um arquivo de boas-vindas, o contêiner da Web cria um mapeamento para esse arquivo de boas-vindas. O contêiner da web usa então esse mapeamento para manipular futuras solicitações para o arquivo de boas-vindas, eliminando a necessidade de solicitações subsequentes serem completas.

Se desejar que o contêiner da web sempre procure por um aplicativo definido ExtendedDocumentRoot para um arquivo de boas-vindas, mesmo se a solicitação não estiver completa, você poderá incluir a propriedade customizada com.ibm.ws.webcontainer.ServeWelcomeFileFromExtendedDocumentRoot nas configurações de contêiner da web e configurar essa propriedade para true.

Nome Valor Padrão
com.ibm.ws.webcontainer.ServeWelcomeFileFromExtendedDocumentRoot false

com.ibm.ws.webcontainer.ServletDestroyWaitTime

Por padrão, quando um aplicativo é interrompido o contêiner da Web aguarda até 60 segundos pela conclusão de cada solicitação ativa por um recurso desse aplicativo. Agora é possível definir a propriedade customizada de contêiner da web com.ibm.ws.webcontainer.ServletDestroyWaitTime para controlar o período de tempo que o contêiner da web aguarda até que a solicitação ativa seja concluída quando o aplicativo de propriedade for parado.

Configure a propriedade customizada com.ibm.ws.webcontainer.ServletDestroyWaitTime para um valor de número inteiro, que especifica o número de segundos a ser aguardado até que uma solicitação seja concluída. O valor-padrão é 60 segundos.

Nome Valor Padrão
com.ibm.ws.webcontainer.ServletDestroyWaitTime 60

com.ibm.ws.webcontainer.setUnencodedHTMLinsendError

Tipicamente, o contêiner da Web codifica as mensagens de erro especificadas antes de formatá-las, para evitar ataques XXS (Cross-Site Scripting) no cliente se o aplicativo não limpar essas mensagens. No entanto, o Java Servlet Specification para o método sendError(int, String) indica que o servidor deve criar a resposta para ser semelhante a uma página de erro do servidor formatada em HTML.

Se não deseja que o contêiner da web codifique as mensagens de erro especificadas antes de formatá-las, inclua a propriedade customizada com.ibm.ws.webcontainer.setUnencodedHTMLinsendError nas definições de configuração do contêiner da web e configure a propriedade como true.

Nome Valor Padrão
com.ibm.ws.webcontainer.setUnencodedHTMLinsendError falso

com.ibm.ws.webcontainer.skipInputStreamReadOnError

Se essa propriedade for configurada como true, o contêiner da web irá parar de ler os dados POST restantes se houver uma exceção antes ou durante a análise dos dados POST.

A propriedade customizada com.ibm.ws.webcontainer.skipInputStreamReadOnError deve ser usada em par com a propriedade customizada de canal preventRequestBodyPurge configurada para true.

Nome Valor Padrão
com.ibm.ws.webcontainer.skipInputStreamReadOnError falso

com.ibm.ws.webcontainer.SkipMetaInfResourcesProcessing

O contêiner da web procura arquivos estáticos e arquivos JavaServer Pages (JSP) em diferentes locais, dependendo da configuração do aplicativo. Um fragmento da web consiste em um arquivo JAR em um diretório WEB-INF/lib do aplicativo. O JAR pode incluir recursos estáticos em um diretórioMETA-INF/resources que estão definidos dentro do arquivo JAR. Para evitar que o contêiner da web procure os diretórios META-INF/resources, configure a propriedade customizada do contêiner da web com.ibm.ws.webcontainer.SkipMetaInfResourcesProcessing como true.

O valor padrão para a propriedade customizada é false.

Nome Valor Padrão
com.ibm.ws.webcontainer.SkipMetaInfResourcesProcessing false

com.ibm.ws.webcontainer.suppressheadersinrequest

A propriedade customizada com.ibm.ws.webcontainer.suppressheadersinrequest pode ser usada para suprimir a inclusão de cabeçalhos de solicitação que iniciam com caracteres especiais, como "$" ou "_". Alguns aplicativos não manipulam cabeçalhos de pedidos que iniciam com caracteres especiais.

O valor especificado para essa propriedade customizada é uma lista delimitada dos prefixos de cabeçalho que você deseja que sejam suprimidos.

Por exemplo:

com.ibm.ws.webcontainer.suppressheadersinrequest=$WS,_WS
Nome Valor Padrão
com.ibm.ws.webcontainer.suppressheadersinrequest Nenhum

com.ibm.ws.webcontainer.suppressHtmlRecursiveErrorOutput

Durante um erro recursivo que uma página de erro específica do aplicativo não puder tratar, o rastreio de pilha e a mensagem de erro serão enviados à saída como uma página HTML. Essas informações incluem informações de nomes de classes e de programas que o desenvolvedor de aplicativos não quer expor ao usuário.

É possível configurar a propriedade customizada do contêiner da web com.ibm.ws.webcontainer.suppressHtmlRecursiveErrorOutput para suprimir a saída HTML do texto de erro, sem alterar a criação de log da mensagem. Configure a propriedade customizada com.ibm.ws. webcontainer.suppressHtmlRecursiveErrorOutput como true para desativar a saída HTML da mensagem de erro para o usuário e apresentar a ele uma página em branco com um código de erro 500.

Nome Valor Padrão
com.ibm.ws.webcontainer.suppressHtmlRecursiveErrorOutput falso

com.ibm.ws.webcontainer.suppressLastZeroBytePackage

Geralmente, o último chunk de byte zero é usado para indicar para um cliente o fim dos dados de resposta em uma transmissão codificada em chunk. Alguns aplicativos usam esse último zero para determinar quando os dados de resposta serão recebidos e eles podem começar a processá-los. Se ocorre um erro no aplicativo após os cabeçalhos de resposta serem enviados, a última parte de dados ainda é enviada ao cliente. O cliente pode não perceber que ocorreu um erro e tentar processar dados incompletos.

Se você configurar a propriedade customizada com.ibm.ws.webcontainer.suppressLastZeroBytePackage como true, se ocorrer um erro no aplicativo após os cabeçalhos de resposta serem enviados, a última parte de dados não será enviada ao cliente.

Nome Valor Padrão
com.ibm.ws.webcontainer.suppressLastZeroBytePackage falso

com.ibm.ws.webcontainer.suppressLoggingFileNotFoundExceptions

Quando um arquivo ausente é solicitado, o contêiner da web gera uma mensagem de erro grave com um rastreio de pilha FileNotFoundException nos logs da Java virtual machine (JVM). Isto pode não ser um erro grave se o arquivo incorreto foi acidentalmente solicitado. Configure esta propriedade como true para gerar uma mensagem de aviso nos logs JVM ao invés de uma mensagem de erro grave quando um arquivo não é localizado.

Nome Valor Padrão
com.ibm.ws.webcontainer.suppressLoggingFileNotFoundExceptions falso

com.ibm.ws.webcontainer.suppressLoggingWebGroupVhostNotFound

Configure para true para suprimir a mensagem SRVE0255E no SystemOut.log.

Essa propriedade customizada é suportada somente na sequência sem caractere curinga (*).

Nome Valor Padrão
com.ibm.ws.webcontainer.suppressLoggingWebGroupVhostNotFound Nenhum

com.ibm.ws.webcontainer.suppressServletExceptionLogging

Se um servlet criar uma exceção, ela será registrada no console do sistema. Se não desejar que o contêiner da web registre exceções criadas pelo servlet, inclua a propriedade customizada com.ibm.ws.webcontainer.suppressServletExceptionLogging nas definições de configuração do contêiner da web e configure a propriedade como true.

Nome Valor Padrão
com.ibm.ws.webcontainer.suppressServletExceptionLogging falso

com.ibm.ws.webcontainer.throwMissingJspException

Defina como true a propriedade customizada com.ibm.ws.webcontainer.throwMissingJspException para criar uma exceção FileNotFoundException quando um recurso incluído por um arquivo JSP estiver faltando. Se essa propriedade não for configurada como true, uma página de erro será exibida.

Nome Valor Padrão
com.ibm.ws.webcontainer.throwMissingJspException falso

com.ibm.ws.webcontainer.throwpostconstructexception

Configure a propriedade customizada com.ibm.ws.webcontainer.throwpostconstructexception como true para propagar as mensagens de erro customizadas para o arquivo error.xhtml.

Para Usuários de Transição Para Usuários de Transição: O valor padrão para essa propriedade customizada mudou a partir da Versão 7.0. Na Versão 7.0, o valor padrão é false.trns
Nome Valor Padrão
com.ibm.ws.webcontainer.throwpostconstructexception true
[AIX]

com.ibm.ws.webcontainer.tolerateLocaleMismatchForServingFiles

Você poderá encontrar um erro FileNotFound 404 a partir de um contêiner da Web e a solicitação não será servida quando as seguintes codificações não corresponderem:
  • A codificação do sistema de arquivos na qual um aplicativo é instalado
  • A codificação de nome do arquivo que é enviada em uma URL de pedido

Por exemplo, se a solicitação for para um nome do arquivo codificado com o conjunto de caracteres de byte duplo (DBCS) e o código do idioma do sistema de arquivos for en_US, que é uma codificação ISO-8859, a correspondência falhará.

Para resolver este problema, configure a propriedade customizada com.ibm.ws.webcontainer.tolerateLocaleMismatchForServingFiles como true. Ao configurar esta propriedade customizada, o contêiner da Web tolera a incompatibilidade de codificações do sistema de arquivos e do nome do arquivo solicitado. Então, o contêiner da Web entrega a solicitação de um arquivo válido.

Nome Valor Padrão
com.ibm.ws.webcontainer.tolerateLocaleMismatchForServingFiles falso

com.ibm.ws.webcontainer.useOriginalRequestState

Se uma solicitação for substituída ou o aplicativo implementar a interface ServletRequest, o aplicativo poderá falhar ao entregar a solicitação, porque o objeto da solicitação substituído ou implementado, em vez do objeto da solicitação, está sendo usado para manipular a solicitação. Para assegurar que o objeto de solicitação seja usado para manipular a solicitação, inclua a propriedade customizada com.ibm.ws.webcontainer.useOriginalRequestState nas definições de configuração do contêiner da web e configure-a para true.

Nome Valor Padrão
com.ibm.ws.webcontainer.useOriginalRequestState falso

com.ibm.ws.webcontainer.useSemiColonAsDelimiterInURI

Se configurada para true, o contêiner da web ignorará o ponto-e-vírgula; tudo após ele também será ignorado ao chamar javax.servlet.http.HttpServletRequest.getPathInfo().

Nome Valor Padrão
com.ibm.ws.webcontainer.useSemiColonAsDelimiterInURI falso

com.ibm.ws.webcontainer.webgroupvhostnotfound

A mensagem de erro SRVE0017W indica "Grupo da web não localizado: {0}", e a mensagem de erro SRVE0255 indica "Um grupo da web/host virtual para manipular {0} não está definido". Essas mensagens podem ser retornadas quando o aplicativo que é chamado para processar a solicitação entregue pelo IBM WebSphere Application Server não é localizado. É possível usar a propriedade customizada com.ibm.ws.webcontainer.webgroupvhostnotfound para alterar o texto dessas mensagens para o texto que for mais adequado para seu ambiente.

Nome Valor Padrão
com.ibm.ws.webcontainer.webgroupvhostnotfound

Nenhum

com.ibm.ws.webcontainer.xPoweredBy

Esta propriedade customizada permite que você configure o valor do cabeçalho X-Powered-By, que fornece as informações de implementação do servidor.

Nome Valor Padrão
com.ibm.ws.webcontainer.xPoweredBy Servlet/3.0

com.ibm.wsspi.jsp.allowMultipleAttributeValues

Configure esta propriedade como true para permitir que o contêiner da web armazene diversos valores para um atributo tag customizado.

Nome Valor Padrão
com.ibm.wsspi.jsp.allowMultipleAttributeValues falso

com.ibm.wsspi.jsp.convertAttrValueToString

Configure a propriedade customizada do contêiner da web com.ibm.wsspi.jsp.convertAttrValueToString como true para converter os atributos de início e fim da tag de repetição para sequências antes que sejam usados.

Nome Valor Padrão
com.ibm.wsspi.jsp.convertAttrValueToString falso

com.ibm.wsspi.jsp.disableElCache

Configure a propriedade customizada do contêiner da Web com.ibm.wsspi.jsp.disableElCache como true para desativar a cache de expressões EL comuns se estiver experimentando condições de memória, pois hashmaps são mantidos pelo avaliador de expressões.

Nome Valor Padrão
com.ibm.wsspi.jsp.disableElCache falso

com.ibm.wsspi.jsp.disableResourceInjection

O recurso de injeção de recursos acessa recursos em aplicativos diferentemente de como era feito em versões anteriores do produto e faz com que a saída do método compilada seja maior do que era anteriormente. Se você tiver grandes arquivos JSP que em releases anteriores enviaram o limite de 65535 bytes no método de serviço convertido, eles agora podem exceder esse limite, fazendo a compilação falhar.

Se você encontrar essa situação, poderá dividir um arquivo JSP grande em arquivos JSP menores e usar instruções <jsp:include> para combiná-los após sua compilação, ou incluir a propriedade customizada com.ibm.wsspi.jsp.disableResourceInjection nas configurações do contêiner da web para desativar a função de injeção de recurso durante o processo de conversão de JSP. Quando a propriedade customizada com.ibm.wsspi.jsp.disableResourceInjection estiver configurada como true, a função de injeção de recurso será desativada para todos os aplicativos.

Se desejar desativar a função de injeção de recurso somente para aplicativos específicos, será possível incluir o atributo JSP disableResourceInjection nos arquivos ibm-web-ext.xmi para esses aplicativos específicos.

Nome Valor Padrão
com.ibm.wsspi.jsp.disableResourceInjection falso

com.ibm.wsspi.jsp.disableTldSearch

A propriedade customizada com.ibm.wsspi.jsp.disableTldSearch pode ser usada para melhorar o tempo de início do aplicativo. Por padrão, quando um aplicativo é iniciado, o mecanismo JSP procura pelos diretórios de instalação do aplicativo para os arquivos taglib Descriptor (TLD). Esse processo de procura pode aumentar o tempo de início para aplicativos grandes com muitos arquivos e diretórios. Para desativar esse processo de procura, configure essa propriedade como true.

Nome Valor Padrão
com.ibm.wsspi.jsp.disableTldSearch false

com.ibm.wsspi.jsp.enabledoublequotesdecoding

Configure a propriedade customizada do contêiner da web com.ibm.wsspi.jsp.enabledoublequotesdecoding para decodificar um caractere aspas duplas codificado, se ele estiver integrado em uma função de script em um arquivo JavaServer Pages (JSP).

O Contêiner JSP não decodifica um caractere aspas duplas codificado durante a conversão de um arquivo JSP. Em vez disso, há uma dependência do navegador para decodificá-lo. No entanto, quando existe um caractere aspas duplas codificado dentro de uma função de script de uma tag, o navegador não pode decodificá-lo. Portanto, quando essa propriedade customizada não estiver configurada, o caractere aspas duplas codificado causará mau funcionamento da função de script.

Ao configurar esta propriedade customizada, o valor afeta todos os seus aplicativos implementados. Se você desejar afetar um aplicativo individual, configure o atributo JSP enableDoubleQuotesDecoding como true no arquivo ibm-web-ext.xmi em seu aplicativo.

Nome Valor Padrão
com.ibm.wsspi.jsp.enabledoublequotesdecoding false

com.ibm.wsspi.jsp.removexmlnsfromoutput

Quando o contêiner da web gera código HTML de um documento JSP, o contêiner da web não remove quaisquer atributos xmlns, que são especificados para as tags no documento JSP. Portanto, quando o documento JSP é renderizado no navegador, os atributos xmlns permanecem no código HTML gerado.

Para assegurar que os atributos xmlns sejam sempre removidos do código HTML gerado, inclua a propriedade customizada com.ibm.wsspi.jsp.removexmlnsfromoutput em suas definições de configuração de contêiner da web e configure essa propriedade como true.

Ao configurar esta propriedade customizada, o valor afeta todos os seus aplicativos implementados. Se você desejar afetar um aplicativo individual, configure o atributo JSP removeXmlnsFromOutput como true no arquivo ibm-web-ext.xmi em seu aplicativo.

Nome Valor Padrão
com.ibm.wsspi.jsp.removexmlnsfromoutput falso
[z/OS]

ConnectionResponseTimeout

Utilize a propriedade ConnectionResponseTimeout para configurar o período de tempo máximo, em segundos, que o servidor aguarda para um componente de aplicativo responder a um pedido HTTP. Configure essa variável para cada uma das definições de canal de transporte HTTP no servidor. É necessário configurar essa variável para os canais de transporte SSL e não SSL. Se a resposta não for recebida dentro do período de tempo especificado, o servant poderá falhar com ABEND EC3 e RSN=04130007. Definir esse cronômetro evita que aplicativos clientes esperem por uma resposta de um componente de aplicativo que possa estar conflitante, em loop ou que encontrem outros problemas de processamento que façam com que o componente de aplicativo seja interrompido.

Use as propriedades customizadas do servidor protocol_http_timeout_output_recovery e protocol_https_timeout_output_recovery para indicar a ação de recuperação que você deseja executar em tempos limite para solicitações que são recebidas pelos canais de transporte HTTP e HTTPS.

Informações Valor
Tipo de dados Número Inteiro
Padrão 300 segundos
[AIX Solaris HP-UX Linux Windows][IBM i]

DebugSessionCrossover

A propriedade customizada DebugSessionCrossover permite que o código execute verificações adicionais para verificar se apenas a sessão que está associada à solicitação é acessada ou referenciada. As mensagens serão registradas se forem detectadas discrepâncias.

Nota: O uso da propriedade DebugSessionCrossover como uma propriedade customizada de contêiner da web foi descontinuado. Agora, é possível defini-la como uma propriedade customizada de gerenciamento de sessão.

Para ativar a detecção cruzada de dados da sessão, configure essa propriedade como true

Nome Valor Padrão
DebugSessionCrossover falso

Consulte o artigo de problemas da sessão HTTP para obter informações adicionais.

DecodeUrlAsUTF8

O recurso de URL codificado por UTF-8, que fornece URLs (Uniform Resource Locators) codificados por UTF-8 para suportar os caracteres de byte duplo em URLs, está ativado por padrão. É possível evitar que o contêiner da web decodifique explicitamente URLs em UTF-8 e fazer com que usem o padrão ISO-8859, conforme definido na especificação HTTP atual, configurando essa propriedade customizada como false.

Nome Valor Padrão
DecodeUrlAsUTF8 true

DisableMultiThreadedServletConnectionMgmt

Use essa propriedade para permitir que as conexões sejam reutilizadas entre os servlets. Para usar como uma propriedade customizada de contêiner da web a partir do console administrativo:
  1. Clique em Servidores de aplicativos > server_name > Contêiner da web > Propriedades customizadas.
  2. Crie a propriedade DisableMultiThreadedServletConnectionMgmt e configure seu valor para true.

Quando essa propriedade estiver ativada, se a manipulação de conexões não for encerrada e o servlet terminar, o contêiner da web (como parte de postinvoke), estacionará a conexão e não fechará a manipulação de conexões.

Nome Valor Padrão
DisableMultiThreadedServletConnectionMgmt falso

com.ibm.ws.webcontainer.denyDuplicateFilterinChain

Quando um URI de solicitação de entrada é mapeado para múltiplos mapeamentos de filtragem de URL, a cadeia de filtragem é atualizada com o mesmo filtro múltiplas vezes, fazendo com que o filtro seja chamado várias vezes para o mesmo URI. Se você incluir a propriedade customizada denyDuplicateFilterinChain em suas configurações de contêiner da web e configurar essa propriedade como true, um filtro não será incluído em uma cadeia de filtros se ele já estiver presente nessa cadeia.

Nome Valor Padrão
com.ibm.ws.webcontainer.denyDuplicateFilterinChain falso

enableInProcessConnections

Use a propriedade customizada enableInProcessConnections para reduzir os tempos de resposta e para reduzir os números de encadeamentos que são usados para atender uma solicitação, que reduz o potencial para um conflito.

Há um caminho de comunicação otimizado entre um aplicativo cliente de serviços da web e um contêiner da web que estão no mesmo processo do servidor de aplicativos. As solicitações do cliente de serviços da web que, normalmente, são enviadas para o contêiner da web usando uma conexão de rede são entregues diretamente para o contêiner da web usando um caminho local otimizado. O caminho local está disponível, porque o aplicativo cliente de serviços da Web e o contêiner da Web estão em execução no mesmo processo. Este caminho de comunicação otimizado é desativado por padrão. Antes de ativar essa propriedade, certifique-se de que não sejam especificados curingas para as portas do contêiner da web. Utilize portas específicas para o contêiner da Web quando o caminho de comunicação otimizado estiver ativado.

Para ativar o caminho de comunicação otimizado, configure essa propriedade como true.

Nome Valor Padrão
enableInProcessConnections falso

Consulte o tópico Cliente de Serviços da Web para Comunicação Otimizada do Contêiner da Web para obter informações adicionais.

Evitar Problemas Evitar Problemas: Alguns aplicativos de serviços da web não podem compartilhar encadeamentos com segurança. Se ocorrerem erros, configure também a propriedade JVM jaxws.useSafeIPC para true.gotcha

fileServingEnabled, directoryBrowsingEnabled e serveServletsByClassnameEnabled

As propriedades fileServingEnabled, directoryBrowsingEnabled e semelhantes são configurações globais para servlets internos. Os arquivos Web application archive (WAR) que são empacotados usando ferramentas de terceiros não podem especificar o comportamento para os serviços que são expostos pelos servlets internos do contêiner da web.

É possível usar as propriedades fileServingEnabled, directoryBrowsingEnabled e serveServletsByClassnameEnabled para ativar e desativar globalmente as funções fileServing, directoryBrowsing e serveServletsByClassname para servlets internos de todos os aplicativos da web no nível de contêiner da web.
  • Configurar a propriedade fileServingEnabled como false desativa a função fileServing.
  • Configurar a propriedade directoryBrowsingEnabled como true ativa a função directoryBrowsing.
  • Configurar a propriedade serveServletsByClassnameEnabled como true ativa a função serveServletsByClassnameEnabled.
Nome Valor Padrão
fileServingEnabled true
directoryBrowsingEnabled false
serveServletsByClassnameEnabled falso

As configurações que são definidas em uma ferramenta do conjunto têm precedência sobre as configurações globais que são definidas por meio das propriedades customizadas no nível do contêiner da Web.

As extensões de implementação do aplicativo da Web continuam mantendo informações de configuração para os serviços que são fornecidos pelos servlets internos, e têm precedência sobre as configurações globais que são enviadas por meio das propriedades customizadas no nível do contêiner da Web.

ForceSessionIdLengthCheck

IDs de sessão recentemente gerados possuem, pelo padrão, 23 caracteres de comprimento, a menos que você utilize a propriedades customizada HttpSessionIdLength para especificar um comprimento máximo diferente para seus IDs de sessão.

Quando um pedido recebido possuir um ID de sessão que seja maior que o ID de sessão esperado e cujo prefixo for idêntico a um ID de sessão preexistente, o ID de sessão maior será usado para retornar uma nova sessão. Se o comprimento do ID de sessão na solicitação recebida for maior que o comprimento máximo especificado para seu sistema, de forma que excede a largura da coluna de ID na coluna da tabela da sessão usada na persistência de banco de dados, ocorrerá um erro SQL0302.

Para evitar a ocorrência desses erros SQL0302, é possível incluir a propriedade customizada ForceSessionIdLengthCheck em suas propriedades customizadas do contêiner da Web e configurá-la como true. Quando essa propriedade customizada é configurada para true, o comprimento de um ID de sessão não pode exceder 23 caracteres. Quando um pedido recebido possuir um ID de sessão que seja maior que 23 caracteres, os primeiros 23 caracteres serão usados para retornar uma nova sessão.

Nome Valor Padrão
ForceSessionIdLengthCheck falso

ForceSessionInvalidationMultiple

A propriedade customizada ForceSessionInvalidationMultiple indica se o gerenciador de sessões espera indefinidamente a conclusão de uma solicitação antes de tentar invalidar a sessão ou tenta invalidar uma sessão após decorrer o limite de tempo especificado.

  • Se você especificar 0 (zero) para essa propriedade customizada, o gerenciador de sessões irá esperar indefinidamente até a conclusão de uma solicitação antes de tentar invalidar a sessão.

    Se, normalmente, seus pedidos não forem restringidos por um limite de tempo de resposta, especifique 0 para essa propriedade.

  • Se você especificar um número inteiro positivo, como 1, 2 ou 3 para essa propriedade customizada, mesmo que não se saiba se uma sessão foi concluída, o gerenciador de sessões tentará invalidar a sessão se tiver decorrido o período de tempo indicado desde o último acesso. Esse período de tempo é o resultado da multiplicação do valor especificado para essa propriedade pelo valor especificado para a propriedade Tempo limite de sessão. Por exemplo, se for especificado 2 minutos para a propriedade Tempo Limite da Sessão e 2 para a propriedade ForceSessionInvalidationMultiple, o gerenciador de sessão tentará invalidar a sessão depois de 4 minutos.

    Se desejar invalidar suas sessões após decorrer um determinado período de tempo, especifique o número inteiro positivo apropriado para essa propriedade.

Nome Valor Padrão
ForceSessionInvalidationMultiple 1

httpsIndicatorHeader

A propriedade customizada httpsIndicatorHeader gerencia solicitações de HTTPS que são encaminhadas a um servidor de aplicativos a partir de um transferidor de SSL que é usado na frente do WebSphere Application Server. Quando uma solicitação de HTTPS é recebida por um transferidor de SSL, ela é redirecionada por HTTP para um servidor de aplicativos usando o WebSphere Application Server. O transferidor de SSL deve ser configurado para incluir um cabeçalho especial que indica que a solicitação original foi feita por meio de HTTPS. A propriedade httpsIndicatorHeader especifica o nome da chave do cabeçalho da solicitação incluído pela caixa SSL. O servidor de aplicativos verifica esse indicador para determinar se o SSL é obrigatório. Se determinar o pedido SSL via HTTP, um esquema HTTPS será escolhido.

Nome Valor Padrão
httpsIndicatorHeader Nenhum

HttpSessionIdReuse

A propriedade customizada HttpSessionIdReuse determina se o gerenciador de sessões pode usar o ID de sessão enviado a partir de um navegador para preservar dados da sessão entre aplicativos da web em execução em um ambiente que não está configurado para persistência de sessão. Em um ambiente com diversas JVMs, que não está configurado para persistência de sessão, configurar essa propriedade como true permite que o gerenciador de sessões use as mesmas informações da sessão para todas as solicitações do usuário, mesmo que os aplicativos da web que estão manipulando essas solicitações sejam controlados por diferentes arquivos de JVM. O valor padrão para essa propriedade é false.

Nota: O uso da propriedade HttpSessionIdReuse como uma propriedade customizada de contêiner da web foi descontinuado. Agora defina essa funcionalidade como uma propriedade customizada de gerenciamento de sessões.

Para permitir que o gerenciador de sessões use o ID de sessão enviado a partir de um navegador para preservar dados da sessão entre aplicativos da web em execução em um ambiente que não está configurado para persistência de sessão, configure essa propriedade como true.

Nome Valor Padrão
HttpSessionIdReuse falso

listeners

A especificação de servlet suporta aplicativos que registram listeners para eventos relacionados a servlets em um aplicativo individual por meio do descritor web.xml. Entretanto, usando a propriedade customizada de listeners, é possível permitir que um servidor receba eventos de servlet entre aplicativos da web.

Para implementar o atendimento global, um listener for registrado no nível do contêiner da Web e é propagado a todos os aplicativos da Web instalados e novos. Esse comportamento global dos listeners de servlets internos é controlado pela propriedade customizada listeners utilizando-se o par nome-valor a seguir.
listeners=listener_class
Nome Valor Padrão
listeners Nenhum

O valor para esta propriedade é uma sequência, especificando uma lista separada por vírgulas de classes do listener. O listener que é fornecido deve implementar classes de listener padrão a partir da API do Servlet Java ou classes de extensão do listener IBM.

[z/OS]

MutualAuthCBindCheck

Esta propriedade é válida somente na plataforma z/OS. Use a propriedade MutualAuthCBindCheck para especificar se um certificado de cliente é resolvido para um principal SAF.

Use a propriedade MutualAuthCBindCheck para especificar se um certificado de cliente é resolvido para um principal SAF. Se esta propriedade for configurada como true, todas as conexões SSL de um navegador deverão possuir um certificado cliente e o ID do usuário associado a esse certificado cliente deverá possuir a autoridade RACF CONTROL para CB.BIND.servername. Independentemente da autenticação por certificado de cliente ser utilizada em uma conexão SSL, se essas condições não forem atendidas, a conexão será fechada. Emita o seguinte comando RACF para conceder ao ID do usuário associado o certificado de cliente da autoridade RACF CONTROL:

PERMIT CB.BIND.<optional SAF profile prefix>.clustername CLASS(CBIND) ID(clientCertUserid) ACCESS(CONTROL)
Nome Valor Padrão
MutualAuthCBindCheck falso

prependSlashToResource

O WebSphere Application Server 5.x suporta Localizadores Uniformes de Recursos (URLs) sem barras frontais à esquerda ( / ) . Para preservar a compatibilidade, é possível configurar essa propriedade customizada como true. Quando essa propriedade for configurada como true, o contêiner da web ignorar a especificação e considerar URLs sem a barra frontal inicial, use o seguinte par nome-valor.

Nome Valor Padrão
prependSlashToResource falso

com.ibm.ws.webcontainer.suppressLoggingServiceRuntimeExcep

Você pode utilizar essa propriedade para suprimir a criação de log de qualquer RuntimeException que ocorra durante o serviço de um servlet.

Por padrão, o contêiner da web registra a exceção de tipo RuntimeException nos logs JVM, se a exceção ocorrer durante o serviço de um servlet. Quando essa propriedade é configurada para true, o contêiner da web não registra nenhum tipo de RuntimeException que ocorra durante o serviço de um servlet.

Evitar Problemas Evitar Problemas: Configurar essa propriedade como true suprime apenas a criação de log de exceções do tipo RuntimeException. Configurar essa propriedade como true não afeta exceções que são lançadas de volta para o responsável pela chamada.gotcha
Nome Valor Padrão
com.ibm.ws.webcontainer.suppressLoggingServiceRuntimeExcep falso

confiável

A propriedade customizada confiável permite que o servidor de aplicativos use cabeçalhos privados de entrada a partir do plug-in de servidor da web. Esses cabeçalhos privados de entrada notificam o servidor de aplicativos sobre a conexão com o servidor da Web. Quando você configura a propriedade customizada como true, o servidor de aplicativos usa as informações declaradas nos certificados de cliente. Esses certificados de clientes são usados pelo usuário para se conectar ao servidor da web e estabelecer as informações do cliente, que são tratadas como o certificado para o usuário. Em seguida, o servidor de aplicativos usa as informações de certificado para propósitos de autenticação quando a autenticação por certificado de cliente é utilizada ou quando o código do aplicativo acessa os certificados javax.net.ssl.peer_certificates. Como essas informações são declaradas, elas não são seguras e são potencialmente vulneráveis a um atacante que pode se conectar diretamente ao servidor de aplicativos e ignorar o servidor da Web.

Importante: Se você permitir conexões diretas com o servidor de aplicativos e utilizar certificados clientes, você deverá configurar essa propriedade customizada como false.
Nome Valor Padrão
confiável true
[AIX Solaris HP-UX Linux Windows]

UseOracleBLOB

A propriedade customizada UseOracleBLOB cria a tabela de banco de dados de sessão HTTP usando o tipo de dados Objeto Binário Grande (BLOB) para a coluna média. Essa propriedade aumenta o desempenho das sessões persistentes quando os bancos de dados Oracle são utilizados.

Devido a uma restrição do Oracle, o suporte ao BLOB requer o uso do driver de banco de dados oci para Oracle para mais de 4000 bytes de dados. Você também deve assegurar que uma nova tabela de sessões seja criada antes do servidor ser reiniciado, eliminando sua tabela de sessões antiga ou alterando a definição da origem de dados para fazer referência a um banco de dados que não contém uma tabela de sessões.

Para criar uma tabela de sessões usando o tipo de dados BLOB, configure essa propriedade como true.

Nota: O uso da propriedade UseOracleBLOB como uma propriedade customizada de contêiner da web foi descontinuado. Agora defina essa função como uma propriedade customizada de gerenciamento de sessões.
Nome Valor Padrão
UseOracleBLOB falso
[AIX Solaris HP-UX Linux Windows]

setContentLengthOnClose

Alterne se o comprimento de conteúdo não deve ser configurado quando um aplicativo fechar explicitamente a resposta.

O valor padrão e recomendado é true, no entanto, configure o valor false se uma resposta de aplicativo contiver caracteres de byte duplo.

Nome Valor Padrão
setContentLengthOnClose true

com.ibm.ws.webcontainer.servlet30compatibility

Quando essa propriedade customizada for configurada como true, as mudanças de comportamento feitas para o servlet 3.1 são revertidas para o comportamento do servlet 3.0 a seguir:

  • Se você chamar AsyncContext.getRequest() ou AsyncContext.getResponse() após AsyncContext.dispatch() ou AsyncContext.complete(), o servidor não lançará uma IllegalStateException.
  • Se você chamar ServletResponse.reset(), o status de chamada getWriter() ou getOutputStream() não será limpo.
  • Se você chamar os seguintes métodos ServletContext, o servidor não emitirá uma UnsupportedOperationException:
    • ServletContext.getClassLoader()
    • ServletContext.getEffectiveMajorVersion()
    • ServletContext.getEffectiveMinorVersion()
    • ServletContext.getFilterRegistration()
    • ServletContext.getFilterRegistrations()
    • ServletContext.getServletRegistration()
    • ServletContext.getServletRegistrations()
    • ServletContext.declareRoles()
    • ServletContext.getVirtualServerName()
  • O WebContainer não para o registro de um servlet com um mapeamento da URL duplicado. Um aplicativo existente é iniciado normalmente, no entanto, a implementação de um novo aplicativo que contém conflitos com múltiplos servlets mapeados para o mesmo padrão de url ainda falham ao ser implementados.
  • O conjunto de valores na propriedade customizada do WebContainer, com.ibm.ws.webcontainer.RedirectWithPathInfo, não é ignorado.
  • Se um servlet lançar uma IOException e houver um filtro configurado para essa solicitação, o WebContainer lançará uma ServletException.

O valor padrão e o valor recomendado são false, no entanto, é possível configurar o valor para true para reverter para o comportamento da versão 3.0.

Nome Valor Padrão
com.ibm.ws.webcontainer.servlet30compatibility falso

Ícone que indica o tipo de tópico Tópico de Referência



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rweb_custom_props
Nome do arquivo: rweb_custom_props.html