本附录介绍了可用于描述 MBean 及其属性的带点名称属性。domain.xml 文件中的每个元素都有相应的 MBean。由于用于使用这些名称的语法涉及使用句点来分隔名称,因此这些名称被称为带点名称。
*(星号)可以用于带点名称中的任意位置,它的作用与正则表达式中的通配符类似。使用通配符的好处是它可以折叠带点名称的所有部分。例如,可以将 this.is.really.long.hierarchy 之类的长带点名称缩写为 th*.hierarchy。不过,. 始终用于分隔名称的各部分。* 将使您获得带点名称的整个列表。
本附录包括以下主题:
domain.xml 文件中的所有顶层元素都必须满足以下条件:
每个服务器、配置、群集或节点代理的名称都必须是唯一的。
不能将服务器、配置、群集或节点代理命名为 domain。
不能将服务器实例命名为 agent。
下表列出了顶层元素及其相应的带点名称前缀。
元素名 |
带点名称前缀 |
---|---|
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.node-agents |
lb-configs |
domain.lb-configs |
system-property |
domain.system-property |
有两个可用的别名级别:
利用第一级别的别名可以访问服务器实例或群集的属性而不必通过 domain.servers 或 domain.clusters 前缀。因此,举例来说,形式为 server1 的带点名称将映射到带点名称 domain.servers.server1(其中,server1 是服务器实例)。
第二级别的别名用于表示群集或独立服务器实例(目标)的配置、应用程序和资源。
下表列出了以服务器名称或群集名称开头的带点名称,这些带点名称被别名化为域下的顶层名称:
带点名称 |
别名化为 |
注释 |
---|---|---|
target.applications.* |
domain.applications.* |
该别名将解析为仅由 target 引用的应用程序。 |
target.resources.* |
domain.resources.* |
该别名将解析为由 target 引用的所有 jdbc-connection-pool、connector-connection-pool、resource-adapter-config 和所有其他资源。 |
下表列出了以服务器名称或群集名称开头的带点名称,这些带点名称在服务器或群集所引用的配置中被别名化的顶层名称。
带点名称 |
别名化为 |
---|---|
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。
asadmin get、set 和 list 命令串联使用可以为 Application Server 的抽象分层结构提供导航机制。存在两个分层结构:配置和监视,可以针对它们运行这些命令。list 命令可提供具有只读或可修改属性的管理组件的全限定带点名称。
配置分层结构提供可修改的属性;而监视分层结构中的管理组件的属性完全为只读属性。配置分层结构并不严格基于域的模式文档。使用 list 命令可以访问所需域中的特定管理组件。随后,调用 get 和 set 命令可以获取管理组件的属性的名称和值,或设置这些属性的值。使用通配符 (*) 选项可以获取给定全限定带点名称中的所有匹配。有关 get、set 和 list 命令的使用示例,请参见以下手册页: