资源适配器 (resourceAdapter)

autoStart

布尔型

配置资源适配器的启动方式是在其部署时自动启动，还是在注入或查找资源时缓慢启动。

classloaderRef

对顶级 classloader 元素的引用（字符串）。

定义应用程序类装入器的设置。

id

字符串

唯一配置标识。

location

文件、目录或 URL。
Required

定义要安装的 RAR 文件的路径。

useJandex

布尔型

如果应用程序中提供了 Jandex 索引文件，那么启用使用 Jandex 索引文件

id

字符串

唯一配置标识。

name

string

提供作用域仅限于应用程序的属性的名称。

value

string

提供作用域仅限于应用程序的属性的值。

apiTypeVisibility

string

spec,ibm-api,api,stable

该类装入器支持的 API 包的类型。此值是下列 API 包的任意组合的逗号分隔列表：spec、ibm-api、api、stable 和第三方。如果对 API 类型添加了前缀 + 或 -，那么会将这些 API 类型添加至缺省 API 类型集合，或者从缺省 API 类型集合中移除这些 API 类型。通常使用前缀 +third-party 将生成“spec, ibm-api, api, stable, third-party”。使用前缀 -api 将生成“spec, ibm-api, stable”。

classProviderRef

对顶级 resourceAdapter 元素的引用的列表（以逗号分隔的字符串）。

类提供程序引用的列表。当搜索类或资源时，此类装入器将在搜索其自己的类路径之后授权给指定的类提供程序。

commonLibraryRef

对顶级 library 元素的引用的列表（以逗号分隔的字符串）。

库引用的列表。库类实例是与其他类装入器共享的。

delegation

parentFirst

控制父类装入器是用在此类装入器之前还是之后。如果选择“父代最先”，那么在搜索类路径之前，授权给直接父代。如果选择“父代最后”，那么在授权给直接父代之前，搜索类路径。
parentFirst
父代最先
parentLast
父代最后

privateLibraryRef

对顶级 library 元素的引用的列表（以逗号分隔的字符串）。

库引用的列表。库类实例是此类装入器特有的，与来自其他类装入器的类实例无关。

autoStart

布尔型

配置资源适配器的启动方式是在其部署时自动启动，还是在注入或查找资源时缓慢启动。

classloaderRef

对顶级 classloader 元素的引用（字符串）。

定义应用程序类装入器的设置。

id

字符串

唯一配置标识。

location

文件、目录或 URL。
Required

定义要安装的 RAR 文件的路径。

useJandex

布尔型

如果应用程序中提供了 Jandex 索引文件，那么启用使用 Jandex 索引文件

id

字符串

唯一配置标识。

name

string

提供作用域仅限于应用程序的属性的名称。

value

string

提供作用域仅限于应用程序的属性的值。

implementation

string

标准实现类名，应该针对该类名定制配置属性元素。

interface

string

标准接口类名，应该针对该类名定制配置属性元素。

suffix

string

覆盖配置属性元素的缺省后缀。例如，properties.rarModule1.CustomConnectionFactory 中的“CustomConnectionFactory”。当资源适配器提供了多种类型的连接工厂、受管对象或端点激活时，该后缀对于进行区别很有用。如果配置属性元素定制省略该后缀或将它保留为空白，那么不会使用后缀。

auto-encode-requests

布尔型

确定是否自动对请求进行编码。

auto-encode-responses

布尔型

确定是否自动对响应进行编码。

autoload-filters

布尔型

确定是否自动装入过滤器。

context-root

string

定义 Web 应用程序的上下文根。

default-error-page

string

指定要用作 Web 应用程序的缺省错误页的页面。

enable-directory-browsing

布尔型

指定是否为此 Web 应用程序启用目录浏览。

enable-file-serving

布尔型

指定是否为此 Web 应用程序启用文件处理。

enable-serving-servlets-by-class-name

布尔型

按类名启用处理 servlet。

moduleName

string

模块名称指定绑定或扩展配置应用于的单个模块。

pre-compile-jsps

布尔型

指定 Web 应用程序启动时是否编译 JSP 页面。

id

字符串

唯一配置标识。

name

string

属性名称。

value

string

属性值。

id

字符串

唯一配置标识。

name

string

属性名称。

value

string

属性值。

id

字符串

唯一配置标识。

name

string

属性名称。

value

string

属性值。

id

字符串

唯一配置标识。

mime-type

string

MIME 过滤器的类型。

target

string

MIME 过滤器的目标。

branch-coupling

指定是使用松散还是紧密耦合。

commit-priority

整形

0

定义资源引用的落实优先级。

id

字符串

唯一配置标识。

isolation-level

定义事务隔离级别。

name

string

资源引用的名称。

context-root

string

上下文根属性用来指定基于 EJB 的 JAX-WS 应用程序的 EJB 模块的上下文根。

id

字符串

唯一配置标识。

auth-method

string

