JMX API 更改
Message Queue 支持 Java Management Extensions (JMX) API，以便在 Message Queue 客户端应用程序中以编程方式来配置和监视代理函数。Message Queue 4.2 包含 JMX API 扩展以支持此发行版中的新增功能。对于以下 MBean，为其定义了新的 JMX 属性、操作和/或查找关键字：
使用方管理器监视 MBean
以下各表中的属性、操作和查找关键字支持为发布者或订阅者提供多个目的地中所述的功能。
在实用程序类 com.sun.messaging.jms.management.server.ConsumerAttributes 中，将以下属性的名称定义为静态常量。
表 1–11 使用方管理器监视属性|
名称 |
类型 |
是否可设置？ |
描述 |
|---|---|---|---|
|
NumWildcardConsumers |
Integer |
否 |
与代理关联的通配符消息使用方数 |
在实用程序类 com.sun.messaging.jms.management.server.ConsumerOperations 中，将以下操作的名称定义为静态常量。
表 1–12 使用方管理器监视操作|
名称 |
参数 |
结果类型 |
描述 |
|---|---|---|---|
|
getConsumerWildcards |
无 |
String[] |
与代理关联的当前使用方使用的通配符字符串 |
|
getNumWildcardConsumers |
wildcard-String |
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" 如果未设置此属性或将其设置为 null，并且启用了 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 |
wildcard-String |
Integer |
与目的地关联且使用指定通配符字符串的当前使用方数 仅适用于主题目的地。 |
|
getNumWildcardProducers |
wildcard-String |
Integer |
与目的地关联且使用指定通配符字符串的当前生成方数 仅适用于主题目的地。 |
生成方管理器监视 MBean
以下各表中的属性、操作和查找关键字支持为发布者或订阅者提供多个目的地中所述的功能。
在实用程序类 com.sun.messaging.jms.management.server.ProducerAttributes 中，将以下属性的名称定义为静态常量。
表 1–17 生成方管理器监视属性|
名称 |
类型 |
是否可设置？ |
描述 |
|---|---|---|---|
|
NumWildcardProducers |
Integer |
否 |
与代理关联的通配符消息生成方数 |
在实用程序类 com.sun.messaging.jms.management.server.ProducerOperations 中，将以下操作的名称定义为静态常量。
表 1–18 生成方管理器监视操作|
名称 |
参数 |
结果类型 |
描述 |
|---|---|---|---|
|
getProducerWildcards |
无 |
String[] |
与代理关联的当前生成方使用的通配符字符串 |
|
getNumWildcardProducers |
wildcard-String |
Integer |
与代理关联且使用指定通配符字符串的当前生成方数 |
在实用程序类 com.sun.messaging.jms.management.server.ProducerInfo 中，将以下查找关键字定义为静态常量。
表 1–19 消息生成方信息的查找关键字|
名称 |
值类型 |
描述 |
|---|---|---|
|
DestinationNames |
String[] |
与通配符生成方使用的通配符匹配的目的地名称 仅适用于主题目的地。 |
|
Wildcard |
Boolean |
是否为通配符生成方？ 仅适用于主题目的地。 |
- © 2010, Oracle Corporation and/or its affiliates