JMX API 的變更
Message Queue 支援 Java Management Extensions (JMX) API，可從 Message Queue 用戶端應用程式以程式設計方式配置及監視代理程式功能。Message Queue 4.2 包含 JMX API 的延伸，以支援發行版本中的新特性與功能。下列 Mbean 已定義新的 JMX 屬性、作業及/或查找鍵值：
ConsumerManager 監視 MBean
下表中的屬性、作業與查找鍵值支援發佈程式或訂閱者的多個目標中所述的功能。
下列屬性的名稱已定義為公用程式類別 com.sun.messaging.jms.management.server.ConsumerAttributes 中的靜態常數。
表 1–11 ConsumerManager 監視屬性|
名稱 |
類型 |
可否設定？ |
說明 |
|---|---|---|---|
|
NumWildcardConsumers |
Integer |
否 |
與代理程式相關的萬用字元訊息用戶數 |
下列作業的名稱已定義為公用程式類別 com.sun.messaging.jms.management.server.ConsumerOperations 中的靜態常數。
表 1–12 ConsumerManager 監視作業|
名稱 |
參數 |
結果類型 |
說明 |
|---|---|---|---|
|
getConsumerWildcards |
無 |
String[] |
與代理程式相關之目前用戶所使用的萬用字元字串 |
|
getNumWildcardConsumers |
萬用字元字串 |
Integer |
使用指定之萬用字元字串且與代理程式相關的目前用戶數 |
下列查找鍵值已定義為公用程式類別 com.sun.messaging.jms.management.server.ConsumerInfo 中的靜態常數。
表 1–13 訊息用戶資訊的查找鍵值|
名稱 |
值類型 |
說明 |
|---|---|---|
|
DestinationNames |
String[] |
符合萬用字元用戶所使用之萬用字元的目標名稱 僅限主題目標。 |
|
Wildcard |
Boolean |
是否為萬用字元用戶？ 僅限主題目標。 |
目標配置 MBean
下表中的屬性支援XML 有效負載訊息的模式驗證中所述的功能。
下列屬性的名稱已定義為公用程式類別 com.sun.messaging.jms.management.server.DestinationAttributes 中的靜態常數。
表 1–14 目標配置屬性|
名稱 |
類型 |
可否設定？ |
說明 |
|---|---|---|---|
|
ValidateXMLSchemaEnabled |
Boolean |
是 |
是否啟用 XML 模式驗證？ 若設定為 false 或未設定，則目標不會啟用 XML 模式驗證。 |
|
XMLSchemaURIList |
String |
是 |
以空格分隔的 XML 模式文件 (XSD) URI 字串清單 這些 URI 指向 XML 模式驗證 (若已啟用) 所使用的一或多個 XSD 位置。 若指定多個 URI，請使用雙引號括住此值。 範例： “http://foo/flap.xsd http://test.com/test.xsd” 若此特性未設定或為空值，且已啟用 XML 驗證，則會使用 XML 文件中指定的 DTD 執行 XML 驗證。 |
|
ReloadXMLSchemaOnFailure |
Boolean |
是 |
是否啟用 [失敗時重新載入 XML 模式]？ 若設定為 False 或未設定，則驗證失敗時不會重新載入模式。 |
目標管理員配置 MBean
上述的新目標配置 MBean 屬性支援新功能XML 有效負載訊息的模式驗證，其用途在於使用目標管理員配置 MBean 的 create 作業建立目標。
目標監視 MBean
下表中的第一組屬性支援發佈程式或訂閱者的多個目標中所述的功能，而第二組屬性支援新的目標度量中所述的增強功能。
下列屬性的名稱已定義為公用程式類別 com.sun.messaging.jms.management.server.DestinationAttributes 中的靜態常數。
表 1–15 目標監視屬性|
名稱 |
類型 |
可否設定？ |
說明 |
|---|---|---|---|
|
NumWildcards |
Integer |
否 |
與目標相關之萬用字元訊息產生器及萬用字元訊息用戶目前的數目 僅限主題目標。 |
|
NumWildcardProducers |
Integer |
否 |
與目標相關之萬用字元訊息產生器目前的數目 僅限主題目標。 |
|
NumWildcardConsumers |
Integer |
否 |
與目標相關之萬用字元訊息用戶目前的數目 僅限主題目標。 |
|
NumMsgsRemote |
Long |
否 |
產生至叢集中遠端代理程式且目前儲存在記憶體與永久存放區中的訊息數。此數目不包含作業事件中的訊息。 |
|
TotalMsgBytesRemote |
Long |
否 |
產生至叢集中遠端代理程式且目前儲存在記憶體與永久存放區中的訊息總大小 (位元組數)。此值不包含作業事件中的訊息。 |
下表中的作業支援發佈程式或訂閱者的多個目標中所述的功能。
下列作業的名稱已定義為公用程式類別 com.sun.messaging.jms.management.server.DestinationOperations 中的靜態常數。
表 1–16 目標監視作業|
名稱 |
參數 |
結果類型 |
說明 |
|---|---|---|---|
|
getWildcards |
無 |
String[] |
與目標相關之目前用戶與產生器所使用的萬用字元字串 僅限主題目標。 |
|
getConsumerWildcards |
無 |
String[] |
與目標相關之目前用戶所使用的萬用字元字串 僅限主題目標。 |
|
getProducerWildcards |
無 |
String[] |
與目標相關之目前產生器所使用的萬用字元字串 僅限主題目標。 |
|
getNumWildcardConsumers |
萬用字元字串 |
Integer |
使用指定萬用字元字串且與目標相關的目前用戶數 僅限主題目標。 |
|
getNumWildcardProducers |
萬用字元字串 |
Integer |
使用指定萬用字元字串且與目標相關的目前產生器數 僅限主題目標。 |
ProducerManager 監視 MBean
下表中的屬性、作業與查找鍵值支援發佈程式或訂閱者的多個目標中所述的功能。
下列屬性的名稱已定義為公用程式類別 com.sun.messaging.jms.management.server.ProducerAttributes 中的靜態常數。
表 1–17 ProducerManager 監視屬性|
名稱 |
類型 |
可否設定？ |
說明 |
|---|---|---|---|
|
NumWildcardProducers |
Integer |
否 |
與代理程式相關的萬用字元訊息產生器數 |
下列作業的名稱已定義為公用程式類別 com.sun.messaging.jms.management.server.ProducerOperations 中的靜態常數。
表 1–18 ProducerManager 監視作業|
名稱 |
參數 |
結果類型 |
說明 |
|---|---|---|---|
|
getProducerWildcards |
無 |
String[] |
與代理程式相關之目前產生器所使用的萬用字元字串 |
|
getNumWildcardProducers |
萬用字元字串 |
Integer |
使用指定萬用字元字串且與代理程式相關的目前產生器數 |
下列查找鍵值已定義為公用程式類別 com.sun.messaging.jms.management.server.ProducerInfo 中的靜態常數。
表 1–19 訊息產生器的查找鍵值資訊|
名稱 |
值類型 |
說明 |
|---|---|---|
|
DestinationNames |
String[] |
符合萬用字元產生器所使用之萬用字元的目標名稱 僅限主題目標。 |
|
Wildcard |
Boolean |
是否為萬用字元產生器？ 僅限主題目標。 |
- © 2010, Oracle Corporation and/or its affiliates