授权方法用来配置 Web 应用程序的认证机制。

realm-name

string

域名元素指定要在 HTTP 基本授权中使用的域名

form-error-page

string

form-error-page 元素定义 Web 应用程序中可以找到的在登录不成功时所显示的错误页面所在的位置。路径以 / 开始，并解释为相对于 WAR 的根目录的路径。

form-login-page

string

表单登录页面元素定义 Web 应用程序中可以找到可用于登录的页面所在的位置。路径以 / 开始，并解释为相对于 WAR 的根目录的路径。

role-name

string
asChild.

授权约束的角色名称应该与部署描述符中所定义的安全角色的角色名称相对应。

transport-guarantee

整形

传输保证指定客户机之间如何通信并且应该进行通信。如果值为 INTEGRAL，那么应用程序要求在传输过程中不应更改。如果值为 CONFIDENTIAL，那么数据在传输过程中应该保密。如果值为 NONE，那么表明没有传输保证。

http-method

string

指定要将安全性约束应用于的 HTTP 方法

http-method-omission

string

指定不应该将安全性约束应用于的 HTTP 方法

id

字符串

唯一配置标识。

url-pattern

string

URL 模式用来标识 Web 资源集合中的一组资源。

web-resource-name

string

Web 资源集合的名称

role-name

string

授权约束的角色名称应该与部署描述符中所定义的安全角色的角色名称相对应。

component-name

string

如果在 EJB 模块中使用了服务引用，那么组件名称属性用来指定 EJB Bean 名称。

id

字符串

唯一配置标识。

name

string

名称属性用来指定 Web Service 引用的名称。

port-address

string

如果所引用的 Web Service 只有一个端口，那么端口地址属性用来指定 Web Service 端口的地址。

wsdl-location

string

WSDL 位置属性用来指定要覆盖的 WSDL 位置的 URL。

address

string

地址属性用来指定 Web Service 端口的地址，它将覆盖在 service-ref 元素中定义的 port-address 属性的值。

id

字符串

唯一配置标识。

key-alias

string

密钥别名属性用来指定客户机证书的别名。如果未指定该属性，并且 Web Service 提供程序支持客户机证书，那么密钥库中的第一个证书将用作此属性的值。该属性还可以覆盖在 server.xml 文件的 ssl 元素中定义的 clientKeyAlias 属性。

name

string

端口名用来指定 Web Service 端口的名称。

namespace

string

名称空间属性用来指定 Web Service 端口的名称空间。会将绑定应用于具有相同名称和名称空间的端口。否则，会将绑定应用于具有相同名称的端口。

password

可逆向编码的密码（字符串）

密码属性用来指定用于基本认证的密码。可以对密码进行编码。

ssl-ref

string

SSL 引用属性是指 server.xml 文件中所定义的 SSL 元素。如果未指定此属性，但是服务器支持传输级别安全性，那么服务客户机将使用缺省 SSL 配置。

username

string

用户名属性用来指定用于基本认证的用户名。

address

string

地址用来指定服务端点的被覆盖地址。

id

字符串

唯一配置标识。

port-component-name

string

端口组件名称用来指定端口组件的名称。

id

字符串

唯一配置标识。

apiTypeVisibility

string

spec,ibm-api,api,stable

该类装入器支持的 API 包的类型。此值是下列 API 包的任意组合的逗号分隔列表：spec、ibm-api、api、stable 和第三方。

description

string

管理员的共享库的描述

filesetRef

对顶级 fileset 元素的引用的列表（以逗号分隔的字符串）。

所引用文件集的标识

id

字符串

唯一配置标识。

name

string

管理员的共享库的名称

id

字符串

唯一配置标识。

name

文件路径
Required

标准文件名

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 秒。

dir

目录路径
Required

要包含在用于定位资源文件的库类路径中的目录或文件夹

id

字符串

唯一配置标识。

apiTypeVisibility

string

spec,ibm-api,api,stable

该类装入器支持的 API 包的类型。此值是下列 API 包的任意组合的逗号分隔列表：spec、ibm-api、api、stable 和第三方。

description

string

管理员的共享库的描述

filesetRef

对顶级 fileset 元素的引用的列表（以逗号分隔的字符串）。

所引用文件集的标识

id

字符串

唯一配置标识。

name

string

管理员的共享库的名称

id

字符串

唯一配置标识。

name

文件路径
Required

标准文件名

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 秒。

dir

目录路径
Required

要包含在用于定位资源文件的库类路径中的目录或文件夹

id

字符串

唯一配置标识。

implementation

string

标准实现类名，应该针对该类名定制配置属性元素。

interface

string

标准接口类名，应该针对该类名定制配置属性元素。

suffix

string

覆盖配置属性元素的缺省后缀。例如，properties.rarModule1.CustomConnectionFactory 中的“CustomConnectionFactory”。当资源适配器提供了多种类型的连接工厂、受管对象或端点激活时，该后缀对于进行区别很有用。如果配置属性元素定制省略该后缀或将它保留为空白，那么不会使用后缀。

