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:
- No console administrativo, clique em .
- Em Propriedades Adicionais, selecione Propriedades Customizadas.
- Na página Propriedades Customizadas, clique em Novo.
- 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.
- Clique em Aplicar ou em OK.
- Clique em Salvar na barra de tarefas do console para salvar suas alterações na configuração.
- 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.
- BodyContentBuffSize
- com.ibm.ws.jsf.disablealternatefacesconfigsearch
- com.ibm.ws.jsp.doNotEscapeWhitespaceCharsInExpression
- com.ibm.ws.jsp.enableDefaultIsELIgnoredInTag
- com.ibm.ws.jsp.expressionreturnemptystring
- com.ibm.ws.jsp.getWriterOnEmptyBuffer
- com.ibm.ws.jsp.limitBuffer
- com.ibm.ws.jsp.throwExceptionForAddELResolver
com.ibm.ws.jsp.zosFileLockRetrying
com.ibm.ws.jsp.zosReCompile
- com.ibm.ws.webcontainer.allowDotsinName
- com.ibm.ws.webcontainer.allowPrivAccessGetResource
- com.ibm.ws.webcontainer.appendMetaInfResourcesInLooseLib
- com.ibm.ws.webcontainer.channelwritetype
- com.ibm.ws.webcontainer.checkEDRinGetRealPath
- com.ibm.ws.webcontainer.copyattributeskeyset
- com.ibm.ws.webcontainer.decodeParamViaReqEncoding
- com.ibm.ws.webcontainer.deferServingRequestsUntilEarStarted
- com.ibm.ws.webcontainer.deferServletRequestListenerDestroyOnError
- com.ibm.ws.webcontainer.disableSetCharacterEncodingAfterParametersRead
- com.ibm.ws.webcontainer.disableStaticMappingCache
- com.ibm.ws.webcontainer.disableSystemAppGlobalListenerLoading
- com.ibm.ws.webcontainer.disablexPoweredBy
- com.ibm.ws.webcontainer.disallowAllFileServing
- com.ibm.ws.webcontainer.disallowServeServletsByClassname
- com.ibm.ws.webcontainer.discernUnavailableServlet
- com.ibm.ws.webcontainer.dispatcherRethrowSER
- com.ibm.ws.webcontainer.dispatcherRethrowSError
com.ibm.ws.webcontainer.divertrecursiveexceptiontoerrorlog
- com.ibm.ws.webcontainer.donotservebyclassname
- com.ibm.ws.webcontainer.emptyServletMappings
- com.ibm.ws.webcontainer.enabledefaultservletrequestpathelements
- com.ibm.ws.webcontainer.enableErrorExceptionTypeFirst
- com.ibm.ws.webcontainer.enableExactMatchJSecurityCheck
- com.ibm.ws.webcontainer.enableJspMappingOverride
- com.ibm.ws.webcontainer.enableMultiReadOfPostData
- com.ibm.ws.webcontainer.excludehandledtypesclasses
- com.ibm.ws.webcontainer.extractHostHeaderPort and trusthostheaderport
com.ibm.ws.webcontainer.fileWrapperEvents
com.ibm.ws.webcontainer.FileWrapperEventsLessDetail
- com.ibm.ws.webcontainer.finishresponseonclose
- com.ibm.ws.webcontainer.ForceDifferentCookiePaths
- com.ibm.ws.webcontainer.handlingRequestWithOverridenPath
- com.ibm.ws.webcontainer.HTTPOnlyCookies
- com.ibm.ws.webcontainer.ignoreinjectionfailure
- com.ibm.ws.webcontainer.ignoreInvalidQueryString
- com.ibm.ws.webcontainer.ignorePostConstructOverriddenMethod
- com.ibm.ws.webcontainer.ignoreSemiColonOnRedirectToWelcomePage
- com.ibm.ws.webcontainer.IgnoreSessiononStaticFileRequest
- com.ibm.ws.webcontainer.initFilterBeforeInitServlet
- com.ibm.ws.webcontainer.invokeFilterAfterService
- com.ibm.ws.webcontainer.invokeFilterInitAtStartup
- com.ibm.ws.webcontainer.KeepUnreadPostDataAfterResponseSentToClient
- com.ibm.ws.webcontainer.logServletContainerInitializerClassloadingErrors
- com.ibm.ws.webcontainer.mapFiltersToAsterisk
- com.ibm.ws.webcontainer.maxParamPerRequest
- com.ibm.ws.webcontainer.metainfresourcescachesize
- com.ibm.ws.webcontainer.modifiedFileNotFoundExceptionBehavior
- com.ibm.ws.webcontainer.normalizerequesturi
- com.ibm.ws.webcontainer.parseUTF8PostData
- com.ibm.ws.webcontainer.preserveRequestParameterValues
- com.ibm.ws.webcontainer.provideQStringToWelcomeFile
- com.ibm.ws.webcontainer.RedirectWithPathInfo
- com.ibm.ws.webcontainer.removeAttributeForNullObject
- com.ibm.ws.webcontainer.returnDefaultContextPath
- com.ibm.ws.webcontainer.searchMetaInfResourcesDuringAppStart
- com.ibm.ws.webcontainer.SendResponseToClientAsPartOfSendRedirect
- com.ibm.ws.webcontainer.SendResponseToClientWhenResponseIsComplete
- com.ibm.ws.webcontainer.setcontenttypebysetheader
- com.ibm.ws.webcontainer.setAsyncDispatchRequestURI
- com.ibm.ws.webcontainer.ServeWelcomeFileFromExtendedDocumentRoot
- com.ibm.ws.webcontainer.ServletDestroyWaitTime
- com.ibm.ws.webcontainer.setUnencodedHTMLinsendError
- com.ibm.ws.webcontainer.skipInputStreamReadOnError
- com.ibm.ws.webcontainer.SkipMetaInfResourcesProcessing
- com.ibm.ws.webcontainer.suppressheadersinrequest
- com.ibm.ws.webcontainer.suppressHtmlRecursiveErrorOutput
- com.ibm.ws.webcontainer.suppressLastZeroBytePackage
- com.ibm.ws.webcontainer.suppressLoggingFileNotFoundExceptions
- com.ibm.ws.webcontainer.suppressLoggingWebGroupVhostNotFound
- com.ibm.ws.webcontainer.suppressServletExceptionLogging
- com.ibm.ws.webcontainer.throwMissingJspException
- com.ibm.ws.webcontainer.throwpostconstructexception
com.ibm.ws.webcontainer.tolerateLocaleMismatchForServingFiles
- com.ibm.ws.webcontainer.useOriginalRequestState
- com.ibm.ws.webcontainer.useSemiColonAsDelimiterInURI
- com.ibm.ws.webcontainer.webgroupvhostnotfound
- com.ibm.ws.webcontainer.xPoweredBy
- com.ibm.websphere.management.application.sync.deleteSymbolicLinks
- com.ibm.wsspi.jsp.allowMultipleAttributeValues
- com.ibm.wsspi.jsp.convertAttrValueToString
- com.ibm.wsspi.jsp.disableElCache
- com.ibm.wsspi.jsp.disableResourceInjection
- com.ibm.wsspi.jsp.disableTldSearch
- com.ibm.wsspi.jsp.enabledoublequotesdecoding
- com.ibm.wsspi.jsp.removexmlnsfromoutput
ConnectionResponseTimeout
DebugSessionCrossover
- DecodeUrlAsUTF8
- DisableMultiThreadedServletConnectionMgmt
- com.ibm.ws.webcontainer.denyDuplicateFilterinChain
- enableInProcessConnections
- fileServingEnabled, directoryBrowsingEnabled e serveServletsByClassnameEnabled
- ForceSessionIdLengthCheck
- ForceSessionInvalidationMultiple
- httpsIndicatorHeader
- HttpSessionIdReuse
- listeners
MutualAuthCBindCheck
- prependSlashToResource
- com.ibm.ws.webcontainer.suppressLoggingServiceRuntimeExcep
- confiável
UseOracleBLOB
setContentLengthOnClose
- com.ibm.ws.webcontainer.servlet30compatibility
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.
<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]](../images/ngzos.gif)
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]](../images/ngzos.gif)
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 |
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 |

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 |

