附錄 C
domain.xml 的含點名稱屬性
本附錄介紹可用於描述 Mbean 及其屬性的含點名稱屬性。domain.xml
檔案中的每個元素都有對應的 MBean。由於使用這些名稱的語法是利用句點來分隔名稱,所以這些名稱稱為「含點名稱」。
本附錄包含下列主題:
頂層元素
domain.xml 檔案中的所有頂層元素都必須遵循以下條件:
- 每個伺服器、配置、叢集或節點代理程式的名稱都必須是唯一的。
- 伺服器、配置、叢集或節點代理程式無法命名為「網域」。
- 伺服器實例可命名為「代理程式」。
下表列出了頂層元素及其對應的含點名稱字首。
表 C-1 頂層元素
元素名稱
|
含點名稱字首
|
應用程式
|
domain.applications
|
資源
|
domain.resources
|
配置
|
domain.configs
|
伺服器
|
domain.servers
該元素包含的所有伺服器都可以作為 server-name 進行存取。其中,server-name 是伺服器子元素的名稱屬性值。
|
叢集
|
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。