附录 C
domain.xml 的带点名称属性
本附录介绍了可用于描述 Mbean 及其属性的带点名称属性。domain.xml
文件中的每个元素都有相应的 MBean。由于用于使用这些名称的语法涉及使用句点来分隔名称,因此这些名称被称为“带点名称”。
本附录包括以下主题:
顶层元素
domain.xml 文件中的所有顶层元素都必须满足以下条件:
- 每个服务器、配置、群集或节点代理的名称都必须是唯一的。
- 不能将服务器、配置、群集或节点代理命名为“domain”。
- 不能将服务器实例命名为“agent”。
下表列出了顶层元素及其相应的带点名称前缀。
表 C-1 顶层元素
元素名
|
带点名称前缀
|
applications
|
domain.applications
|
resources
|
domain.resources
|
configurations
|
domain.configs
|
servers
|
domain.servers
该元素包含的所有服务器都可以作为 server-name 被访问。其中,server-name 是服务器子元素的名称属性值。
|
clusters
|
domain.clusters
该元素包含的所有群集都可以作为 cluster-name 被访问。其中,cluster-name 是群集子元素的名称属性值。
|
node-agents
|
domain.note-agents
|
lb-configs
|
domain.lb-configs
|
system-property
|
domain.system-property
|
有两个可用的别名级别:
- 利用第一级别的别名可以访问服务器实例或群集的属性而不必通过 domain.servers 或 domain.clusters 前缀。因此,举例来说,形式为“server1”的带点名称将映射到带点名称 domain.servers.server1(其中 server1 为服务器实例)。
- 第二级别的别名用于表示群集或独立服务器实例(目标)的配置、应用程序和资源。
下表列出了以服务器名称或群集名称开头的带点名称,这些带点名称被别名化为域下的顶层名称:
表 C-2 域下的带点名称服务器名称
带点的名称
|
别名化为
|
说明
|
target.applications.*
|
domain.applications.*
|
该别名将解析为仅由目标引用的应用程序。
|
target.resources.*
|
domain.resources.*
|
该别名将解析为由目标引用的所有 jdbc-connection-pool 、connector-connection-pool 、resource-adapter-config 和所有其他资源。
|
下表列出了以服务器名称或群集名称开头的带点名称,这些带点名称在服务器或群集所引用的配置中被别名化的顶层名称。
表 C-3 服务器或群集引用的配置的带点名称
带点的名称
|
别名化为
|
target.http-service
|
config-name.http-service
|
target.iiop-service
|
config-name.iiop-service
|
target.admin-service
|
config-name.admin-service
|
target.web-container
|
config-name.web-container
|
target.ejb-container
|
config-name.ejb-container
|
target.mdb-container
|
config-name.mdb-container
|
target.jms-service
|
config-name.jms-service
|
target.log-service
|
config-name.log-service
|
target.security-service
|
config-name.security-service
|
target.transaction-service
|
config-name.transaction-service
|
target.monitoring-service
|
config-name.monitoring-service
|
target.java-config
|
config-name.java-config
|
target.availability-service
|
config-name.availability-service
|
target.thread-pools
|
config-name.thread-pools
|
不能别名化的元素
不应对群集实例进行别名化。要获得群集实例的系统属性,应按以下方法使用带点名称属性:domain.servers.clustered-instance-name.system-property,而不是 clustered-instance-name.system-property。