インターフェース JmsOperations
- すべての既知の実装クラス:
JmsTemplate
JmsTemplate
によって実装されます。頻繁に使用されることはありませんが、簡単にモック化またはスタブ化できるため、テスト容易性を高めるための有用なオプションです。
さまざまな JMSAPI メソッドをミラーリングする JmsTemplate's
send(..)
、receive(..)
メソッドを提供します。これらのメソッドの詳細については、JMS 仕様と javadoc を参照してください。
一時キューを使用して応答を収集する基本的なリクエスト応答操作も提供します。
- 導入:
- 1.1
- 作成者:
- Mark Pollack, Juergen Hoeller, Stephane Nicoll
- 関連事項:
メソッドのサマリー
修飾子と型メソッド説明<T> T
browse
(QueueEE queue, BrowserCallback<T> action) JMS キュー内のメッセージを参照します。<T> T
browse
(StringSE queueName, BrowserCallback<T> action) JMS キュー内のメッセージを参照します。<T> T
browse
(BrowserCallback<T> action) デフォルトの JMS キュー内のメッセージを参照します。<T> T
browseSelected
(QueueEE queue, StringSE messageSelector, BrowserCallback<T> action) JMS キュー内の選択されたメッセージを参照します。<T> T
browseSelected
(StringSE queueName, StringSE messageSelector, BrowserCallback<T> action) JMS キュー内の選択されたメッセージを参照します。<T> T
browseSelected
(StringSE messageSelector, BrowserCallback<T> action) JMS キュー内の選択されたメッセージを参照します。void
convertAndSend
(DestinationEE destination, ObjectSE message) 指定されたオブジェクトを指定された宛先に送信し、MessageConverter が構成された JMS メッセージにオブジェクトを変換します。void
convertAndSend
(DestinationEE destination, ObjectSE message, MessagePostProcessor postProcessor) 指定されたオブジェクトを指定された宛先に送信し、MessageConverter が構成された JMS メッセージにオブジェクトを変換します。void
convertAndSend
(ObjectSE message) 指定されたオブジェクトをデフォルトの宛先に送信し、オブジェクトを MessageConverter が構成された JMS メッセージに変換します。void
convertAndSend
(ObjectSE message, MessagePostProcessor postProcessor) 指定されたオブジェクトをデフォルトの宛先に送信し、オブジェクトを MessageConverter が構成された JMS メッセージに変換します。void
convertAndSend
(StringSE destinationName, ObjectSE message) 指定されたオブジェクトを指定された宛先に送信し、MessageConverter が構成された JMS メッセージにオブジェクトを変換します。void
convertAndSend
(StringSE destinationName, ObjectSE message, MessagePostProcessor postProcessor) 指定されたオブジェクトを指定された宛先に送信し、MessageConverter が構成された JMS メッセージにオブジェクトを変換します。<T> T
execute
(DestinationEE destination, ProducerCallback<T> action) JMS 宛先にメッセージを送信します。<T> T
execute
(StringSE destinationName, ProducerCallback<T> action) JMS 宛先にメッセージを送信します。<T> T
execute
(ProducerCallback<T> action) デフォルトの JMS 宛先(または各送信操作に指定されたもの)にメッセージを送信します。<T> T
execute
(SessionCallback<T> action) JMS セッション内の特定のアクションオブジェクトで指定されたアクションを実行します。receive()
デフォルトの宛先から同期的にメッセージを受信しますが、指定された時間までしか配信を待機しません。receive
(DestinationEE destination) 指定された宛先から同期的にメッセージを受信しますが、指定された時間までしか配信を待機しません。指定された宛先から同期的にメッセージを受信しますが、指定された時間までしか配信を待機しません。デフォルトの宛先から同期的にメッセージを受信しますが、指定された時間までしか配信を待機しません。receiveAndConvert
(DestinationEE destination) 指定された宛先から同期的にメッセージを受信しますが、指定された時間までしか配信を待機しません。receiveAndConvert
(StringSE destinationName) 指定された宛先から同期的にメッセージを受信しますが、指定された時間までしか配信を待機しません。receiveSelected
(DestinationEE destination, StringSE messageSelector) 指定された宛先から同期的にメッセージを受信しますが、指定された時間までしか配信を待機しません。receiveSelected
(StringSE messageSelector) デフォルトの宛先から同期的にメッセージを受信しますが、指定された時間までしか配信を待機しません。receiveSelected
(StringSE destinationName, StringSE messageSelector) 指定された宛先から同期的にメッセージを受信しますが、指定された時間までしか配信を待機しません。receiveSelectedAndConvert
(DestinationEE destination, StringSE messageSelector) 指定された宛先から同期的にメッセージを受信しますが、指定された時間までしか配信を待機しません。receiveSelectedAndConvert
(StringSE messageSelector) デフォルトの宛先から同期的にメッセージを受信しますが、指定された時間までしか配信を待機しません。receiveSelectedAndConvert
(StringSE destinationName, StringSE messageSelector) 指定された宛先から同期的にメッセージを受信しますが、指定された時間までしか配信を待機しません。void
send
(DestinationEE destination, MessageCreator messageCreator) 指定された宛先にメッセージを送信します。void
send
(StringSE destinationName, MessageCreator messageCreator) 指定された宛先にメッセージを送信します。void
send
(MessageCreator messageCreator) デフォルトの宛先にメッセージを送信します。sendAndReceive
(DestinationEE destination, MessageCreator messageCreator) メッセージを送信し、指定された宛先から応答を受信します。sendAndReceive
(StringSE destinationName, MessageCreator messageCreator) メッセージを送信し、指定された宛先から応答を受信します。sendAndReceive
(MessageCreator messageCreator) リクエストメッセージを送信し、デフォルトの宛先から応答を受信します。
メソッドの詳細
execute
JMS セッション内の特定のアクションオブジェクトで指定されたアクションを実行します。- パラメーター:
action
- セッションを公開するコールバックオブジェクト- 戻り値:
- セッションでの作業からの結果オブジェクト
- 例外:
JmsException
- 問題がある場合
execute
デフォルトの JMS 宛先(または各送信操作に指定されたもの)にメッセージを送信します。コールバックは、複雑な送信操作を実行するために、JMS セッションと MessageProducer へのアクセスを提供します。- パラメーター:
action
- セッション / プロデューサーのペアを公開するコールバックオブジェクト- 戻り値:
- セッションでの作業からの結果オブジェクト
- 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました
execute
JMS 宛先にメッセージを送信します。コールバックは、複雑な送信操作を実行するために、JMS セッションと MessageProducer へのアクセスを提供します。- パラメーター:
destination
- メッセージの送信先action
- セッション / プロデューサーのペアを公開するコールバックオブジェクト- 戻り値:
- セッションでの作業からの結果オブジェクト
- 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました
execute
JMS 宛先にメッセージを送信します。コールバックは、複雑な送信操作を実行するために、JMS セッションと MessageProducer へのアクセスを提供します。- パラメーター:
destinationName
- メッセージの送信先の名前 (DestinationResolver によって実際の宛先に解決される)action
- セッション / プロデューサーのペアを公開するコールバックオブジェクト- 戻り値:
- セッションでの作業からの結果オブジェクト
- 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました
send
デフォルトの宛先にメッセージを送信します。これは、デフォルトの宛先が指定されている場合にのみ機能します。
- パラメーター:
messageCreator
- メッセージを作成するためのコールバック- 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました
send
指定された宛先にメッセージを送信します。MessageCreator コールバックは、セッションが指定されたメッセージを作成します。- パラメーター:
destination
- このメッセージの送信先messageCreator
- メッセージを作成するためのコールバック- 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました
send
指定された宛先にメッセージを送信します。MessageCreator コールバックは、セッションが指定されたメッセージを作成します。- パラメーター:
destinationName
- このメッセージの送信先の名前 (DestinationResolver によって実際の宛先に解決される)messageCreator
- メッセージを作成するためのコールバック- 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました
convertAndSend
指定されたオブジェクトをデフォルトの宛先に送信し、オブジェクトを MessageConverter が構成された JMS メッセージに変換します。これは、デフォルトの宛先が指定されている場合にのみ機能します。
- パラメーター:
message
- メッセージに変換するオブジェクト- 例外:
JmsException
- チェック済みの JMSException をチェックなしに変換
convertAndSend
指定されたオブジェクトを指定された宛先に送信し、MessageConverter が構成された JMS メッセージにオブジェクトを変換します。- パラメーター:
destination
- このメッセージの送信先message
- メッセージに変換するオブジェクト- 例外:
JmsException
- チェック済みの JMSException をチェックなしに変換
convertAndSend
指定されたオブジェクトを指定された宛先に送信し、MessageConverter が構成された JMS メッセージにオブジェクトを変換します。- パラメーター:
destinationName
- このメッセージの送信先の名前 (DestinationResolver によって実際の宛先に解決される)message
- メッセージに変換するオブジェクト- 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました
convertAndSend
指定されたオブジェクトをデフォルトの宛先に送信し、オブジェクトを MessageConverter が構成された JMS メッセージに変換します。MessagePostProcessor コールバックでは、変換後にメッセージを変更できます。これは、デフォルトの宛先が指定されている場合にのみ機能します。
- パラメーター:
message
- メッセージに変換するオブジェクトpostProcessor
- メッセージを変更するためのコールバック- 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました
convertAndSend
void convertAndSend(DestinationEE destination, ObjectSE message, MessagePostProcessor postProcessor) throws JmsException 指定されたオブジェクトを指定された宛先に送信し、オブジェクトを MessageConverter が構成された JMS メッセージに変換します。MessagePostProcessor コールバックでは、変換後にメッセージを変更できます。- パラメーター:
destination
- このメッセージの送信先message
- メッセージに変換するオブジェクトpostProcessor
- メッセージを変更するためのコールバック- 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました
convertAndSend
void convertAndSend(StringSE destinationName, ObjectSE message, MessagePostProcessor postProcessor) throws JmsException 指定されたオブジェクトを指定された宛先に送信し、オブジェクトを MessageConverter が構成された JMS メッセージに変換します。MessagePostProcessor コールバックでは、変換後にメッセージを変更できます。- パラメーター:
destinationName
- このメッセージの送信先の名前 (DestinationResolver によって実際の宛先に解決される)message
- メッセージに変換するオブジェクト。postProcessor
- メッセージを変更するためのコールバック- 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました
receive
デフォルトの宛先から同期的にメッセージを受信しますが、指定された時間までしか配信を待機しません。このメソッドは、メッセージが使用可能になるまで、またはタイムアウト値を超えるまでスレッドをブロックするため、慎重に使用する必要があります。
これは、デフォルトの宛先が指定されている場合にのみ機能します。
- 戻り値:
- コンシューマーが受信したメッセージ、またはタイムアウトが期限切れの場合は
null
- 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました
receive
指定された宛先から同期的にメッセージを受信しますが、指定された時間までしか配信を待機しません。このメソッドは、メッセージが使用可能になるまで、またはタイムアウト値を超えるまでスレッドをブロックするため、慎重に使用する必要があります。
- パラメーター:
destination
- メッセージを受け取る宛先- 戻り値:
- コンシューマーが受信したメッセージ、またはタイムアウトが期限切れの場合は
null
- 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました
receive
指定された宛先から同期的にメッセージを受信しますが、指定された時間までしか配信を待機しません。このメソッドは、メッセージが使用可能になるまで、またはタイムアウト値を超えるまでスレッドをブロックするため、慎重に使用する必要があります。
- パラメーター:
destinationName
- このメッセージの送信先の名前 (DestinationResolver によって実際の宛先に解決される)- 戻り値:
- コンシューマーが受信したメッセージ、またはタイムアウトが期限切れの場合は
null
- 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました
receiveSelected
デフォルトの宛先から同期的にメッセージを受信しますが、指定された時間までしか配信を待機しません。このメソッドは、メッセージが使用可能になるまで、またはタイムアウト値を超えるまでスレッドをブロックするため、慎重に使用する必要があります。
これは、デフォルトの宛先が指定されている場合にのみ機能します。
- パラメーター:
messageSelector
- JMS メッセージセレクター式(ない場合はnull
)。セレクター式の詳細な定義については、JMS 仕様を参照してください。- 戻り値:
- コンシューマーが受信したメッセージ、またはタイムアウトが期限切れの場合は
null
- 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました
receiveSelected
@Nullable MessageEE receiveSelected(DestinationEE destination, StringSE messageSelector) throws JmsException 指定された宛先から同期的にメッセージを受信しますが、指定された時間までしか配信を待機しません。このメソッドは、メッセージが使用可能になるまで、またはタイムアウト値を超えるまでスレッドをブロックするため、慎重に使用する必要があります。
- パラメーター:
destination
- メッセージを受け取る宛先messageSelector
- JMS メッセージセレクター式(ない場合はnull
)。セレクター式の詳細な定義については、JMS 仕様を参照してください。- 戻り値:
- コンシューマーが受信したメッセージ、またはタイムアウトが期限切れの場合は
null
- 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました
receiveSelected
@Nullable MessageEE receiveSelected(StringSE destinationName, StringSE messageSelector) throws JmsException 指定された宛先から同期的にメッセージを受信しますが、指定された時間までしか配信を待機しません。このメソッドは、メッセージが使用可能になるまで、またはタイムアウト値を超えるまでスレッドをブロックするため、慎重に使用する必要があります。
- パラメーター:
destinationName
- このメッセージの送信先の名前 (DestinationResolver によって実際の宛先に解決される)messageSelector
- JMS メッセージセレクター式(ない場合はnull
)。セレクター式の詳細な定義については、JMS 仕様を参照してください。- 戻り値:
- コンシューマーが受信したメッセージ、またはタイムアウトが期限切れの場合は
null
- 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました
receiveAndConvert
デフォルトの宛先から同期的にメッセージを受信しますが、指定された時間までしか配信を待機しません。メッセージを MessageConverter が構成されたオブジェクトに変換します。このメソッドは、メッセージが使用可能になるまで、またはタイムアウト値を超えるまでスレッドをブロックするため、慎重に使用する必要があります。
これは、デフォルトの宛先が指定されている場合にのみ機能します。
- 戻り値:
- タイムアウトの期限が切れた場合にコンシューマーまたは
null
に対して生成されるメッセージ。 - 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました
receiveAndConvert
指定された宛先から同期的にメッセージを受信しますが、指定された時間まで配信を待機します。メッセージを MessageConverter が構成されたオブジェクトに変換します。このメソッドは、メッセージが使用可能になるまで、またはタイムアウト値を超えるまでスレッドをブロックするため、慎重に使用する必要があります。
- パラメーター:
destination
- メッセージを受け取る宛先- 戻り値:
- タイムアウトの期限が切れた場合にコンシューマーまたは
null
に対して生成されるメッセージ。 - 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました
receiveAndConvert
指定された宛先から同期的にメッセージを受信しますが、指定された時間まで配信を待機します。メッセージを MessageConverter が構成されたオブジェクトに変換します。このメソッドは、メッセージが使用可能になるまで、またはタイムアウト値を超えるまでスレッドをブロックするため、慎重に使用する必要があります。
- パラメーター:
destinationName
- このメッセージの送信先の名前 (DestinationResolver によって実際の宛先に解決される)- 戻り値:
- タイムアウトの期限が切れた場合にコンシューマーまたは
null
に対して生成されるメッセージ。 - 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました
receiveSelectedAndConvert
デフォルトの宛先から同期的にメッセージを受信しますが、指定された時間までしか配信を待機しません。メッセージを MessageConverter が構成されたオブジェクトに変換します。このメソッドは、メッセージが使用可能になるまで、またはタイムアウト値を超えるまでスレッドをブロックするため、慎重に使用する必要があります。
これは、デフォルトの宛先が指定されている場合にのみ機能します。
- パラメーター:
messageSelector
- JMS メッセージセレクター式(ない場合はnull
)。セレクター式の詳細な定義については、JMS 仕様を参照してください。- 戻り値:
- タイムアウトの期限が切れた場合にコンシューマーまたは
null
に対して生成されるメッセージ。 - 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました
receiveSelectedAndConvert
@Nullable ObjectSE receiveSelectedAndConvert(DestinationEE destination, StringSE messageSelector) throws JmsException 指定された宛先から同期的にメッセージを受信しますが、指定された時間まで配信を待機します。メッセージを MessageConverter が構成されたオブジェクトに変換します。このメソッドは、メッセージが使用可能になるまで、またはタイムアウト値を超えるまでスレッドをブロックするため、慎重に使用する必要があります。
- パラメーター:
destination
- メッセージを受け取る宛先messageSelector
- JMS メッセージセレクター式(ない場合はnull
)。セレクター式の詳細な定義については、JMS 仕様を参照してください。- 戻り値:
- タイムアウトの期限が切れた場合にコンシューマーまたは
null
に対して生成されるメッセージ。 - 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました
receiveSelectedAndConvert
@Nullable ObjectSE receiveSelectedAndConvert(StringSE destinationName, StringSE messageSelector) throws JmsException 指定された宛先から同期的にメッセージを受信しますが、指定された時間まで配信を待機します。メッセージを MessageConverter が構成されたオブジェクトに変換します。このメソッドは、メッセージが使用可能になるまで、またはタイムアウト値を超えるまでスレッドをブロックするため、慎重に使用する必要があります。
- パラメーター:
destinationName
- このメッセージの送信先の名前 (DestinationResolver によって実際の宛先に解決される)messageSelector
- JMS メッセージセレクター式(ない場合はnull
)。セレクター式の詳細な定義については、JMS 仕様を参照してください。- 戻り値:
- タイムアウトの期限が切れた場合にコンシューマーまたは
null
に対して生成されるメッセージ。 - 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました
sendAndReceive
リクエストメッセージを送信し、デフォルトの宛先から応答を受信します。MessageCreator
コールバックは、セッションが指定されたメッセージを作成します。この操作の一部として一時キューが作成され、メッセージのJMSReplyTO
ヘッダーに設定されます。これは、デフォルトの宛先が指定されている場合にのみ機能します。
- パラメーター:
messageCreator
- リクエストメッセージを作成するためのコールバック- 戻り値:
- 応答。たとえば、タイムアウトのためにメッセージを受信できなかった場合は
null
- 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました- 導入:
- 4.1
sendAndReceive
@Nullable MessageEE sendAndReceive(DestinationEE destination, MessageCreator messageCreator) throws JmsException メッセージを送信し、指定された宛先から応答を受信します。MessageCreator
コールバックは、セッションが指定されたメッセージを作成します。この操作の一部として一時キューが作成され、メッセージのJMSReplyTO
ヘッダーに設定されます。- パラメーター:
destination
- このメッセージの送信先messageCreator
- メッセージを作成するためのコールバック- 戻り値:
- 応答。たとえば、タイムアウトのためにメッセージを受信できなかった場合は
null
- 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました- 導入:
- 4.1
sendAndReceive
@Nullable MessageEE sendAndReceive(StringSE destinationName, MessageCreator messageCreator) throws JmsException メッセージを送信し、指定された宛先から応答を受信します。MessageCreator
コールバックは、セッションが指定されたメッセージを作成します。この操作の一部として一時キューが作成され、メッセージのJMSReplyTO
ヘッダーに設定されます。- パラメーター:
destinationName
- このメッセージの送信先の名前 (DestinationResolver によって実際の宛先に解決される)messageCreator
- メッセージを作成するためのコールバック- 戻り値:
- 応答。たとえば、タイムアウトのためにメッセージを受信できなかった場合は
null
- 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました- 導入:
- 4.1
browse
デフォルトの JMS キュー内のメッセージを参照します。コールバックは、キューを参照してコンテンツに反応するために、JMS セッションと QueueBrowser へのアクセスを提供します。- パラメーター:
action
- セッションとブラウザーのペアを公開するコールバックオブジェクト- 戻り値:
- セッションでの作業からの結果オブジェクト
- 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました
browse
JMS キュー内のメッセージを参照します。コールバックは、キューを参照してコンテンツに反応するために、JMS セッションと QueueBrowser へのアクセスを提供します。- パラメーター:
queue
- 閲覧するキューaction
- セッションとブラウザーのペアを公開するコールバックオブジェクト- 戻り値:
- セッションでの作業からの結果オブジェクト
- 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました
browse
JMS キュー内のメッセージを参照します。コールバックは、キューを参照してコンテンツに反応するために、JMS セッションと QueueBrowser へのアクセスを提供します。- パラメーター:
queueName
- 参照するキューの名前 (DestinationResolver によって実際の宛先に解決される)action
- セッションとブラウザーのペアを公開するコールバックオブジェクト- 戻り値:
- セッションでの作業からの結果オブジェクト
- 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました
browseSelected
@Nullable <T> T browseSelected(StringSE messageSelector, BrowserCallback<T> action) throws JmsException JMS キューで選択したメッセージを参照します。コールバックは、キューを参照してコンテンツに反応するために、JMS セッションと QueueBrowser へのアクセスを提供します。- パラメーター:
messageSelector
- JMS メッセージセレクター式(ない場合はnull
)。セレクター式の詳細な定義については、JMS 仕様を参照してください。action
- セッションとブラウザーのペアを公開するコールバックオブジェクト- 戻り値:
- セッションでの作業からの結果オブジェクト
- 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました
browseSelected
@Nullable <T> T browseSelected(QueueEE queue, StringSE messageSelector, BrowserCallback<T> action) throws JmsException JMS キューで選択したメッセージを参照します。コールバックは、キューを参照してコンテンツに反応するために、JMS セッションと QueueBrowser へのアクセスを提供します。- パラメーター:
queue
- 閲覧するキューmessageSelector
- JMS メッセージセレクター式(ない場合はnull
)。セレクター式の詳細な定義については、JMS 仕様を参照してください。action
- セッションとブラウザーのペアを公開するコールバックオブジェクト- 戻り値:
- セッションでの作業からの結果オブジェクト
- 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました
browseSelected
@Nullable <T> T browseSelected(StringSE queueName, StringSE messageSelector, BrowserCallback<T> action) throws JmsException JMS キューで選択したメッセージを参照します。コールバックは、キューを参照してコンテンツに反応するために、JMS セッションと QueueBrowser へのアクセスを提供します。- パラメーター:
queueName
- 参照するキューの名前 (DestinationResolver によって実際の宛先に解決される)messageSelector
- JMS メッセージセレクター式(ない場合はnull
)。セレクター式の詳細な定義については、JMS 仕様を参照してください。action
- セッションとブラウザーのペアを公開するコールバックオブジェクト- 戻り値:
- セッションでの作業からの結果オブジェクト
- 例外:
JmsException
- チェック済みの JMSException がチェックなしに変換されました