webContainer - Web Container (webContainer)

Configuration for the web container.

NameTypeDefaultDescription
listenersstringA comma separated list of listener classes.
decodeUrlAsUtf8booleantrueDecode URLs using an encoding setting of UTF-8.
fileServingEnabledbooleantrueEnable file serving if this setting was not explicitly specified for the application.
disallowAllFileServingbooleanfalseDisables all file serving by applications. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.disallowAllFileServing.
directoryBrowsingEnabledbooleanfalseEnable directory browsing of an application.
serveServletsByClassnameEnabledbooleanfalseEnable servlets to be accessed in a web application using a class name if not explicitly specified.
disallowServeServletsByClassNamebooleantrueDisallows the use of serveServletsByClassnameEnabled on the application server level. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.disallowserveservletsbyclassname.
doNotServeByClassNamestringA semi-colon delimited list of classes to be completely disallowed from being served by classname. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.donotservebyclassname.
httpsIndicatorHeaderstringFor SSL offloading, set to the name of the HTTP header variable inserted by the SSL accelerator/proxy/load balancer.
exposeWebInfOnDispatchbooleanfalseIf true, a servlet can access files in the WEB-INF directory. If false (default), a servlet cannot access files the WEB-INF directory.
decodeUrlPlusSignbooleanfalseDecode the plus sign when it is part of the URL. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.decodeurlplussign.
channelWriteTypestringasyncWhen set to 'sync', responses will be written synchronously; otherwise, responses will be written asychronously. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.channelwritetype.
suppressHtmlRecursiveErrorOutputbooleanfalseSuppresses the exception information from appearing in the HTML output when there is a recursive error that cannot be handled by an application's configured error page. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.suppressHtmlRecursiveErrorOutput.
fileWrapperEventsbooleanfalseWeb container will generate SMF and PMI data when serving the static files. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.fileWrapperEvents.
defaultTraceRequestBehaviorbooleanfalseRestore HTTP TRACE processing. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.DefaultTraceRequestBehavior.
defaultHeadRequestBehaviorbooleanfalseRestore the behavior where the HEAD request is not subject to the security constraint defined for the GET method. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.DefaultHeadRequestBehavior.
tolerateSymbolicLinksbooleanfalseEnables the web container to support the use of symbolic links. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.TolerateSymbolicLinks.
symbolicLinksCacheSizeint1000Initial size of the symbolic link cache. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.SymbolicLinksCacheSize.
enableErrorExceptionTypeFirstbooleanfalseWeb container is updated to search and use the exception-type before the error-code. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.enableErrorExceptionTypeFirst.
copyAttributesKeySetbooleanfalseWeb container will return an enumeration of a copy of the list of attributes to the servlet to avoid a concurrent access error by the servlet. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.copyattributeskeyset.
dispatcherRethrowsErbooleantrueWeb container will re-throw errors allowing interested resources to process them. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.dispatcherRethrowser.
ignoreSessiononStaticFileRequestbooleanfalseImproves performance by preventing the web container from accessing a session for static file requests involving filters. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.IgnoreSessiononStaticFileRequest.
invokeFilterInitAtStartupbooleantrueWeb container will call the filter's init() method at application startup. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.invokeFilterInitAtStartup.
enableJspMappingOverridebooleanfalseAllow the JSP mapping to be overridden so that the application can serve the JSP contents itself. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.enablejspmappingoverride.
enableDefaultIsElIgnoredInTagbooleanfalseAlways evaluate whether to ignore EL expressions in tag files. If parent JSP files have different isELIgnored settings, the setting will be re-evaluated in the tag file. The equivalent custom property in the full profile application server is com.ibm.ws.jsp.enabledefaultiselignoredintag.
parseUtf8PostDatabooleanfalseWeb container will detect non URL encoded UTF-8 post data and include it in the parameter values. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.parseutf8postdata.
logServletContainerInitializerClassLoadingErrorsbooleanfalseLog servlet container class loading errors as warnings rather than logging them only when debug is enabled. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.logservletcontainerinitializerclassloadingerrors.
allowIncludeSendErrorbooleanfalseAllow RequestDispatch to send errors on Include methods. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.allowincludesenderror.
skipMetaInfResourcesProcessingbooleanfalseDo not search the meta-inf directory for application resources. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.skipmetainfresourcesprocessing.
metaInfResourcesCacheSizeint20Initial size (number of entries) of the meta-inf resource cache. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.metainfresourcescachesize.name.
xPoweredBystringAlternative string for the X-Powered-By header setting. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.xpoweredby. There is no default value for this property. If the property is not set, the value of the X-Powered-By header is set to Servlet/<servlet spec version>, as defined by the Servlet specification.
disableXPoweredBybooleanfalseDisable setting the X-Powered-By header. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.disablexpoweredby.
deferServletLoadbooleantrueDefer servlet loading from application server startup.
asyncMaxSizeTaskPoolint5000Maximum size of tasks in the Async task pool before automatically purging canceled tasks. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.asyncmaxsizetaskpool.
asyncPurgeIntervalint30000Time interval to wait between each required purge of the cancelled task pool. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.asyncpurgeinterval.
asyncTimeoutDefaultint30000Async servlet timeout value used when a timeout value has not been explcitly specified. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.asynctimeoutdefault.
asyncTimerThreadsint2Maximum number of threads to use for async servlet timeout processing. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.asynctimerthreads.
setContentLengthOnClosebooleantrueToggle to set content length when an application explicitly closes the response. The default value is true; however, set this value to false if an application response contains double-byte characters.
emptyServletMappingsbooleanfalseToggle if you want to return an empty collection, instead of null, when no servlet mappings are added. The default value is false. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.emptyservletmappings.
deferServletRequestListenerDestroyOnErrorbooleanfalseToggle if you want to defer ServletRequestListener destroy when there is an error serving the request. The default value is false. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.deferServletRequestListenerDestroyOnError.
allowExpressionFactoryPerAppbooleanfalseToggle to load the ExpressionFactory that is set by the application. Enable this custom property if you are using a custom EL implementation (for example, JUEL) that needs to set its own ExpressionFactory.
ignoreSemiColonOnRedirectToWelcomePagebooleanfalseToggle to ignore the trailing semi-colon when redirecting to the welcome page. The default value is false. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.ignoreSemiColonOnRedirectToWelcomePage.
useSemiColonAsDelimiterInURIbooleanfalseToggle to use the semi-colon as a delimiter in the request URI. The default value is false. The equivalent custom property in the full application server profile is com.ibm.ws.webcontainer.useSemiColonAsDelimiterInURI.