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。

下表列出了頂層元素及其對應的帶點名稱字首。

元素名稱	帶點名稱字首
應用程式	`domain.applications`
resources	`domain.resources`
配置	`domain.configs`
伺服器	`domain.servers` 此元素中包含的每個伺服器均可做為 server-name 進行存取。其中，server-name 是伺服器子元素的名稱屬性值。
叢集	`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.resources.*`	`domain.resources.*`	該別名解析為由`目標`參照的所有 `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 指令

asadmin get、set 與 list 指令共同為 Application Server 的抽象階層提供瀏覽機制。共有兩種階層：配置和監視，且這些指令適用於兩者。list 指令提供管理元件 (具有唯讀或可修改的屬性) 之完全合格的帶點名稱。

配置階層提供可修改的屬性；而來自監視階層的管理元件只有唯讀屬性。配置階層並非嚴格基於網域的模式文件。使用 list 指令以存取所要階層中的特定管理元件。接著，呼叫 get 與 set 指令以取得管理元件屬性的名稱與值，或設定管理元件屬性的值。使用萬用字元 (*) 選項可擷取符合指定之完全合格帶點名稱中的所有項目。如需使用 get、set 與 list 指令的範例，請參閱以下線上手冊：

get(1)

set(1)

list(1)