企业应用程序 (enterpriseApplication)
定义企业应用程序的属性。
| 属性名称 | 数据类型 | 缺省值 | 描述 |
|---|---|---|---|
| autoStart | 布尔型 | true | 指示服务器是否自动启动应用程序。 |
| defaultClientModule | string | 企业应用程序的缺省客户机模块。 | |
| id | string | 唯一配置标识。 | |
| location | 文件、目录或 URL。 | 应用程序的位置,表示为绝对路径或相对于服务器级应用程序目录的路径。 | |
| 名称 | string | 应用程序的名称。 | |
| suppressUncoveredHttpMethodWarning | 布尔型 | False | 指示在应用程序部署期间阻止未覆盖 HTTP 方法警告消息的选项。 |
- application-bnd
描述: 将应用程序中包括的常规部署信息绑定到特定资源。必需: False数据类型: 属性名称 数据类型 缺省值 描述 版本 string 应用程序绑定规范的版本。 - application-bnd > security-role
描述: 唯一配置标识。必需: False数据类型: 属性名称 数据类型 缺省值 描述 id string 唯一配置标识。 名称 string 安全角色的名称。 - application-bnd > security-role > group
描述: 唯一配置标识。必需: False数据类型: 属性名称 数据类型 缺省值 描述 access-id string 组访问标识 id string 唯一配置标识。 名称 string 拥有安全角色的组的名称。
- application-bnd > security-role > run-as
描述: 唯一配置标识。必需: False数据类型: 属性名称 数据类型 缺省值 描述 id string 唯一配置标识。 password 可逆向编码的密码(字符串) 从一个 Bean 访问另一个 Bean 时需要的用户密码。可以采用明文或编码格式存储该值。要对该密码进行编码,请将 securityUtility 工具与编码选项配合使用。 userid string 从一个 Bean 访问另一个 Bean 时需要的用户标识。
- classloader
描述: 定义应用程序类装入器的设置。必需: False数据类型: 属性名称 数据类型 缺省值 描述 apiTypeVisibility string spec、ibm-api 和 api 此类装入器将能够看到的 API 包的类型,格式为下列项的任何组合的逗号分隔列表:spec、ibm-api、spi 和 third-party。 classProviderRef 顶级 resourceAdapter 元素的引用列表(以逗号分隔的字符串)。 类提供者引用的列表。搜索类或资源时,此类装入器将在搜索其自己的类路径之后授权给指定的类提供者。 commonLibraryRef 顶级库元素的引用列表(以逗号分隔的字符串)。 库引用的列表。会与其他类装入器共享库类实例。 delegation - parentFirst
- parentLast
parentFirst 控制父类装入器是用在此类装入器之前还是之后。如果选择“父代最先”,那么在搜索类路径之前,授权给直接父代。如果选择“父代最后”,那么在授权给直接父代之前,搜索类路径。 - parentFirst
- 父代最先
- parentLast
- 父代最后
privateLibraryRef 顶级库元素的引用列表(以逗号分隔的字符串)。 库引用的列表。库类实例是此类装入器特有的,与来自其他类装入器的类实例无关。 - classloader > commonLibrary
描述: 库引用的列表。会与其他类装入器共享库类实例。必需: False数据类型: 属性名称 数据类型 缺省值 描述 apiTypeVisibility string spec、ibm-api 和 api 此库的类装入器将能够看到的 API 包的类型,格式为下列项的任何组合的逗号分隔列表:spec、ibm-api、spi 和 third-party。 description string 管理员的共享库的描述 filesetRef 顶级文件集元素的引用列表(以逗号分隔的字符串)。 所引用文件集的标识 id string 唯一配置标识。 名称 string 管理员的共享库的名称 - classloader > commonLibrary > file
描述: 所引用文件的标识必需: False数据类型: 属性名称 数据类型 缺省值 描述 id string 唯一配置标识。 名称 文件路径 标准文件名
- classloader > commonLibrary > fileset
描述: 所引用文件集的标识必需: False数据类型: 属性名称 数据类型 缺省值 描述 caseSensitive 布尔型 true 用于指示搜索是否应该区分大小写的布尔值(缺省值:true)。 dir 目录路径 ${server.config.dir} 用于搜索文件的基本目录。 excludes string 要从搜索结果中排除的文件名模式的逗号或空格分隔列表,缺省情况下不排除任何文件。 id string 唯一配置标识。 includes string * 要包括在搜索结果中的文件名模式的逗号或空格分隔列表(缺省值:*)。 scanInterval 具有毫秒精度的时间段 0 检查文件集更改的扫描时间间隔,格式为长整型加上时间单位后缀(h 表示小时,m 表示分钟,s 表示秒,ms 表示毫秒),例如 2ms 或 5s。缺省情况下为已禁用 (scanInterval=0)。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,将 500 毫秒指定为 500ms。可以将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
- classloader > privateLibrary
描述: 库引用的列表。库类实例是此类装入器特有的,与来自其他类装入器的类实例无关。必需: False数据类型: 属性名称 数据类型 缺省值 描述 apiTypeVisibility string spec、ibm-api 和 api 此库的类装入器将能够看到的 API 包的类型,格式为下列项的任何组合的逗号分隔列表:spec、ibm-api、spi 和 third-party。 description string 管理员的共享库的描述 filesetRef 顶级文件集元素的引用列表(以逗号分隔的字符串)。 所引用文件集的标识 id string 唯一配置标识。 名称 string 管理员的共享库的名称 - classloader > privateLibrary > file
描述: 所引用文件的标识必需: False数据类型: 属性名称 数据类型 缺省值 描述 id string 唯一配置标识。 名称 文件路径 标准文件名
- classloader > privateLibrary > fileset
描述: 所引用文件集的标识必需: False数据类型: 属性名称 数据类型 缺省值 描述 caseSensitive 布尔型 true 用于指示搜索是否应该区分大小写的布尔值(缺省值:true)。 dir 目录路径 ${server.config.dir} 用于搜索文件的基本目录。 excludes string 要从搜索结果中排除的文件名模式的逗号或空格分隔列表,缺省情况下不排除任何文件。 id string 唯一配置标识。 includes string * 要包括在搜索结果中的文件名模式的逗号或空格分隔列表(缺省值:*)。 scanInterval 具有毫秒精度的时间段 0 检查文件集更改的扫描时间间隔,格式为长整型加上时间单位后缀(h 表示小时,m 表示分钟,s 表示秒,ms 表示毫秒),例如 2ms 或 5s。缺省情况下为已禁用 (scanInterval=0)。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,将 500 毫秒指定为 500ms。可以将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
- resourceAdapter
描述: 为嵌入在应用程序中的资源适配器指定配置。必需: False数据类型: 属性名称 数据类型 缺省值 描述 alias string ${id} 覆盖资源适配器的缺省标识。该标识用于资源适配器的配置属性元素的名称中,该名称转而用于为由资源适配器提供的任何资源确定配置属性元素的名称。资源适配器的配置属性元素名称具有 properties.<APP_NAME>.<ALIAS> 格式,其中 <APP_NAME> 是应用程序的名称,<ALIAS> 是所配置别名。如果未指定,那么别名缺省为资源适配器的模块名称。 autoStart 布尔型 配置资源适配器的启动方式是在其部署时自动启动,还是在注入或查找资源时缓慢启动。 contextServiceRef 对顶级 contextService 元素的引用(字符串)。 配置上下文捕获及传播至线程的方式。 id string 确定此配置适用的嵌入式资源适配器模块的名称。 - resourceAdapter > contextService
描述: 配置上下文捕获及传播至线程的方式。必需: False数据类型: 属性名称 数据类型 缺省值 描述 baseContextRef 对顶级 contextService 元素的引用(字符串)。 指定从其继承上下文的基本上下文服务(尚未在此上下文服务上定义此上下文)。 jndiName string JNDI 名称 onError - IGNORE
- FAIL
- WARN
WARN 确定用于对配置错误作出响应的操作。例如,如果为此 contextService 配置了 securityContext,但未启用安全性功能,那么 onError 会确定是使错误配置部分失效、针对其发出警告还是将其忽略。 - IGNORE
- 服务器在引发配置错误时将不会发出任何警告和错误消息。
- FAIL
- 服务器在第一次发生错误时将发出警告或错误消息,然后停止服务器。
- WARN
- 服务器在引发配置错误时将发出警告和错误消息。
- resourceAdapter > contextService > baseContext
描述: 指定从其继承上下文的基本上下文服务(尚未在此上下文服务上定义此上下文)。必需: False数据类型: 属性名称 数据类型 缺省值 描述 baseContextRef 对顶级 contextService 元素的引用(字符串)。 指定从其继承上下文的基本上下文服务(尚未在此上下文服务上定义此上下文)。 id string 唯一配置标识。 jndiName string JNDI 名称 onError - IGNORE
- FAIL
- WARN
WARN 确定用于对配置错误作出响应的操作。例如,如果为此 contextService 配置了 securityContext,但未启用安全性功能,那么 onError 会确定是使错误配置部分失效、针对其发出警告还是将其忽略。 - IGNORE
- 服务器在引发配置错误时将不会发出任何警告和错误消息。
- FAIL
- 服务器在第一次发生错误时将发出警告或错误消息,然后停止服务器。
- WARN
- 服务器在引发配置错误时将发出警告和错误消息。
- resourceAdapter > contextService > baseContext > baseContext
描述: 指定从其继承上下文的基本上下文服务(尚未在此上下文服务上定义此上下文)。必需: False数据类型: com.ibm.ws.context.service-factory
- resourceAdapter > contextService > baseContext > jeeMetadataContext
描述: 使提交上下文任务的应用程序组件的名称空间可用于该任务。必需: False数据类型:
- resourceAdapter > contextService > baseContext > securityContext
描述: 指定了此属性时,会将工作发起方的安全上下文传播至工作单元。必需: False数据类型:
- resourceAdapter > contextService > baseContext > syncToOSThreadContext
描述: 指定了此属性时,工作单元的 runAs 主体集的身份会与操作系统身份同步。必需: False数据类型:
- 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 上下文(如果存在 WLM 上下文)。
- PropagateOrNew
- 使用同一 WLM 上下文,或者创建新的 WLM 上下文(如果当前不存在上下文)。
- New
- 始终创建新的 WLM 上下文。
- resourceAdapter > contextService > syncToOSThreadContext
描述: 指定了此属性时,工作单元的 runAs 主体集的身份会与操作系统身份同步。必需: False数据类型:
- 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 上下文(如果存在 WLM 上下文)。
- PropagateOrNew
- 使用同一 WLM 上下文,或者创建新的 WLM 上下文(如果当前不存在上下文)。
- New
- 始终创建新的 WLM 上下文。
- resourceAdapter > customize
描述: 定制具有指定接口和/或实现类的激活规范、受管对象或连接工厂的配置属性元素。必需: False数据类型: 属性名称 数据类型 缺省值 描述 实现 string 标准实现类名,应该针对该类名定制配置属性元素。 interface string 标准接口类名,应该针对该类名定制配置属性元素。 suffix string 覆盖配置属性元素的缺省后缀。例如,properties.rarModule1.CustomConnectionFactory 中的“CustomConnectionFactory”。当资源适配器提供了多种类型的连接工厂、受管对象或端点激活时,该后缀对于进行区别很有用。如果配置属性元素定制省略该后缀或将它保留为空白,那么不会使用后缀。
参考主题