![[z/OS]](../images/ngzos.gif)
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
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
- Qualquer página de erro de código de erro correspondente
- 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.
- Obtenha o InputStream ou Leitor
- Leia os dados
- 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
- Número da porta da URL do pedido
- O número da porta a partir do cabeçalho do host de pedido.
trusthostheaderport = true
com.ibm.ws.webcontainer.extractHostHeaderPort = true

Nome | Valor Padrão |
---|---|
com.ibm.ws.webcontainer.extractHostHeaderPort | falso |
trusthostheaderport | falso |
![[z/OS]](../images/ngzos.gif)
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]](../images/ngzos.gif)
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

- * - 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.
com.ibm.ws.webcontainer.HTTPOnlyCookies=*
com.ibm.ws.webcontainer.HTTPOnlyCookies=cookieName1,Account3Cookie,JsessionID

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.
trnsPara 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.

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.

Nome | Valor Padrão |
---|---|
com.ibm.ws.webcontainer.throwpostconstructexception | true |
![[AIX]](../images/aixlogo.gif)
com.ibm.ws.webcontainer.tolerateLocaleMismatchForServingFiles
- 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.websphere.management.application.sync.deleteSymbolicLinks
Os links simbólicos existentes no diretório de instalação do aplicativo serão excluídos quando o aplicativo for desinstalado ou atualizado. Para assegurar que os links simbólicos não sejam excluídos, inclua a propriedade customizada com.ibm.websphere.management.application.sync.deleteSymbolicLinks no seu JVM e configure-a como false.
Essa propriedade deve ser configurada no nível do agente do nó.
Nome | Valor Padrão |
---|---|
com.ibm.websphere.management.application.sync.deleteSymbolicLinks | true |
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]](../images/ngzos.gif)
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]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
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.
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
- Clique em Servidores de aplicativos > server_name > Contêiner da web > Propriedades customizadas.
- 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.

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.
- 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.
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.
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]](../images/ngzos.gif)
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.

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.
Nome | Valor Padrão |
---|---|
confiável | true |
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
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.
Nome | Valor Padrão |
---|---|
UseOracleBLOB | falso |
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
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 |