6.4. 管理操作

可以使用 getQueueNames（） 方法来检索部署队列的列表。

可使用管理操作 createQueue（）、deployQueue（） 或 destroyQueue（） 在 ActiveMQServerControl （通过 ObjectName org.apache. SLES.artemis:broker="BROKER_NAME" 或 resource name server）上创建或销毁队列。

如果队列已存在，则 createQueue 将失败，而 deployQueue 将不执行任何操作。

使用 listRemoteAddresses（） 检索客户端的远程地址。也可以使用 closeConnectionsForAddress（） 方法关闭与远程地址关联的连接。

另外，也可使用 listConnectionIDs（） 列出连接 ID，并使用 listSessions（） 列出给定连接 ID 的所有会话。

如果代理崩溃，在代理重启时，一些事务可能需要手动干预。使用以下方法帮助您解决问题。

使用 listPreparedTransactions（） 方法列表，列出处于准备状态（事务代表为 opaque Base64 Strings）的事务。

使用 commitPreparedTransaction（） 或 rollbackPreparedTransaction（） 提交或回滚给定事务，以解决 heuristic 事务。

使用 listHeuristicCommittedTransactions（） 和 listHeuristicRolledBackTransactions 方法列出 Heuristicly 完成交易。

使用 enableMessageCounters（） 或 disableMessageCounters（） 方法启用和禁用消息计数器。

使用 resetAllMessageCounters（） 和 resetAllMessageCounterHistories（） 方法重置消息计数器。

列出部署的 Core Bridge，并分别使用 getBridgeNames（） 和 getDivertNames（） 方法。

使用网桥创建或销毁，并使用 createBridge（） 和 destroyBridge（） 或 createDivert（） 在 ActiveMQServerControl （通过 ObjectName org.apache.clusterNetwork.artemis:broker="BROKER_NAME" 或 resource name server）上的 createDivert（）和 destroyDivert（）。

使用 ActiveMQServerControl 上的 forceFailover（） （使用 ObjectName org.apache.activemq.artemis:broker="BROKER_NAME" 或 resource name server）

使用 expireMessages（） 方法使来自队列的消息过期。如果定义了到期地址，则会将消息发送到此地址，否则会被丢弃。您可以在 broker.xml 配置文件的 address-settings 元素中定义地址的到期地址（从而使队列绑定到这些地址）。例如，请参阅了解 default 代理配置中的 "默认消息地址设置"部分。

使用 sendMessagesToDeadLetterAddress（） 方法发送消息到死信地址。此方法返回发送到死信地址的消息数量。如果定义了死信地址，则会将消息发送到此地址，否则它们将从队列中删除并丢弃。您可以在 broker.xml 配置文件的 address-settings 元素中为地址 或一组 地址定义死信地址（因此绑定到这些地址的队列）。例如，请参阅了解 default 代理配置中的 "默认消息地址设置"部分。

使用 moveMessages（） 方法将消息从一个队列移到另一个队列。

使用 listMessages（） 方法列出来自队列的消息。它将返回一系列 映射，每个消息都有一个 映射。

使用 removeMessages（） 方法删除队列的消息，这将为单一消息 ID 变体或过滤器变体删除消息的数量返回 布尔值。这个方法采用 过滤器 参数来只删除过滤的消息。将过滤器设置为空字符串将影响所有消息。