Java Servlets 3.0
此功能部件启用对已写入 Java Servlet 3.0 规范的 HTTP servlet 的支持。这些 servlet 可打包到 Java EE 指定的 WAR 或 EAR 文件中。如果需要 servlet 安全性,那么还应配置 appSecurity 功能部件;如果没有安全性功能部件,那么系统将忽略针对应用程序的所有安全性约束。
启用此功能部件
<feature>servlet-3.0</feature>
受支持的 Java™ 版本
- JavaSE-1.6
- JavaSE-1.7
- JavaSE-1.8
开发依赖于此功能部件的功能部件
com.ibm.websphere.appserver.servlet-3.0; type="osgi.subsystem.feature"
启用此功能部件的功能部件
- Admin Center
- Application Security 1.0
- Collective Member
- Java RESTful Services 1.1
- Java Persistence API 2.0
- JavaServer Faces 2.0
- JavaServer Pages 2.2
- OAuth
- OpenID
- OpenID Connect Client
- OpenID Connect Provider
- OSGi Java Persistence API
- JMX REST Connector
- Simple and Protected GSSAPI Negotiation Mechanism
- OSGi Web Application Bundles
- Web Response Cache
- Java EE Web Profile 6.0
此功能部件提供的标准 API 包
- javax.servlet
- javax.servlet.annotation
- javax.servlet.descriptor
- javax.servlet.http
- javax.servlet.resources
此功能部件提供的 IBM API 包
此功能部件提供的 SPI 包
- com.ibm.websphere.servlet.filter
- com.ibm.websphere.servlet.response
- com.ibm.ws.webcontainer.extension
- com.ibm.wsspi.webcontainer
- com.ibm.wsspi.webcontainer.collaborator
- com.ibm.wsspi.webcontainer.extension
- com.ibm.wsspi.webcontainer.filter
- com.ibm.wsspi.webcontainer.metadata
- com.ibm.wsspi.webcontainer.osgi.extension
- com.ibm.wsspi.webcontainer.servlet
- com.ibm.wsspi.webcontainer.webapp
功能部件配置元素
可在 server.xml 文件中使用以下元素以配置 Java Servlets 3.0 功能部件:
- application
- applicationMonitor
- channelfw
- classloading
- enterpriseApplication
- httpAccessLogging
- httpDispatcher
- httpEncoding
- httpEndpoint
- httpOptions
- httpProxyRedirect
- httpSession
- javaPermission
- library
- mimeTypes
- pluginConfiguration
- tcpOptions
- virtualHost
- webApplication
- webContainer
- application
- 定义应用程序的属性。
属性名称 数据类型 缺省值 描述 autoStart 布尔型 true 指示服务器是否自动启动应用程序。 context-root string 应用程序的上下文根。 id 字符串 唯一配置标识。 location 文件、目录或 URL。 应用程序的位置,表示为绝对路径或相对于服务器级应用程序目录的路径。 name string 应用程序的名称。 suppressUncoveredHttpMethodWarning 布尔型 false 指示在应用程序部署期间阻止未覆盖 HTTP 方法警告消息的选项。 type string 应用程序归档的类型。 - application > application-bnd
描述: 将应用程序中包括的常规部署信息绑定到特定资源。必需: false数据类型: 属性名称 数据类型 缺省值 描述 version string 应用程序绑定规范的版本。 - application > application-bnd > security-role
描述: 唯一配置标识。必需: false数据类型: 属性名称 数据类型 缺省值 描述 id 字符串 唯一配置标识。 name string 安全角色的名称。 - application > application-bnd > security-role > group
描述: 唯一配置标识。必需: false数据类型: 属性名称 数据类型 缺省值 描述 access-id string 组访问标识 id 字符串 唯一配置标识。 name string 拥有安全角色的组的名称。
- application > application-bnd > security-role > run-as
描述: 唯一配置标识。必需: false数据类型: 属性名称 数据类型 缺省值 描述 id 字符串 唯一配置标识。 password 可逆向编码的密码(字符串) 从一个 Bean 访问另一个 Bean 时需要的用户密码。可采用明文或编码格式存储该值。要对该密码进行编码,请将 securityUtility 工具与编码选项配合使用。 userid string 从一个 Bean 访问另一个 Bean 时需要的用户标识。
- application > classloader
描述: 定义应用程序类装入器的设置。必需: false数据类型: 属性名称 数据类型 缺省值 描述 apiTypeVisibility string spec,ibm-api,api 此类装入器将能够看到的 API 包的类型,其格式为下列项的任何组合的逗号分隔列表:规范、ibm-api、api 和第三方。 classProviderRef 对顶级 resourceAdapter 元素的引用的列表(以逗号分隔的字符串)。 类提供程序引用的列表。当搜索类或资源时,此类装入器将在搜索其自己的类路径之后授权给指定的类提供程序。 commonLibraryRef 对顶级 library 元素的引用的列表(以逗号分隔的字符串)。 库引用的列表。库类实例是与其他类装入器共享的。 delegation - parentFirst
- parentLast
parentFirst 控制父类装入器是用在此类装入器之前还是之后。如果选择“父代最先”,那么在搜索类路径之前,授权给直接父代。如果选择“父代最后”,那么在授权给直接父代之前,搜索类路径。 - parentFirst
- 父代最先
- parentLast
- 父代最后
privateLibraryRef 对顶级 library 元素的引用的列表(以逗号分隔的字符串)。 库引用的列表。库类实例是此类装入器特有的,与来自其他类装入器的类实例无关。 - application > classloader > commonLibrary
描述: 库引用的列表。库类实例是与其他类装入器共享的。必需: false数据类型: 属性名称 数据类型 缺省值 描述 apiTypeVisibility string spec,ibm-api,api 此库的类装入器将能够看到的 API 包的类型,其格式为下列项的任何组合的逗号分隔列表:规范、ibm-api、api 和第三方。 description string 管理员的共享库的描述 filesetRef 对顶级 fileset 元素的引用的列表(以逗号分隔的字符串)。 所引用文件集的标识 id 字符串 唯一配置标识。 name string 管理员的共享库的名称 - application > classloader > commonLibrary > file
描述: 所引用文件的标识必需: false数据类型: 属性名称 数据类型 缺省值 描述 id 字符串 唯一配置标识。 name 文件路径 标准文件名
- application > classloader > commonLibrary > fileset
描述: 所引用文件集的标识必需: false数据类型: 属性名称 数据类型 缺省值 描述 caseSensitive 布尔型 true 指示搜索是否应区分大小写的布尔值(缺省值:true)。 dir 目录路径 ${server.config.dir} 用于搜索文件的基本目录。 excludes string 要排除在搜索结果以外的文件名模式的逗号或空格分隔列表,缺省情况下不排除任何文件。 id 字符串 唯一配置标识。 includes string * 要包含在搜索结果中的文件名模式的逗号或空格分隔列表(缺省值:*)。 scanInterval 具有毫秒精度的时间段 0 检查文件集更改的扫描时间间隔,格式为长整形加上时间单位后缀(h 表示小时、m 表示分钟、s 表示秒、ms 表示毫秒),例如,2ms 或 5s。缺省情况下为禁用 (scanInterval=0)。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
- application > classloader > privateLibrary
描述: 库引用的列表。库类实例是此类装入器特有的,与来自其他类装入器的类实例无关。必需: false数据类型: 属性名称 数据类型 缺省值 描述 apiTypeVisibility string spec,ibm-api,api 此库的类装入器将能够看到的 API 包的类型,其格式为下列项的任何组合的逗号分隔列表:规范、ibm-api、api 和第三方。 description string 管理员的共享库的描述 filesetRef 对顶级 fileset 元素的引用的列表(以逗号分隔的字符串)。 所引用文件集的标识 id 字符串 唯一配置标识。 name string 管理员的共享库的名称 - application > classloader > privateLibrary > file
描述: 所引用文件的标识必需: false数据类型: 属性名称 数据类型 缺省值 描述 id 字符串 唯一配置标识。 name 文件路径 标准文件名
- application > classloader > privateLibrary > fileset
描述: 所引用文件集的标识必需: false数据类型: 属性名称 数据类型 缺省值 描述 caseSensitive 布尔型 true 指示搜索是否应区分大小写的布尔值(缺省值:true)。 dir 目录路径 ${server.config.dir} 用于搜索文件的基本目录。 excludes string 要排除在搜索结果以外的文件名模式的逗号或空格分隔列表,缺省情况下不排除任何文件。 id 字符串 唯一配置标识。 includes string * 要包含在搜索结果中的文件名模式的逗号或空格分隔列表(缺省值:*)。 scanInterval 具有毫秒精度的时间段 0 检查文件集更改的扫描时间间隔,格式为长整形加上时间单位后缀(h 表示小时、m 表示分钟、s 表示秒、ms 表示毫秒),例如,2ms 或 5s。缺省情况下为禁用 (scanInterval=0)。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
- application > resourceAdapter
描述: 为嵌入在应用程序中的资源适配器指定配置。必需: false数据类型: 属性名称 数据类型 缺省值 描述 alias string ${id} 覆盖资源适配器的缺省标识。该标识用于资源适配器的配置属性元素的名称中,该名称转而用于为由资源适配器提供的任何资源确定配置属性元素的名称。资源适配器的配置属性元素名称具有格式 properties.<APP_NAME>.<ALIAS>,其中 <APP_NAME> 是应用程序的名称,<ALIAS> 是已配置的别名。如果未指定,那么别名缺省为资源适配器的模块名称。 autoStart 布尔型 配置资源适配器的启动方式是在其部署时自动启动,还是在注入或查找资源时缓慢启动。 contextServiceRef 对顶级 contextService 元素的引用(字符串)。 配置上下文捕获及传播至线程的方式。 id string 确定此配置适用的嵌入式资源适配器模块的名称。 - application > resourceAdapter > contextService
描述: 配置上下文捕获及传播至线程的方式。必需: false数据类型: 属性名称 数据类型 缺省值 描述 baseContextRef 对顶级 contextService 元素的引用(字符串)。 指定从其继承上下文的基本上下文服务(尚未在此上下文服务上定义此上下文)。 jndiName string JNDI 名称 onError - IGNORE
- FAIL
- WARN
WARN 确定用于响应配置错误的操作。例如,如果为此 contextService 配置了 securityContext,但未启用安全性功能,那么 onError 会确定是对错误配置部分执行使失效操作、发出警告操作还是忽略操作。 - IGNORE
- 服务器在发生配置错误时将不会发出警告和错误消息。
- FAIL
- 服务器在第一次发生错误时将发出警告或错误消息,然后停止服务器。
- WARN
- 服务器在发生配置错误时将发出警告和错误消息。
- application > resourceAdapter > contextService > baseContext
描述: 指定从其继承上下文的基本上下文服务(尚未在此上下文服务上定义此上下文)。必需: false数据类型: 属性名称 数据类型 缺省值 描述 baseContextRef 对顶级 contextService 元素的引用(字符串)。 指定从其继承上下文的基本上下文服务(尚未在此上下文服务上定义此上下文)。 id 字符串 唯一配置标识。 jndiName string JNDI 名称 onError - IGNORE
- FAIL
- WARN
WARN 确定用于响应配置错误的操作。例如,如果为此 contextService 配置了 securityContext,但未启用安全性功能,那么 onError 会确定是对错误配置部分执行使失效操作、发出警告操作还是忽略操作。 - IGNORE
- 服务器在发生配置错误时将不会发出警告和错误消息。
- FAIL
- 服务器在第一次发生错误时将发出警告或错误消息,然后停止服务器。
- WARN
- 服务器在发生配置错误时将发出警告和错误消息。
- application > resourceAdapter > contextService > baseContext > baseContext
描述: 指定从其继承上下文的基本上下文服务(尚未在此上下文服务上定义此上下文)。必需: false数据类型: com.ibm.ws.context.service-factory
- application > resourceAdapter > contextService > baseContext > classloaderContext
描述: 类装入器上下文传播配置。必需: false数据类型:
- application > resourceAdapter > contextService > baseContext > jeeMetadataContext
描述: 请使提交上下文任务的应用程序组件的名称空间对任务可用。必需: false数据类型:
- application > resourceAdapter > contextService > baseContext > securityContext
描述: 指定时,工作发起方的安全上下文将传播到工作单元。必需: false数据类型:
- application > resourceAdapter > contextService > baseContext > syncToOSThreadContext
描述: 如果指定此项,那么工作单元的 runAs 主题的身份将与操作系统身份同步。必需: false数据类型:
- application > resourceAdapter > contextService > baseContext > zosWLMContext
描述: 指示是否应该将 z/OS WLM 作为线程上下文的一部分来管理。必需: false数据类型: 属性名称 数据类型 缺省值 描述 daemonTransactionClass string ASYNCDMN 当为守护程序工作创建新 WLM 上下文时,提供给 WLM 以对工作进行分类的事务类名称。 defaultTransactionClass string ASYNCBN 当为非守护程序工作创建新 WLM 上下文时,提供给 WLM 以对工作进行分类的事务类名称。 wlm - Propagate
- PropagateOrNew
- New
Propagate 指示如何为非守护程序工作处理 WLM 上下文。 - Propagate
- 使用相同的 WLM 上下文(如果存在一个)。
- PropagateOrNew
- 使用相同的 WLM 上下文或创建一个新的 WLM 上下文(如果不存在当前上下文)。
- New
- 始终创建新的 WLM 上下文。
- application > resourceAdapter > contextService > jeeMetadataContext
描述: 请使提交上下文任务的应用程序组件的名称空间对任务可用。必需: false数据类型:
- application > resourceAdapter > contextService > securityContext
描述: 指定时,工作发起方的安全上下文将传播到工作单元。必需: false数据类型:
- application > resourceAdapter > contextService > syncToOSThreadContext
描述: 如果指定此项,那么工作单元的 runAs 主题的身份将与操作系统身份同步。必需: false数据类型:
- application > resourceAdapter > contextService > zosWLMContext
描述: 指示是否应该将 z/OS WLM 作为线程上下文的一部分来管理。必需: false数据类型: 属性名称 数据类型 缺省值 描述 daemonTransactionClass string ASYNCDMN 当为守护程序工作创建新 WLM 上下文时,提供给 WLM 以对工作进行分类的事务类名称。 defaultTransactionClass string ASYNCBN 当为非守护程序工作创建新 WLM 上下文时,提供给 WLM 以对工作进行分类的事务类名称。 wlm - Propagate
- PropagateOrNew
- New
Propagate 指示如何为非守护程序工作处理 WLM 上下文。 - Propagate
- 使用相同的 WLM 上下文(如果存在一个)。
- PropagateOrNew
- 使用相同的 WLM 上下文或创建一个新的 WLM 上下文(如果不存在当前上下文)。
- New
- 始终创建新的 WLM 上下文。
- application > resourceAdapter > customize
描述: 定制具有指定接口和/或实现类的激活规范、受管对象或连接工厂的配置属性元素。必需: false数据类型: 属性名称 数据类型 缺省值 描述 implementation string 标准实现类名,应该针对该类名定制配置属性元素。 interface string 标准接口类名,应该针对该类名定制配置属性元素。 suffix string 覆盖配置属性元素的缺省后缀。例如,properties.rarModule1.CustomConnectionFactory 中的“CustomConnectionFactory”。当资源适配器提供了多种类型的连接工厂、受管对象或端点激活时,该后缀对于进行区别很有用。如果配置属性元素定制省略该后缀或将它保留为空白,那么不会使用后缀。
- applicationMonitor
- 定义服务器对应用程序添加、更新和删除进行响应的方式。
属性名称 数据类型 缺省值 描述 dropins 目录路径 dropins 应用程序混入目录的位置,表示为绝对路径或相对于服务器目录的路径。 dropinsEnabled 布尔型 true 监视混入目录中的应用程序添加、更新和删除。 pollingRate 具有毫秒精度的时间段 500ms 服务器检查应用程序添加、更新和删除的速率。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 updateTrigger - mbean
- polled
- disabled
polled 应用程序更新方法或触发器。 - mbean
- 仅当接收到来自外部程序(例如集成开发环境或管理应用程序)所调用的 MBean 的提示时,服务器才将更新应用程序。
- polled
- 服务器将按照轮询时间间隔进行扫描以检测应用程序更改,并更新具有可检测到的更改的任何应用程序。
- disabled
- 禁用所有更新监视。在服务器处于运行状态时,将不会应用应用程序更改。
- channelfw
- 定义通道和链管理设置。
属性名称 数据类型 缺省值 描述 chainQuiesceTimeout 具有毫秒精度的时间段 30s 停顿链时要等待的缺省时间量。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 chainStartRetryAttempts int 最小值:0
60 要为每个链进行重试尝试的次数。 chainStartRetryInterval 具有毫秒精度的时间段 5s 在启动重试之间的时间间隔。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 warningWaitTime 具有毫秒精度的时间段 10s 通知缺少工厂配置之前要等待的时间量。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 - classloading
- 全局类装入
属性名称 数据类型 缺省值 描述 useJarUrls 布尔型 false 是将 jar: URL 还是将 wsjar: URL 用于引用归档中的文件 - enterpriseApplication
- 定义企业应用程序的属性。
属性名称 数据类型 缺省值 描述 autoStart 布尔型 true 指示服务器是否自动启动应用程序。 defaultClientModule string 企业应用程序的缺省客户机模块。 id 字符串 唯一配置标识。 location 文件、目录或 URL。 应用程序的位置,表示为绝对路径或相对于服务器级应用程序目录的路径。 name string 应用程序的名称。 suppressUncoveredHttpMethodWarning 布尔型 false 指示在应用程序部署期间阻止未覆盖 HTTP 方法警告消息的选项。 - enterpriseApplication > application-bnd
描述: 将应用程序中包括的常规部署信息绑定到特定资源。必需: false数据类型: 属性名称 数据类型 缺省值 描述 version string 应用程序绑定规范的版本。 - enterpriseApplication > application-bnd > security-role
描述: 唯一配置标识。必需: false数据类型: 属性名称 数据类型 缺省值 描述 id 字符串 唯一配置标识。 name string 安全角色的名称。 - enterpriseApplication > application-bnd > security-role > group
描述: 唯一配置标识。必需: false数据类型: 属性名称 数据类型 缺省值 描述 access-id string 组访问标识 id 字符串 唯一配置标识。 name string 拥有安全角色的组的名称。
- enterpriseApplication > application-bnd > security-role > run-as
描述: 唯一配置标识。必需: false数据类型: 属性名称 数据类型 缺省值 描述 id 字符串 唯一配置标识。 password 可逆向编码的密码(字符串) 从一个 Bean 访问另一个 Bean 时需要的用户密码。可采用明文或编码格式存储该值。要对该密码进行编码,请将 securityUtility 工具与编码选项配合使用。 userid string 从一个 Bean 访问另一个 Bean 时需要的用户标识。
- enterpriseApplication > classloader
描述: 定义应用程序类装入器的设置。必需: false数据类型: 属性名称 数据类型 缺省值 描述 apiTypeVisibility string spec,ibm-api,api 此类装入器将能够看到的 API 包的类型,其格式为下列项的任何组合的逗号分隔列表:规范、ibm-api、api 和第三方。 classProviderRef 对顶级 resourceAdapter 元素的引用的列表(以逗号分隔的字符串)。 类提供程序引用的列表。当搜索类或资源时,此类装入器将在搜索其自己的类路径之后授权给指定的类提供程序。 commonLibraryRef 对顶级 library 元素的引用的列表(以逗号分隔的字符串)。 库引用的列表。库类实例是与其他类装入器共享的。 delegation - parentFirst
- parentLast
parentFirst 控制父类装入器是用在此类装入器之前还是之后。如果选择“父代最先”,那么在搜索类路径之前,授权给直接父代。如果选择“父代最后”,那么在授权给直接父代之前,搜索类路径。 - parentFirst
- 父代最先
- parentLast
- 父代最后
privateLibraryRef 对顶级 library 元素的引用的列表(以逗号分隔的字符串)。 库引用的列表。库类实例是此类装入器特有的,与来自其他类装入器的类实例无关。 - enterpriseApplication > classloader > commonLibrary
描述: 库引用的列表。库类实例是与其他类装入器共享的。必需: false数据类型: 属性名称 数据类型 缺省值 描述 apiTypeVisibility string spec,ibm-api,api 此库的类装入器将能够看到的 API 包的类型,其格式为下列项的任何组合的逗号分隔列表:规范、ibm-api、api 和第三方。 description string 管理员的共享库的描述 filesetRef 对顶级 fileset 元素的引用的列表(以逗号分隔的字符串)。 所引用文件集的标识 id 字符串 唯一配置标识。 name string 管理员的共享库的名称 - enterpriseApplication > classloader > commonLibrary > file
描述: 所引用文件的标识必需: false数据类型: 属性名称 数据类型 缺省值 描述 id 字符串 唯一配置标识。 name 文件路径 标准文件名
- enterpriseApplication > classloader > commonLibrary > fileset
描述: 所引用文件集的标识必需: false数据类型: 属性名称 数据类型 缺省值 描述 caseSensitive 布尔型 true 指示搜索是否应区分大小写的布尔值(缺省值:true)。 dir 目录路径 ${server.config.dir} 用于搜索文件的基本目录。 excludes string 要排除在搜索结果以外的文件名模式的逗号或空格分隔列表,缺省情况下不排除任何文件。 id 字符串 唯一配置标识。 includes string * 要包含在搜索结果中的文件名模式的逗号或空格分隔列表(缺省值:*)。 scanInterval 具有毫秒精度的时间段 0 检查文件集更改的扫描时间间隔,格式为长整形加上时间单位后缀(h 表示小时、m 表示分钟、s 表示秒、ms 表示毫秒),例如,2ms 或 5s。缺省情况下为禁用 (scanInterval=0)。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
- enterpriseApplication > classloader > privateLibrary
描述: 库引用的列表。库类实例是此类装入器特有的,与来自其他类装入器的类实例无关。必需: false数据类型: 属性名称 数据类型 缺省值 描述 apiTypeVisibility string spec,ibm-api,api 此库的类装入器将能够看到的 API 包的类型,其格式为下列项的任何组合的逗号分隔列表:规范、ibm-api、api 和第三方。 description string 管理员的共享库的描述 filesetRef 对顶级 fileset 元素的引用的列表(以逗号分隔的字符串)。 所引用文件集的标识 id 字符串 唯一配置标识。 name string 管理员的共享库的名称 - enterpriseApplication > classloader > privateLibrary > file
描述: 所引用文件的标识必需: false数据类型: 属性名称 数据类型 缺省值 描述 id 字符串 唯一配置标识。 name 文件路径 标准文件名
- enterpriseApplication > classloader > privateLibrary > fileset
描述: 所引用文件集的标识必需: false数据类型: 属性名称 数据类型 缺省值 描述 caseSensitive 布尔型 true 指示搜索是否应区分大小写的布尔值(缺省值:true)。 dir 目录路径 ${server.config.dir} 用于搜索文件的基本目录。 excludes string 要排除在搜索结果以外的文件名模式的逗号或空格分隔列表,缺省情况下不排除任何文件。 id 字符串 唯一配置标识。 includes string * 要包含在搜索结果中的文件名模式的逗号或空格分隔列表(缺省值:*)。 scanInterval 具有毫秒精度的时间段 0 检查文件集更改的扫描时间间隔,格式为长整形加上时间单位后缀(h 表示小时、m 表示分钟、s 表示秒、ms 表示毫秒),例如,2ms 或 5s。缺省情况下为禁用 (scanInterval=0)。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
- enterpriseApplication > resourceAdapter
描述: 为嵌入在应用程序中的资源适配器指定配置。必需: false数据类型: 属性名称 数据类型 缺省值 描述 alias string ${id} 覆盖资源适配器的缺省标识。该标识用于资源适配器的配置属性元素的名称中,该名称转而用于为由资源适配器提供的任何资源确定配置属性元素的名称。资源适配器的配置属性元素名称具有格式 properties.<APP_NAME>.<ALIAS>,其中 <APP_NAME> 是应用程序的名称,<ALIAS> 是已配置的别名。如果未指定,那么别名缺省为资源适配器的模块名称。 autoStart 布尔型 配置资源适配器的启动方式是在其部署时自动启动,还是在注入或查找资源时缓慢启动。 contextServiceRef 对顶级 contextService 元素的引用(字符串)。 配置上下文捕获及传播至线程的方式。 id string 确定此配置适用的嵌入式资源适配器模块的名称。 - enterpriseApplication > resourceAdapter > contextService
描述: 配置上下文捕获及传播至线程的方式。必需: false数据类型: 属性名称 数据类型 缺省值 描述 baseContextRef 对顶级 contextService 元素的引用(字符串)。 指定从其继承上下文的基本上下文服务(尚未在此上下文服务上定义此上下文)。 jndiName string JNDI 名称 onError - IGNORE
- FAIL
- WARN
WARN 确定用于响应配置错误的操作。例如,如果为此 contextService 配置了 securityContext,但未启用安全性功能,那么 onError 会确定是对错误配置部分执行使失效操作、发出警告操作还是忽略操作。 - IGNORE
- 服务器在发生配置错误时将不会发出警告和错误消息。
- FAIL
- 服务器在第一次发生错误时将发出警告或错误消息,然后停止服务器。
- WARN
- 服务器在发生配置错误时将发出警告和错误消息。
- enterpriseApplication > resourceAdapter > contextService > baseContext
描述: 指定从其继承上下文的基本上下文服务(尚未在此上下文服务上定义此上下文)。必需: false数据类型: 属性名称 数据类型 缺省值 描述 baseContextRef 对顶级 contextService 元素的引用(字符串)。 指定从其继承上下文的基本上下文服务(尚未在此上下文服务上定义此上下文)。 id 字符串 唯一配置标识。 jndiName string JNDI 名称 onError - IGNORE
- FAIL
- WARN
WARN 确定用于响应配置错误的操作。例如,如果为此 contextService 配置了 securityContext,但未启用安全性功能,那么 onError 会确定是对错误配置部分执行使失效操作、发出警告操作还是忽略操作。 - IGNORE
- 服务器在发生配置错误时将不会发出警告和错误消息。
- FAIL
- 服务器在第一次发生错误时将发出警告或错误消息,然后停止服务器。
- WARN
- 服务器在发生配置错误时将发出警告和错误消息。
- enterpriseApplication > resourceAdapter > contextService > baseContext > baseContext
描述: 指定从其继承上下文的基本上下文服务(尚未在此上下文服务上定义此上下文)。必需: false数据类型: com.ibm.ws.context.service-factory
- enterpriseApplication > resourceAdapter > contextService > baseContext > classloaderContext
描述: 类装入器上下文传播配置。必需: false数据类型:
- enterpriseApplication > resourceAdapter > contextService > baseContext > jeeMetadataContext
描述: 请使提交上下文任务的应用程序组件的名称空间对任务可用。必需: false数据类型:
- enterpriseApplication > resourceAdapter > contextService > baseContext > securityContext
描述: 指定时,工作发起方的安全上下文将传播到工作单元。必需: false数据类型:
- enterpriseApplication > resourceAdapter > contextService > baseContext > syncToOSThreadContext
描述: 如果指定此项,那么工作单元的 runAs 主题的身份将与操作系统身份同步。必需: false数据类型:
- enterpriseApplication > resourceAdapter > contextService > baseContext > zosWLMContext
描述: 指示是否应该将 z/OS WLM 作为线程上下文的一部分来管理。必需: false数据类型: 属性名称 数据类型 缺省值 描述 daemonTransactionClass string ASYNCDMN 当为守护程序工作创建新 WLM 上下文时,提供给 WLM 以对工作进行分类的事务类名称。 defaultTransactionClass string ASYNCBN 当为非守护程序工作创建新 WLM 上下文时,提供给 WLM 以对工作进行分类的事务类名称。 wlm - Propagate
- PropagateOrNew
- New
Propagate 指示如何为非守护程序工作处理 WLM 上下文。 - Propagate
- 使用相同的 WLM 上下文(如果存在一个)。
- PropagateOrNew
- 使用相同的 WLM 上下文或创建一个新的 WLM 上下文(如果不存在当前上下文)。
- New
- 始终创建新的 WLM 上下文。
- enterpriseApplication > resourceAdapter > contextService > classloaderContext
描述: 类装入器上下文传播配置。必需: false数据类型:
- enterpriseApplication > resourceAdapter > contextService > jeeMetadataContext
描述: 请使提交上下文任务的应用程序组件的名称空间对任务可用。必需: false数据类型:
- enterpriseApplication > resourceAdapter > contextService > securityContext
描述: 指定时,工作发起方的安全上下文将传播到工作单元。必需: false数据类型:
- enterpriseApplication > resourceAdapter > contextService > syncToOSThreadContext
描述: 如果指定此项,那么工作单元的 runAs 主题的身份将与操作系统身份同步。必需: false数据类型:
- enterpriseApplication > resourceAdapter > contextService > zosWLMContext
描述: 指示是否应该将 z/OS WLM 作为线程上下文的一部分来管理。必需: false数据类型: 属性名称 数据类型 缺省值 描述 daemonTransactionClass string ASYNCDMN 当为守护程序工作创建新 WLM 上下文时,提供给 WLM 以对工作进行分类的事务类名称。 defaultTransactionClass string ASYNCBN 当为非守护程序工作创建新 WLM 上下文时,提供给 WLM 以对工作进行分类的事务类名称。 wlm - Propagate
- PropagateOrNew
- New
Propagate 指示如何为非守护程序工作处理 WLM 上下文。 - Propagate
- 使用相同的 WLM 上下文(如果存在一个)。
- PropagateOrNew
- 使用相同的 WLM 上下文或创建一个新的 WLM 上下文(如果不存在当前上下文)。
- New
- 始终创建新的 WLM 上下文。
- enterpriseApplication > resourceAdapter > customize
描述: 定制具有指定接口和/或实现类的激活规范、受管对象或连接工厂的配置属性元素。必需: false数据类型: 属性名称 数据类型 缺省值 描述 implementation string 标准实现类名,应该针对该类名定制配置属性元素。 interface string 标准接口类名,应该针对该类名定制配置属性元素。 suffix string 覆盖配置属性元素的缺省后缀。例如,properties.rarModule1.CustomConnectionFactory 中的“CustomConnectionFactory”。当资源适配器提供了多种类型的连接工厂、受管对象或端点激活时,该后缀对于进行区别很有用。如果配置属性元素定制省略该后缀或将它保留为空白,那么不会使用后缀。
- httpAccessLogging
- HTTP 访问日志包含所有入站 HTTP 客户机请求的记录。
属性名称 数据类型 缺省值 描述 enabled 布尔型 true 启用访问日志记录。 filePath 文件路径 ${server.output.dir}/logs/http_access.log 访问日志文件的目录路径和名称。指定目录路径时可以使用标准变量替换,如 ${server.output.dir}。 id 字符串 唯一配置标识。 logFormat string %h %u %{t}W "%r" %s %b 指定记录客户机访问信息时使用的日志格式。 maxFileSize int 最小值:0
20 回滚之前日志文件的最大大小,以兆字节计;值为 0 意味着无限制。 maxFiles int 最小值:0
2 除去最早的日志文件之前将保留的日志文件的最大数目;值为 0 意味着无限制。 - httpDispatcher
- HTTP 分派器配置。
属性名称 数据类型 缺省值 描述 appOrContextRootMissingMessage string 当找不到所请求 URI 中的应用程序时,要返回给客户机的消息。 enableWelcomePage 布尔型 true 当未将任何应用程序绑定至上下文根“/”时,启用缺省 Liberty 概要文件欢迎页面。缺省值为 true。 - httpEncoding
- HTTP 传输编码设置
属性名称 数据类型 缺省值 描述 converter.Big5 string Cp950 Big5 中文转换器 converter.EUC-JP string Cp33722C EUC 日语转换器 (EUC-JP) converter.EUC-KR string Cp970 EUC 韩国语转换器 (EUC-KR) converter.EUC-TW string Cp964 EUC 繁体中文转换器 (EUC-TW) converter.EUC_KR string Cp970 EUC 韩国语转换器 (EUC_KR) converter.GB2312 string EUC_CN GB2312 中文转换器 converter.ISO-2022-KR string ISO2022KR ISO-2022 韩国语转换器 (ISO-2022-KR) converter.Shift_JIS string Cp943C Shift_JIS 日语转换器 encoding.ar string ISO-8859-6 阿拉伯语语言编码 (ar) encoding.be string ISO-8859-5 白俄罗斯语语言编码 (be) encoding.bg string ISO-8859-5 保加利亚语语言编码 (bg) encoding.bn string UTF-8 孟加拉语语言编码 (bn) encoding.ca string ISO-8859-1 加泰罗尼亚语语言编码 (ca) encoding.cs string ISO-8859-2 捷克语语言编码 (cs) encoding.da string ISO-8859-1 丹麦语语言编码 (da) encoding.de string ISO-8859-1 德语语言编码 (de) encoding.el string ISO-8859-7 希腊语语言编码 (el) encoding.en string ISO-8859-1 英语语言编码 (en) encoding.es string ISO-8859-1 西班牙语语言编码 (es) encoding.et string ISO-8859-4 爱沙尼亚语语言编码 (et) encoding.eu string ISO-8859-1 巴斯克语语言编码 (eu) encoding.fa string ISO-8859-6 波斯语语言编码 (fa) encoding.fi string ISO-8859-1 芬兰语语言编码 (fi) encoding.fo string ISO-8859-2 法罗语语言编码 (fo) encoding.fr string ISO-8859-1 法语语言编码 (fr) encoding.he string ISO-8859-8 希伯来语语言编码 (he) encoding.hi string UTF-8 印地语语言编码 (hi) encoding.hr string ISO-8859-2 克罗地亚语语言编码 (hr) encoding.hu string ISO-8859-2 匈牙利语语言编码 (hu) encoding.hy string UTF-8 亚美尼亚语语言编码 (hy) encoding.is string ISO-8859-1 冰岛语语言编码 (is) encoding.it string ISO-8859-1 意大利语语言编码 (it) encoding.iw string ISO-8859-8 希伯来语语言编码 (iw) encoding.ja string Shift_JIS 日语语言编码 (ja) encoding.ji string ISO-8859-8 意第绪语语言编码 (ji) encoding.ka string UTF-8 格鲁吉亚语语言编码 (ka) encoding.ko string EUC-KR 韩国语语言编码 (ko) encoding.lt string ISO-8859-2 立陶宛语语言编码 (lt) encoding.lv string ISO-8859-4 拉脱维亚语语言编码 (lv) encoding.mk string ISO-8859-5 马其顿语语言编码 (mk) encoding.mr string UTF-8 马拉地语语言编码 (mr) encoding.ms string ISO-8859-6 马来语语言编码 (ms) encoding.mt string ISO-8859-3 马耳他语语言编码 (mt) encoding.nl string ISO-8859-1 荷兰语语言编码 (nl) encoding.no string ISO-8859-1 挪威语语言编码 (no) encoding.pl string ISO-8859-2 波兰语语言编码 (pl) encoding.pt string ISO-8859-1 葡萄牙语语言编码 (pt) encoding.ro string ISO-8859-2 罗马尼亚语语言编码 (ro) encoding.ru string ISO-8859-5 俄语语言编码 (ru) encoding.sa string UTF-8 梵文语言编码 (sa) encoding.sh string ISO-8859-2 塞尔维亚-克罗地亚语语言编码 (sh) encoding.sk string ISO-8859-2 斯洛伐克语语言编码 (sk) encoding.sl string ISO-8859-2 斯洛文尼亚语语言编码 (sl) encoding.sq string ISO-8859-2 阿尔巴尼亚语语言编码 (sq) encoding.sr string ISO-8859-5 塞尔维亚语语言编码 (sr) encoding.sv string ISO-8859-1 瑞典语语言编码 (sv) encoding.ta string UTF-8 泰米尔语语言编码 (ta) encoding.th string windows-874 泰国语语言编码 (th) encoding.tr string ISO-8859-9 土耳其语语言编码 (tr) encoding.uk string ISO-8859-5 乌克兰语语言编码 (uk) encoding.vi string windows-1258 越南语语言编码 (vi) encoding.yi string ISO-8859-8 意第绪语语言编码 (yi) encoding.zh string GB2312 中文语言编码 (zh) encoding.zh_TW string Big5 中文语言编码 (zh_TW) - httpEndpoint
- HTTP 端点的配置属性。
属性名称 数据类型 缺省值 描述 accessLoggingRef 对顶级 httpAccessLogging 元素的引用(字符串)。 端点的 HTTP 访问日志记录配置。 enabled 布尔型 true 切换端点的可用性。值为 true 时,分派器将激活此端点以处理 HTTP 请求。 host string localhost 客户机用于请求资源的 IP 地址、带域名后缀的域名服务器 (DNS) 主机名,或仅 DNS 主机名。使用“*”可表示所有可用网络接口。 httpOptionsRef 对顶级 httpOptions 元素的引用(字符串)。 defaultHttpOptions 端点的 HTTP 协议选项。 httpPort int 最小值:-1
最大值:65535
用于客户机 HTTP 请求的端口。使用 -1 可禁用此端口。 httpsPort int 最小值:-1
最大值:65535
用于使用 SSL (https) 保护的客户机 HTTP 请求的端口。使用 -1 可禁用此端口。 id 字符串 唯一配置标识。 onError - IGNORE
- FAIL
- WARN
WARN 启动端点失败时要执行的操作。 - IGNORE
- 服务器在发生配置错误时将不会发出警告和错误消息。
- FAIL
- 服务器在第一次发生错误时将发出警告或错误消息,然后停止服务器。
- WARN
- 服务器在发生配置错误时将发出警告和错误消息。
sslOptionsRef 对顶级 sslOptions 元素的引用(字符串)。 端点的 SSL 协议选项。 tcpOptionsRef 对顶级 tcpOptions 元素的引用(字符串)。 defaultTCPOptions 端点的 TCP 协议选项。 - httpEndpoint > accessLogging
描述: 端点的 HTTP 访问日志记录配置。必需: false数据类型: 属性名称 数据类型 缺省值 描述 enabled 布尔型 true 启用访问日志记录。 filePath 文件路径 ${server.output.dir}/logs/http_access.log 访问日志文件的目录路径和名称。指定目录路径时可以使用标准变量替换,如 ${server.output.dir}。 logFormat string %h %u %{t}W "%r" %s %b 指定记录客户机访问信息时使用的日志格式。 maxFileSize int 最小值:0
20 回滚之前日志文件的最大大小,以兆字节计;值为 0 意味着无限制。 maxFiles int 最小值:0
2 除去最早的日志文件之前将保留的日志文件的最大数目;值为 0 意味着无限制。
- httpEndpoint > httpOptions
描述: 端点的 HTTP 协议选项。必需: false数据类型: 属性名称 数据类型 缺省值 描述 keepAliveEnabled 布尔型 true 启用持续连接(HTTP 保持活动)。如果为 true,那么连接将保持活动状态,以供多个顺序请求和响应重复使用。如果为 false,那么发送响应之后将关闭连接。 maxKeepAliveRequests int 最小值:-1
100 启用持续连接时,单个 HTTP 连接上允许的最大持续请求数。值为 -1 时意味着不受限制。 persistTimeout 具有秒精度的时间段 30s 将允许套接字在各个请求之间保持空闲的时间量。仅当启用持续连接时,此设置才适用。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 readTimeout 具有秒精度的时间段 60s 发生第一次读取之后,用于等待读请求在套接字上完成的时间量。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 removeServerHeader 布尔型 false 从 HTTP 头除去服务器实现信息,并同时禁用缺省 Liberty 概要文件欢迎页面。 writeTimeout 具有秒精度的时间段 60s 响应数据的每个部分在套接字上等待传输的时间量。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。
- httpEndpoint > sslOptions
描述: 端点的 SSL 协议选项。必需: false数据类型: 属性名称 数据类型 缺省值 描述 sessionTimeout 具有秒精度的时间段 1d 用于等待读或写请求在套接字上完成的时间量。特定于协议的超时将覆盖此值。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 sslRef string 缺省 SSL 配置指令表。缺省值为 defaultSSLSettings。 suppressHandshakeErrors 布尔型 false 禁用记录 SSL 握手错误。SSL 握手错误会在正常操作期间发生,但是当 SSL 行为异常时,这些消息将很有用。
- httpEndpoint > tcpOptions
描述: 端点的 TCP 协议选项。必需: false数据类型: 属性名称 数据类型 缺省值 描述 inactivityTimeout 具有毫秒精度的时间段 60s 用于等待读或写请求在套接字上完成的时间量。特定于协议的超时将覆盖此值。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 soReuseAddr 布尔型 true 允许立即重新绑定到没有任何处于活动状态的侦听器的端口。
- httpOptions
- HTTP 协议配置。
属性名称 数据类型 缺省值 描述 id 字符串 唯一配置标识。 keepAliveEnabled 布尔型 true 启用持续连接(HTTP 保持活动)。如果为 true,那么连接将保持活动状态,以供多个顺序请求和响应重复使用。如果为 false,那么发送响应之后将关闭连接。 maxKeepAliveRequests int 最小值:-1
100 启用持续连接时,单个 HTTP 连接上允许的最大持续请求数。值为 -1 时意味着不受限制。 persistTimeout 具有秒精度的时间段 30s 将允许套接字在各个请求之间保持空闲的时间量。仅当启用持续连接时,此设置才适用。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 readTimeout 具有秒精度的时间段 60s 发生第一次读取之后,用于等待读请求在套接字上完成的时间量。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 removeServerHeader 布尔型 false 从 HTTP 头除去服务器实现信息,并同时禁用缺省 Liberty 概要文件欢迎页面。 writeTimeout 具有秒精度的时间段 60s 响应数据的每个部分在套接字上等待传输的时间量。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 - httpProxyRedirect
- 配置端口重定向。将 HTTP 请求从非安全端口(例如,80)重定向至已启用 SSL 的受保护端口(例如,443)时,使用了 HTTP 代理重定向。
属性名称 数据类型 缺省值 描述 enabled 布尔型 true 此属性确定服务器是否应重定向此配置元素中指定的端口。缺省值为 true。 host string * 用于此代理重定向的主机名。仅当入局请求指定与此值匹配的主机名时,服务器才会重定向 HTTP 请求。缺省值为 *(所有主机)。 httpPort int 最小值:1
最大值:65535
要从其重定向的(非安全)端口。此端口上的入局 HTTP 请求将重定向至指定 HTTPS 端口。 httpsPort int 最小值:1
最大值:65535
要重定向至的(安全)端口。使用 HTTP 端口的入局 HTTP 请求将重定向至此端口。 id 字符串 唯一配置标识。 - httpSession
- HTTP 会话管理的配置。
属性名称 数据类型 缺省值 描述 allowOverflow 布尔型 true 允许内存中的会话数超过“内存中最大会话数”属性的值。 alwaysEncodeUrl 布尔型 false Servlet 2.5 规范指定在必要时才对 response.encodeURL 调用上的 URL 进行编码。要在启用 URL 编码时支持向后兼容性,请将此属性设置为 true 以调用 encodeURL 方法。即使浏览器支持 cookie,也始终对该 URL 进行编码。 cloneId string 集群成员的克隆标识。在集群内,此标识必须唯一,以维护会话亲缘关系。设置时,此名称会覆盖由服务器生成的缺省名称。 cloneSeparator string : 用来在会话 cookie 中将会话标识从克隆标识分离的单个字符。通常应该使用缺省值。在一些无线应用协议 (WAP) 设备上,不允许使用冒号 (:),因此应该改为使用加号 (+)。很少使用不同值。在使用此属性来更改克隆分隔符字符之前,应该了解系统上运行的其他产品的克隆字符要求。可将任何字符指定为此属性的值这一事实并不意味着您指定的字符将正常起作用。此事实也不意味着,IBM 负责修正使用备用字符时可能产生的任何问题。 cookieDomain string 会话跟踪 cookie 的域字段。 cookieHttpOnly 布尔型 true 指定会话 cookie 包括“HttpOnly”字段。支持“HttpOnly”字段的浏览器不支持客户端脚本访问 cookie。使用“HttpOnly”字段将有助于防止跨站点脚本编制攻击。 cookieMaxAge 具有秒精度的时间段 -1 cookie 可在客户机浏览器上保存的最大时间量。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 cookieName string JSESSIONID 会话管理 cookie 的唯一名称。 cookiePath string / 会将 cookie 将发送到路径中指定的 URL。 cookieSecure 布尔型 false 指定会话 cookie 包括安全字段。 cookiesEnabled 布尔型 true 指定会话跟踪使用 cookie 来传送会话标识。 debugCrossover 布尔型 false 启用此选项以执行额外检查来验证,是否仅访问或引用与请求相关联的会话并且记录消息(如果检测到任何不一致处)。禁用此选项以跳过额外检查。 forceInvalidationMultiple 整形 3 如果您的请求通常不受限于响应时间限制,请指定 0 来指示在尝试使会话失效之前,会话管理器应该无期限等待直到请求完成。否则,请将此属性设置为正整数,以延迟使活动会话失效。到第一个失效时间间隔过去为止,将不使已超时的活动会话失效,但是到基于此值的时间间隔过去为止,将使其失效。例如,值为 2 时,将在会话超时到期之后第二个失效时间间隔过去时使活动会话失效。 idLength 整形 23 会话标识的长度。 idReuse 布尔型 false 在没有为会话持久性配置的多 JVM 环境中,将此属性设置为“true”会使会话管理器能够将同一会话信息用于用户的所有请求(即使处理这些请求的 Web 应用程序由不同 JVM 控制)。此属性的缺省值为 false。如果希望使会话管理器能够使用从浏览器发送的会话标识来保存 Web 应用程序(在没有针对会话持久性配置的环境中运行)之间的会话数据,请将此属性设置为 true。 invalidateOnUnauthorizedSessionRequestException 布尔型 false 对未经授权的请求进行响应时,如果希望会话管理器使会话失效而非发出 UnauthorizedSessionRequestException,请将此属性设置为 true。当使会话失效时,请求者可以创建新会话,但对所有先前保存的会话数据没有访问权。这允许单个用户在注销后继续处理对其他应用程序的请求,但仍然保护会话数据。 invalidationTimeout 具有秒精度的时间段 30m 在会话不再有效之前可处于未使用状态的时间量。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 maxInMemorySessionCount 整形 1000 为每个 Web 模块在内存中保持的最大会话数。 noAdditionalInfo 布尔型 false 强制除去会话标识中不需要的信息。 protocolSwitchRewritingEnabled 布尔型 false 当 URL 需要从 HTTP 切换至 HTTPS 或从 HTTPS 切换至 HTTP 时,将会话标识添加到该 URL。 reaperPollInterval 具有秒精度的时间段 -1 用于除去无效会话的进程的唤醒时间间隔,以秒计。最小值为 30 秒。如果输入了小于最小值的值,那么会自动确定并使用相应值。此值会覆盖介于 30 秒与 360 秒之间的缺省安装值(基于会话超时值)。由于缺省会话超时为 30 分钟,因此收获者时间间隔通常介于 2 分钟与 3 分钟之间。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 rewriteId string jsessionid 使用此属性来更改重写 URL 时使用的密钥。 securityIntegrationEnabled 布尔型 true 启用安全性集成,这会促使会话管理工具将用户的标识与他们的 HTTP 会话相关联。 securityUserIgnoreCase 布尔型 false 指示应该将会话安全性标识和客户机安全性标识视为匹配(即使它们的大小写不同)。例如,当此属性设置为 true 时,会话安全性标识 USER1 与客户机安全性标识 User1 和 user1 匹配。 sslTrackingEnabled 布尔型 false 指定会话跟踪使用安全套接字层 (SSL) 信息作为会话标识。 urlRewritingEnabled 布尔型 false 指定会话管理工具使用重写的 URL 来传送会话标识。 useContextRootAsCookiePath 布尔型 false 指定 cookie 路径等同于 Web 模块的上下文根而非 / - javaPermission
- Java 2 安全性的许可权配置。
属性名称 数据类型 缺省值 描述 actions string 授予的许可权允许对目标名称执行的操作。例如,如果该许可权为 java.io.FilePermission,那么允许对目标名称执行的操作为“读取”。 className string 类的名称,该类用于实现要授予的许可权。例如,java.io.FilePermission。 codebase string 要被授予该许可权的代码库。 id 字符串 唯一配置标识。 name string 该许可权应用于的目标。例如,如果该许可权为 java.io.FilePermission,那么目标为“所有文件”。 principalName string 对其授予该许可权的主体。 principalType string 应针对给定主体名称进行匹配的类名。 restriction 布尔型 false 声明是限制还是授予该许可权。如果限制设置为“true”,那么将拒绝而不是授予此许可权。 - library
- 共享库
属性名称 数据类型 缺省值 描述 apiTypeVisibility string spec,ibm-api,api 此库的类装入器将能够看到的 API 包的类型,其格式为下列项的任何组合的逗号分隔列表:规范、ibm-api、api 和第三方。 description string 管理员的共享库的描述 filesetRef 对顶级 fileset 元素的引用的列表(以逗号分隔的字符串)。 所引用文件集的标识 id 字符串 唯一配置标识。 name string 管理员的共享库的名称 - library > fileset
描述: 所引用文件集的标识必需: false数据类型: 属性名称 数据类型 缺省值 描述 caseSensitive 布尔型 true 指示搜索是否应区分大小写的布尔值(缺省值:true)。 dir 目录路径 ${server.config.dir} 用于搜索文件的基本目录。 excludes string 要排除在搜索结果以外的文件名模式的逗号或空格分隔列表,缺省情况下不排除任何文件。 id 字符串 唯一配置标识。 includes string * 要包含在搜索结果中的文件名模式的逗号或空格分隔列表(缺省值:*)。 scanInterval 具有毫秒精度的时间段 0 检查文件集更改的扫描时间间隔,格式为长整形加上时间单位后缀(h 表示小时、m 表示分钟、s 表示秒、ms 表示毫秒),例如,2ms 或 5s。缺省情况下为禁用 (scanInterval=0)。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
- mimeTypes
- 所有 HTTP 虚拟主机共享的 MIME 类型的定义
- pluginConfiguration
- 生成插件配置
属性名称 数据类型 缺省值 描述 connectTimeout 具有秒精度的时间段 5s 标识应用程序服务器应保持与 Web 服务器的连接的最长时间。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 extendedHandshake 布尔型 false 如果为 true,那么 Web 服务器插件使用扩展握手来确定应用程序服务器是否正在运行。 httpEndpointRef 对顶级 httpEndpoint 元素的引用(字符串)。 defaultHttpEndpoint 指定要包括在已生成 plugin-cfg.xml 文件中的 HTTP 端点的标识。该端点在集群中定义服务器。缺省值为“defaultHttpEndpoint”。 ipv6Preferred 布尔型 false 首选 IPv6 logDirLocation 目录路径 标识 http_plugin.log 文件所在的目录。 pluginInstallRoot string . 文件系统中的 Web 容器插件安装位置 serverIOTimeout 具有秒精度的时间段 900s 标识 Web 服务器插件等待发送请求或从应用程序服务器接收响应的最长时间。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 sslCertlabel string LibertyCert SSL 证书标签 sslKeyringLocation string keyring.kdb SSL 密钥环的位置 sslStashfileLocation string keyring.sth SSL 存储文件的位置 waitForContinue 布尔型 false 如果为 false(缺省值),那么 Web 服务器插件使用具有消息体的 HTTP 请求来发送“Expect: 100-continue”头。如果设置为 true,那么 Web 服务器插件使用每个 HTTP 请求发送“Expect: 100-continue”头。如果 Web 服务器与应用程序服务器之间有防火墙,并且您对没有请求主体的请求重试很敏感,请考虑将此值设置为 true。 webserverPort int 最小值:-1
最大值:65535
80 Web 服务器 HTTP 端口 webserverSecurePort int 最小值:-1
最大值:65535
443 Web 服务器 HTTPS 端口 wsServerIOTimeout 具有秒精度的时间段 确定 Web 服务器插件等待发送请求或从应用程序服务器接收 websocket 响应的最长时间。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 wsServerIdleTimeout 具有秒精度的时间段 确定 Web 服务器插件等待终止空闲 websocket 连接的最长时间。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 - pluginConfiguration > httpEndpoint
描述: 指定要包括在已生成 plugin-cfg.xml 文件中的 HTTP 端点的标识。该端点在集群中定义服务器。缺省值为“defaultHttpEndpoint”。必需: false数据类型: 属性名称 数据类型 缺省值 描述 accessLoggingRef 对顶级 httpAccessLogging 元素的引用(字符串)。 端点的 HTTP 访问日志记录配置。 enabled 布尔型 true 切换端点的可用性。值为 true 时,分派器将激活此端点以处理 HTTP 请求。 host string localhost 客户机用于请求资源的 IP 地址、带域名后缀的域名服务器 (DNS) 主机名,或仅 DNS 主机名。使用“*”可表示所有可用网络接口。 httpOptionsRef 对顶级 httpOptions 元素的引用(字符串)。 defaultHttpOptions 端点的 HTTP 协议选项。 httpPort int 最小值:-1
最大值:65535
用于客户机 HTTP 请求的端口。使用 -1 可禁用此端口。 httpsPort int 最小值:-1
最大值:65535
用于使用 SSL (https) 保护的客户机 HTTP 请求的端口。使用 -1 可禁用此端口。 onError - IGNORE
- FAIL
- WARN
WARN 启动端点失败时要执行的操作。 - IGNORE
- 服务器在发生配置错误时将不会发出警告和错误消息。
- FAIL
- 服务器在第一次发生错误时将发出警告或错误消息,然后停止服务器。
- WARN
- 服务器在发生配置错误时将发出警告和错误消息。
sslOptionsRef 对顶级 sslOptions 元素的引用(字符串)。 端点的 SSL 协议选项。 tcpOptionsRef 对顶级 tcpOptions 元素的引用(字符串)。 defaultTCPOptions 端点的 TCP 协议选项。 - pluginConfiguration > httpEndpoint > accessLogging
描述: 端点的 HTTP 访问日志记录配置。必需: false数据类型: 属性名称 数据类型 缺省值 描述 enabled 布尔型 true 启用访问日志记录。 filePath 文件路径 ${server.output.dir}/logs/http_access.log 访问日志文件的目录路径和名称。指定目录路径时可以使用标准变量替换,如 ${server.output.dir}。 logFormat string %h %u %{t}W "%r" %s %b 指定记录客户机访问信息时使用的日志格式。 maxFileSize int 最小值:0
20 回滚之前日志文件的最大大小,以兆字节计;值为 0 意味着无限制。 maxFiles int 最小值:0
2 除去最早的日志文件之前将保留的日志文件的最大数目;值为 0 意味着无限制。
- pluginConfiguration > httpEndpoint > httpOptions
描述: 端点的 HTTP 协议选项。必需: false数据类型: 属性名称 数据类型 缺省值 描述 keepAliveEnabled 布尔型 true 启用持续连接(HTTP 保持活动)。如果为 true,那么连接将保持活动状态,以供多个顺序请求和响应重复使用。如果为 false,那么发送响应之后将关闭连接。 maxKeepAliveRequests int 最小值:-1
100 启用持续连接时,单个 HTTP 连接上允许的最大持续请求数。值为 -1 时意味着不受限制。 persistTimeout 具有秒精度的时间段 30s 将允许套接字在各个请求之间保持空闲的时间量。仅当启用持续连接时,此设置才适用。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 readTimeout 具有秒精度的时间段 60s 发生第一次读取之后,用于等待读请求在套接字上完成的时间量。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 removeServerHeader 布尔型 false 从 HTTP 头除去服务器实现信息,并同时禁用缺省 Liberty 概要文件欢迎页面。 writeTimeout 具有秒精度的时间段 60s 响应数据的每个部分在套接字上等待传输的时间量。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。
- pluginConfiguration > httpEndpoint > sslOptions
描述: 端点的 SSL 协议选项。必需: false数据类型: 属性名称 数据类型 缺省值 描述 sessionTimeout 具有秒精度的时间段 1d 用于等待读或写请求在套接字上完成的时间量。特定于协议的超时将覆盖此值。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 sslRef string 缺省 SSL 配置指令表。缺省值为 defaultSSLSettings。 suppressHandshakeErrors 布尔型 false 禁用记录 SSL 握手错误。SSL 握手错误会在正常操作期间发生,但是当 SSL 行为异常时,这些消息将很有用。
- pluginConfiguration > httpEndpoint > tcpOptions
描述: 端点的 TCP 协议选项。必需: false数据类型: 属性名称 数据类型 缺省值 描述 inactivityTimeout 具有毫秒精度的时间段 60s 用于等待读或写请求在套接字上完成的时间量。特定于协议的超时将覆盖此值。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 soReuseAddr 布尔型 true 允许立即重新绑定到没有任何处于活动状态的侦听器的端口。
- tcpOptions
- 定义 TCP 协议设置。
属性名称 数据类型 缺省值 描述 id 字符串 唯一配置标识。 inactivityTimeout 具有毫秒精度的时间段 60s 用于等待读或写请求在套接字上完成的时间量。特定于协议的超时将覆盖此值。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 soReuseAddr 布尔型 true 允许立即重新绑定到没有任何处于活动状态的侦听器的端口。 - virtualHost
- 虚拟主机将提供用于将 Web 应用程序配置为特定主机名的逻辑分组。缺省虚拟主机 (default_host) 适合于大多数简单配置。
属性名称 数据类型 缺省值 描述 allowFromEndpointRef 对顶级 httpEndpoint 元素的引用的列表(以逗号分隔的字符串)。 指定一个或多个 HTTP 端点的标识以将此虚拟主机的入站流量限制为所指定的端点。 enabled 布尔型 true 启用此虚拟主机。 id 字符串 唯一配置标识。 - virtualHost > allowFromEndpoint
描述: 指定一个或多个 HTTP 端点的标识以将此虚拟主机的入站流量限制为所指定的端点。必需: false数据类型: 属性名称 数据类型 缺省值 描述 accessLoggingRef 对顶级 httpAccessLogging 元素的引用(字符串)。 端点的 HTTP 访问日志记录配置。 enabled 布尔型 true 切换端点的可用性。值为 true 时,分派器将激活此端点以处理 HTTP 请求。 host string localhost 客户机用于请求资源的 IP 地址、带域名后缀的域名服务器 (DNS) 主机名,或仅 DNS 主机名。使用“*”可表示所有可用网络接口。 httpOptionsRef 对顶级 httpOptions 元素的引用(字符串)。 defaultHttpOptions 端点的 HTTP 协议选项。 httpPort int 最小值:-1
最大值:65535
用于客户机 HTTP 请求的端口。使用 -1 可禁用此端口。 httpsPort int 最小值:-1
最大值:65535
用于使用 SSL (https) 保护的客户机 HTTP 请求的端口。使用 -1 可禁用此端口。 id 字符串 唯一配置标识。 onError - IGNORE
- FAIL
- WARN
WARN 启动端点失败时要执行的操作。 - IGNORE
- 服务器在发生配置错误时将不会发出警告和错误消息。
- FAIL
- 服务器在第一次发生错误时将发出警告或错误消息,然后停止服务器。
- WARN
- 服务器在发生配置错误时将发出警告和错误消息。
sslOptionsRef 对顶级 sslOptions 元素的引用(字符串)。 端点的 SSL 协议选项。 tcpOptionsRef 对顶级 tcpOptions 元素的引用(字符串)。 defaultTCPOptions 端点的 TCP 协议选项。 - virtualHost > allowFromEndpoint > accessLogging
描述: 端点的 HTTP 访问日志记录配置。必需: false数据类型: 属性名称 数据类型 缺省值 描述 enabled 布尔型 true 启用访问日志记录。 filePath 文件路径 ${server.output.dir}/logs/http_access.log 访问日志文件的目录路径和名称。指定目录路径时可以使用标准变量替换,如 ${server.output.dir}。 logFormat string %h %u %{t}W "%r" %s %b 指定记录客户机访问信息时使用的日志格式。 maxFileSize int 最小值:0
20 回滚之前日志文件的最大大小,以兆字节计;值为 0 意味着无限制。 maxFiles int 最小值:0
2 除去最早的日志文件之前将保留的日志文件的最大数目;值为 0 意味着无限制。
- virtualHost > allowFromEndpoint > httpOptions
描述: 端点的 HTTP 协议选项。必需: false数据类型: 属性名称 数据类型 缺省值 描述 keepAliveEnabled 布尔型 true 启用持续连接(HTTP 保持活动)。如果为 true,那么连接将保持活动状态,以供多个顺序请求和响应重复使用。如果为 false,那么发送响应之后将关闭连接。 maxKeepAliveRequests int 最小值:-1
100 启用持续连接时,单个 HTTP 连接上允许的最大持续请求数。值为 -1 时意味着不受限制。 persistTimeout 具有秒精度的时间段 30s 将允许套接字在各个请求之间保持空闲的时间量。仅当启用持续连接时,此设置才适用。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 readTimeout 具有秒精度的时间段 60s 发生第一次读取之后,用于等待读请求在套接字上完成的时间量。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 removeServerHeader 布尔型 false 从 HTTP 头除去服务器实现信息,并同时禁用缺省 Liberty 概要文件欢迎页面。 writeTimeout 具有秒精度的时间段 60s 响应数据的每个部分在套接字上等待传输的时间量。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。
- virtualHost > allowFromEndpoint > sslOptions
描述: 端点的 SSL 协议选项。必需: false数据类型: 属性名称 数据类型 缺省值 描述 sessionTimeout 具有秒精度的时间段 1d 用于等待读或写请求在套接字上完成的时间量。特定于协议的超时将覆盖此值。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 sslRef string 缺省 SSL 配置指令表。缺省值为 defaultSSLSettings。 suppressHandshakeErrors 布尔型 false 禁用记录 SSL 握手错误。SSL 握手错误会在正常操作期间发生,但是当 SSL 行为异常时,这些消息将很有用。
- virtualHost > allowFromEndpoint > tcpOptions
描述: 端点的 TCP 协议选项。必需: false数据类型: 属性名称 数据类型 缺省值 描述 inactivityTimeout 具有毫秒精度的时间段 60s 用于等待读或写请求在套接字上完成的时间量。特定于协议的超时将覆盖此值。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 soReuseAddr 布尔型 true 允许立即重新绑定到没有任何处于活动状态的侦听器的端口。
- webApplication
- 定义 Web 应用程序的属性。
属性名称 数据类型 缺省值 描述 autoStart 布尔型 true 指示服务器是否自动启动应用程序。 contextRoot string 应用程序的上下文根。 id 字符串 唯一配置标识。 location 文件、目录或 URL。 应用程序的位置,表示为绝对路径或相对于服务器级应用程序目录的路径。 name string 应用程序的名称。 suppressUncoveredHttpMethodWarning 布尔型 false 指示在应用程序部署期间阻止未覆盖 HTTP 方法警告消息的选项。 - webApplication > application-bnd
描述: 将应用程序中包括的常规部署信息绑定到特定资源。必需: false数据类型: 属性名称 数据类型 缺省值 描述 version string 应用程序绑定规范的版本。 - webApplication > application-bnd > security-role
描述: 唯一配置标识。必需: false数据类型: 属性名称 数据类型 缺省值 描述 id 字符串 唯一配置标识。 name string 安全角色的名称。 - webApplication > application-bnd > security-role > group
描述: 唯一配置标识。必需: false数据类型: 属性名称 数据类型 缺省值 描述 access-id string 组访问标识 id 字符串 唯一配置标识。 name string 拥有安全角色的组的名称。
- webApplication > application-bnd > security-role > run-as
描述: 唯一配置标识。必需: false数据类型: 属性名称 数据类型 缺省值 描述 id 字符串 唯一配置标识。 password 可逆向编码的密码(字符串) 从一个 Bean 访问另一个 Bean 时需要的用户密码。可采用明文或编码格式存储该值。要对该密码进行编码,请将 securityUtility 工具与编码选项配合使用。 userid string 从一个 Bean 访问另一个 Bean 时需要的用户标识。
- webApplication > classloader
描述: 定义应用程序类装入器的设置。必需: false数据类型: 属性名称 数据类型 缺省值 描述 apiTypeVisibility string spec,ibm-api,api 此类装入器将能够看到的 API 包的类型,其格式为下列项的任何组合的逗号分隔列表:规范、ibm-api、api 和第三方。 classProviderRef 对顶级 resourceAdapter 元素的引用的列表(以逗号分隔的字符串)。 类提供程序引用的列表。当搜索类或资源时,此类装入器将在搜索其自己的类路径之后授权给指定的类提供程序。 commonLibraryRef 对顶级 library 元素的引用的列表(以逗号分隔的字符串)。 库引用的列表。库类实例是与其他类装入器共享的。 delegation - parentFirst
- parentLast
parentFirst 控制父类装入器是用在此类装入器之前还是之后。如果选择“父代最先”,那么在搜索类路径之前,授权给直接父代。如果选择“父代最后”,那么在授权给直接父代之前,搜索类路径。 - parentFirst
- 父代最先
- parentLast
- 父代最后
privateLibraryRef 对顶级 library 元素的引用的列表(以逗号分隔的字符串)。 库引用的列表。库类实例是此类装入器特有的,与来自其他类装入器的类实例无关。 - webApplication > classloader > commonLibrary
描述: 库引用的列表。库类实例是与其他类装入器共享的。必需: false数据类型: 属性名称 数据类型 缺省值 描述 apiTypeVisibility string spec,ibm-api,api 此库的类装入器将能够看到的 API 包的类型,其格式为下列项的任何组合的逗号分隔列表:规范、ibm-api、api 和第三方。 description string 管理员的共享库的描述 filesetRef 对顶级 fileset 元素的引用的列表(以逗号分隔的字符串)。 所引用文件集的标识 id 字符串 唯一配置标识。 name string 管理员的共享库的名称 - webApplication > classloader > commonLibrary > file
描述: 所引用文件的标识必需: false数据类型: 属性名称 数据类型 缺省值 描述 id 字符串 唯一配置标识。 name 文件路径 标准文件名
- webApplication > classloader > commonLibrary > fileset
描述: 所引用文件集的标识必需: false数据类型: 属性名称 数据类型 缺省值 描述 caseSensitive 布尔型 true 指示搜索是否应区分大小写的布尔值(缺省值:true)。 dir 目录路径 ${server.config.dir} 用于搜索文件的基本目录。 excludes string 要排除在搜索结果以外的文件名模式的逗号或空格分隔列表,缺省情况下不排除任何文件。 id 字符串 唯一配置标识。 includes string * 要包含在搜索结果中的文件名模式的逗号或空格分隔列表(缺省值:*)。 scanInterval 具有毫秒精度的时间段 0 检查文件集更改的扫描时间间隔,格式为长整形加上时间单位后缀(h 表示小时、m 表示分钟、s 表示秒、ms 表示毫秒),例如,2ms 或 5s。缺省情况下为禁用 (scanInterval=0)。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
- webApplication > classloader > privateLibrary
描述: 库引用的列表。库类实例是此类装入器特有的,与来自其他类装入器的类实例无关。必需: false数据类型: 属性名称 数据类型 缺省值 描述 apiTypeVisibility string spec,ibm-api,api 此库的类装入器将能够看到的 API 包的类型,其格式为下列项的任何组合的逗号分隔列表:规范、ibm-api、api 和第三方。 description string 管理员的共享库的描述 filesetRef 对顶级 fileset 元素的引用的列表(以逗号分隔的字符串)。 所引用文件集的标识 id 字符串 唯一配置标识。 name string 管理员的共享库的名称 - webApplication > classloader > privateLibrary > file
描述: 所引用文件的标识必需: false数据类型: 属性名称 数据类型 缺省值 描述 id 字符串 唯一配置标识。 name 文件路径 标准文件名
- webApplication > classloader > privateLibrary > fileset
描述: 所引用文件集的标识必需: false数据类型: 属性名称 数据类型 缺省值 描述 caseSensitive 布尔型 true 指示搜索是否应区分大小写的布尔值(缺省值:true)。 dir 目录路径 ${server.config.dir} 用于搜索文件的基本目录。 excludes string 要排除在搜索结果以外的文件名模式的逗号或空格分隔列表,缺省情况下不排除任何文件。 id 字符串 唯一配置标识。 includes string * 要包含在搜索结果中的文件名模式的逗号或空格分隔列表(缺省值:*)。 scanInterval 具有毫秒精度的时间段 0 检查文件集更改的扫描时间间隔,格式为长整形加上时间单位后缀(h 表示小时、m 表示分钟、s 表示秒、ms 表示毫秒),例如,2ms 或 5s。缺省情况下为禁用 (scanInterval=0)。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
- webContainer
- Web 容器的配置。
属性名称 数据类型 缺省值 描述 allowExpressionFactoryPerApp 布尔型 false 切换以装入该应用程序设置的 ExpressionFactory。如果您要使用的定制 EL 实现(例如,JUEL)需要设置自己 ExpressionFactory,请启用此定制属性。 allowIncludeSendError 布尔型 false 允许 RequestDispatch 在 Include 方法上发送错误。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.allowincludesenderror。 asyncMaxSizeTaskPool 整形 5000 自动清除已取消的任务之前异步任务池中任务的最大大小。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.asyncmaxsizetaskpool。 asyncPurgeInterval 整形 30000 在每次对已取消的任务池进行必需清除之间要等待的时间间隔。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.asyncpurgeinterval。 asyncTimeoutDefault 整形 30000 尚未显式指定超时值时使用的异步 servlet 超时值。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.asynctimeoutdefault。 asyncTimerThreads 整形 2 要用于异步 servlet 超时处理的最大线程数。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.asynctimerthreads。 channelWriteType string async 设置为“sync”时,将以同步方式写入响应;否则,将以异步方式写入响应。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.channelwritetype。 copyAttributesKeySet 布尔型 false Web 容器将属性列表副本的枚举返回至 servlet,以避免该 servlet 发生并行存取错误。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.copyattributeskeyset。 decodeUrlAsUtf8 布尔型 true 使用编码设置 UTF-8 对 URL 解码。 decodeUrlPlusSign 布尔型 false 当 URL 中包含加号时对加号进行解码。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.decodeurlplussign。 defaultHeadRequestBehavior 布尔型 false 恢复当 HEAD 请求不受限于为 GET 方法定义的安全性约束时的行为。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.DefaultHeadRequestBehavior。 defaultTraceRequestBehavior 布尔型 false 恢复 HTTP TRACE 处理。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.DefaultTraceRequestBehavior。 deferServletLoad 布尔型 true 将 servlet 装入和初始化延迟至第一次请求。 deferServletRequestListenerDestroyOnError 布尔型 false 如果希望在处理请求出错时延迟 ServletRequestListener 破坏,那么进行切换。缺省值为 false。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.deferServletRequestListenerDestroyOnError。 directoryBrowsingEnabled 布尔型 false 启用应用程序的目录浏览。 disableXPoweredBy 布尔型 false 禁止设置 X-Powered-By 头。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.disablexpoweredby。 disallowAllFileServing 布尔型 false 禁用通过应用程序进行的所有文件服务。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.disallowAllFileServing。 disallowServeServletsByClassName 布尔型 true 禁止在应用程序服务器级别上使用 serveServletsByClassnameEnabled。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.disallowserveservletsbyclassname。 dispatcherRethrowsEr 布尔型 true Web 容器将重新抛出错误,从而允许相关资源处理这些错误。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.dispatcherRethrowser。 doNotServeByClassName string 要完全禁止按类名提供的以分号分隔的类列表。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.donotservebyclassname。 emptyServletMappings 布尔型 false 当未添加 Servlet 映射时,如您想要返回空的集合,而不是返回 null,那么进行切换。缺省值为 false。完整应用程序服务器概要文件中等价的定制属性为 com.ibm.ws.webcontainer.emptyservletmappings。 enableDefaultIsElIgnoredInTag 布尔型 false 始终评估是否忽略标记文件中的 EL 表达式。如果父 JSP 文件有不同 isELIgnored 设置,那么将对标记文件中的该设置重新求值。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.jsp.enabledefaultiselignoredintag。 enableErrorExceptionTypeFirst 布尔型 false 已将 Web 容器更新为在错误代码之前搜索和使用异常类型。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.enableErrorExceptionTypeFirst。 enableJspMappingOverride 布尔型 false 允许覆盖 JSP 映射,以便应用程序可自行提供 JSP 内容。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.enablejspmappingoverride。 enableMultiReadOfPostData 布尔型 false 保留 POST 数据以用于多次读访问。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.enablemultireadofpostdata。 exposeWebInfOnDispatch 布尔型 false 如果为 true,那么 servlet 可以访问 WEB-INF 目录中的文件。如果为 false(缺省值),那么 servlet 无法访问 WEB-INF 目录中的文件。 fileServingEnabled 布尔型 true 如果没有为应用程序显式指定此设置,那么启用文件服务。 fileWrapperEvents 布尔型 false 提供静态文件时,Web 容器将生成 SMF 和 PMI 数据。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.fileWrapperEvents。 httpsIndicatorHeader string 对于 SSL 卸载,设置为由 SSL 加速器/代理/负载均衡器插入的 HTTP 头变量的名称。 ignoreSemiColonOnRedirectToWelcomePage 布尔型 false 切换到在重定向至欢迎页面时忽略尾随分号。缺省值为 false。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.ignoreSemiColonOnRedirectToWelcomePage。 ignoreSessiononStaticFileRequest 布尔型 false 阻止 Web 容器访问涉及过滤器的静态文件请求的会话,从而改进性能。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.IgnoreSessiononStaticFileRequest。 invokeFilterInitAtStartup 布尔型 true Web 容器将在应用程序启动时调用过滤器的 init() 方法。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.invokeFilterInitAtStartup。 listeners string 侦听器类的以逗号分隔的列表。 logServletContainerInitializerClassLoadingErrors 布尔型 false 将 servlet 容器类装入错误记录为警告,而非仅在启用调试时记录这些错误。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.logservletcontainerinitializerclassloadingerrors。 metaInfResourcesCacheSize 整形 20 meta-inf 资源高速缓存的初始大小(条目数)。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.metainfresourcescachesize.name。 parseUtf8PostData 布尔型 false Web 容器将检测非 URL 编码的 UTF-8 POST 数据,并将其包括在参数值中。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.parseutf8postdata。 serveServletsByClassnameEnabled 布尔型 false 如果未显式指定,那么将支持使用类名在 Web 应用程序中访问 servlet。 setContentLengthOnClose 布尔型 true 切换以在应用程序显式结束响应时设置内容长度。缺省值为 true;但是,如果应用程序响应包含双字节字符,请将此值设置为 false。 skipMetaInfResourcesProcessing 布尔型 false 不在 meta-inf 目录中搜索应用程序资源。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.skipmetainfresourcesprocessing。 suppressHtmlRecursiveErrorOutput 布尔型 false 如果存在应用程序所配置的错误页无法处理的递归错误,那么禁止异常信息出现在 HTML 输出中。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.suppressHtmlRecursiveErrorOutput。 symbolicLinksCacheSize 整形 1000 符号链接高速缓存的初始大小。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.SymbolicLinksCacheSize。 tolerateSymbolicLinks 布尔型 false 使 Web 容器能够支持使用符号链接。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.TolerateSymbolicLinks。 useSemiColonAsDelimiterInURI 布尔型 false 切换到使用分号作为请求 URI 中的定界符。缺省值为 false。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.useSemiColonAsDelimiterInURI。 xPoweredBy string X-Powered-By 头设置的备用字符串。完整应用程序服务器概要文件中的等效定制属性为 com.ibm.ws.webcontainer.xpoweredby。此属性没有缺省值。如果未设置此属性,那么 X-Powered-By 头的值按 Servlet 规范的定义设置为 Servlet/<servlet spec version>。