4.4.3. キュー管理操作
管理 API を使用してキューを管理できます。
コア管理 API はキューを処理します。QueueControlクラスは、キューの管理操作を定義します (ObjectName,org.apache.activemq.artemis:broker="<broker-name>",component=addresses,address="<bound-address>",subcomponent=queues,routing-type="<routing-type>",queue="<queue-name>" またはリソース名queue.<queue-name>を使用)。
キューの管理操作のほとんどは、単一のメッセージ ID (単一のメッセージを削除するなど) またはフィルター (指定のプロパティーですべてのメッセージを期限切れにするなど) を取ります。
- 期限切れで、デッドレターアドレスに送信し、メッセージの移動
expireMessages()メソッドを使用して、キューのメッセージを失効させます。期限切れアドレスが定義されている場合、メッセージはそのアドレスに送信されます。それ以外のメッセージは破棄されます。キューの有効期限アドレスは、setExpiryAddress（）メソッドで設定できます。sendMessagesToDeadLetterAddress（）メソッドを使用して、デッドレターアドレスにメッセージを送信します。デッドレターアドレスに送信されるメッセージの数を返します。デッドレターアドレスが定義されていない場合、メッセージはキューから削除され、破棄されます。キューのデッドレターアドレスはsetDeadLetterAddress（）メソッドで設定できます。moveMessages（）メソッドを使用して、メッセージをあるキューから別のキューに移動します。- メッセージの一覧表示と削除
listMessages()メソッドを使用して、あるキューからメッセージを一覧表示します。Mapの配列 (各メッセージに対して1つのMap) を返します。removeMessages()メソッドを使用してキューからメッセージを削除します。これは、単一のメッセージ ID バリアントのboolean、またはフィルターバリアントの削除されたメッセージの数を返します。このメソッドは、filter引数を取り、フィルターされたメッセージのみを削除します。フィルターを空の文字列に設定すると、すべてのメッセージが削除されます。- メッセージのカウント
-
キューに入っているメッセージの数は、
getMessageCount()メソッドで返されます。または、countMessages()は指定のフィルターに一致するキュー内のメッセージの数を返します。 - メッセージの優先度の変更
-
メッセージの優先度は、単一のメッセージIDバリアントの
booleanまたはフィルターバリアントの更新されたメッセージの数を返すchangeMessagesPriority()メソッドを使用して変更できます。 - メッセージカウンター
-
メッセージカウンタは、
listMessageCounter()およびlistMessageCounterHistory()メソッドを使用して、キューに対して一覧表示することができます（「メッセージカウンターの使用」を参照）。メッセージカウンターは、resetMessageCounter()メソッドを使って、1つのキューに対してリセットすることもできます。 - キュー属性の取得
-
QueueControlは、属性を使用してキュー設定を公開します（たとえば、キューのフィルターが作成されている場合はこれを取得するためにgetFilter()を使用、キューが永続的かどうかを知るためにはisDurable()を使用など）。 - キューの一時停止および再開
-
QueueControlは、基礎となるキューを一時停止したり、再開したりすることができます。キューが一時停止すると、メッセージは受信されますが、配信されません。再開すると、キューに格納されたメッセージの配信を開始します (存在する場合)。