auto-encode-requests

布尔型

确定是否自动对请求进行编码。

auto-encode-responses

布尔型

确定是否自动对响应进行编码。

autoload-filters

布尔型

确定是否自动装入过滤器。

context-root

string

定义 Web 应用程序的上下文根。

default-error-page

string

指定要用作 Web 应用程序的缺省错误页的页面。

enable-directory-browsing

布尔型

指定是否为此 Web 应用程序启用目录浏览。

enable-file-serving

布尔型

指定是否为此 Web 应用程序启用文件处理。

enable-serving-servlets-by-class-name

布尔型

按类名启用处理 servlet。

moduleName

string

模块名称指定绑定或扩展配置应用于的单个模块。

pre-compile-jsps

布尔型

指定 Web 应用程序启动时是否编译 JSP 页面。

id

字符串

唯一配置标识。

name

string

属性名称。

value

string

属性值。

id

字符串

唯一配置标识。

name

string

属性名称。

value

string

属性值。

id

字符串

唯一配置标识。

name

string

属性名称。

value

string

属性值。

id

字符串

唯一配置标识。

mime-type

string

MIME 过滤器的类型。

target

string

MIME 过滤器的目标。

branch-coupling

指定是使用松散还是紧密耦合。

commit-priority

整形

0

定义资源引用的落实优先级。

id

字符串

唯一配置标识。

isolation-level

定义事务隔离级别。

name

string

资源引用的名称。

context-root

string

上下文根属性用来指定基于 EJB 的 JAX-WS 应用程序的 EJB 模块的上下文根。

id

字符串

唯一配置标识。

auth-method

string

授权方法用来配置 Web 应用程序的认证机制。

realm-name

string

域名元素指定要在 HTTP 基本授权中使用的域名

form-error-page

string

form-error-page 元素定义 Web 应用程序中可以找到的在登录不成功时所显示的错误页面所在的位置。路径以 / 开始，并解释为相对于 WAR 的根目录的路径。

form-login-page

string

表单登录页面元素定义 Web 应用程序中可以找到可用于登录的页面所在的位置。路径以 / 开始，并解释为相对于 WAR 的根目录的路径。

role-name

string
asChild.

授权约束的角色名称应该与部署描述符中所定义的安全角色的角色名称相对应。

transport-guarantee

整形

传输保证指定客户机之间如何通信并且应该进行通信。如果值为 INTEGRAL，那么应用程序要求在传输过程中不应更改。如果值为 CONFIDENTIAL，那么数据在传输过程中应该保密。如果值为 NONE，那么表明没有传输保证。

http-method

string

指定要将安全性约束应用于的 HTTP 方法

http-method-omission

string

指定不应该将安全性约束应用于的 HTTP 方法

id

字符串

唯一配置标识。

url-pattern

string

URL 模式用来标识 Web 资源集合中的一组资源。

web-resource-name

string

Web 资源集合的名称

role-name

string

授权约束的角色名称应该与部署描述符中所定义的安全角色的角色名称相对应。

component-name

string

如果在 EJB 模块中使用了服务引用，那么组件名称属性用来指定 EJB Bean 名称。

id

字符串

唯一配置标识。

name

string

名称属性用来指定 Web Service 引用的名称。

port-address

string

如果所引用的 Web Service 只有一个端口，那么端口地址属性用来指定 Web Service 端口的地址。

wsdl-location

string

WSDL 位置属性用来指定要覆盖的 WSDL 位置的 URL。

address

string

地址属性用来指定 Web Service 端口的地址，它将覆盖在 service-ref 元素中定义的 port-address 属性的值。

id

字符串

唯一配置标识。

key-alias

string

密钥别名属性用来指定客户机证书的别名。如果未指定该属性，并且 Web Service 提供程序支持客户机证书，那么密钥库中的第一个证书将用作此属性的值。该属性还可以覆盖在 server.xml 文件的 ssl 元素中定义的 clientKeyAlias 属性。

name

string

端口名用来指定 Web Service 端口的名称。

namespace

string

名称空间属性用来指定 Web Service 端口的名称空间。会将绑定应用于具有相同名称和名称空间的端口。否则，会将绑定应用于具有相同名称的端口。

password

可逆向编码的密码（字符串）

密码属性用来指定用于基本认证的密码。可以对密码进行编码。

ssl-ref

string

SSL 引用属性是指 server.xml 文件中所定义的 SSL 元素。如果未指定此属性，但是服务器支持传输级别安全性，那么服务客户机将使用缺省 SSL 配置。

username

string

用户名属性用来指定用于基本认证的用户名。

address

string

地址用来指定服务端点的被覆盖地址。

id

字符串

唯一配置标识。

port-component-name

string

端口组件名称用来指定端口组件的名称。

id

字符串

唯一配置标识。