public interface QueueBrowser extends AutoCloseableSE
QueueBrowser
オブジェクトを使用して、キューのメッセージを削除せずに調べます。getEnumeration
メソッドは、キューのメッセージをスキャンするために使用される java.util.Enumeration
を返します。キューのコンテンツ全体の列挙である場合もあれば、メッセージセレクターに一致するメッセージのみが含まれている場合もあります。
スキャンの実行中にメッセージが到着して期限切れになる場合があります。Jakarta Messaging API では、列挙型のコンテンツがキューコンテンツの静的スナップショットである必要はありません。これらの変更が表示されるかどうかは、JMS プロバイダーによって異なります。
QueueBrowser
は、配信時間に達する前にメッセージを返してはなりません。
QueueBrowser
は、Session
または QueueSession
のいずれかから作成できます。
Session.createBrowser(jakarta.jms.Queue)
, QueueSession.createBrowser(jakarta.jms.Queue)
, QueueReceiver
修飾子と型 | メソッドと説明 |
---|---|
void | close() QueueBrowser を閉じます。 |
EnumerationSE | getEnumeration() 受信される順序で現在のキューメッセージを参照するための列挙を取得します。 |
StringSE | getMessageSelector() このキューブラウザーのメッセージセレクタ式を取得します。 |
Queue | getQueue() このキューブラウザーに関連付けられているキューを取得します。 |
Queue getQueue() throws JMSException
JMSException
- 内部エラーが原因で Jakarta Messaging プロバイダーがこのブラウザーに関連付けられたキューを取得できない場合。StringSE getMessageSelector() throws JMSException
JMSException
- 内部エラーのために Jakarta Messaging プロバイダーがこのブラウザーのメッセージセレクターを取得できない場合。EnumerationSE getEnumeration() throws JMSException
JMSException
- 内部エラーが原因で Jakarta Messaging プロバイダーがこのブラウザーの列挙を取得できない場合。void close() throws JMSException
QueueBrowser
を閉じます。プロバイダーは、Java 仮想マシンの外部で QueueBrowser に代わって一部のリソースを割り当てる可能性があるため、クライアントは、必要のないときに閉じる必要があります。最終的にこれらのリソースを再利用するためにガベージコレクションに依存することは、タイムリーではない場合があります。
AutoCloseableSE
の closeSE
JMSException
- 内部エラーが原因で Jakarta Messaging プロバイダーがこのブラウザーを閉じることができない場合。Copyright © 2018,2020 Eclipse Foundation.
Use is subject to license terms.