Sun Java System Application Server Enterprise Edition 8.2 管理指南

第 18 章 domain.xml 的带点名称属性

本附录介绍了可用于描述 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` 引用的所有 j`dbc-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 命令

asadmin get、set 和 list 命令串联使用可以为 Application Server 的抽象分层结构提供导航机制。存在两个分层结构：配置和监视，可以针对它们运行这些命令。list 命令可提供具有只读或可修改属性的管理组件的全限定带点名称。

配置分层结构提供可修改的属性；而监视分层结构中的管理组件的属性完全为只读属性。配置分层结构并不严格基于域的模式文档。使用 list 命令可以访问所需域中的特定管理组件。随后，调用 get 和 set 命令可以获取管理组件的属性的名称和值，或设置这些属性的值。使用通配符 (*) 选项可以获取给定全限定带点名称中的所有匹配。有关 get、set 和 list 命令的使用示例，请参见以下手册页：

get(1)

set(1)

list(1)