@TargetSE(valueSE={METHODSE,ANNOTATION_TYPESE})
 @RetentionSE(valueSE=RUNTIMESE)
 @DocumentedSE
 @RepeatableSE(valueSE=JmsListeners.class)
 @MessageMapping
public @interface JmsListener

指定された destination() の JMS メッセージリスナーのターゲットになるメソッドをマークするアノテーション。containerFactory() は、JMS リスナーコンテナーの構築に使用する JmsListenerContainerFactory を識別します。設定されていない場合、デフォルトのコンテナーファクトリは、Bean 名が jmsListenerContainerFactory であると想定されます。ただし、構成を通じて明示的なデフォルトが指定されている場合を除きます。

カスタム DefaultJmsListenerContainerFactory Bean のセットアップを検討してください。本番環境では、通常、タイムアウトとリカバリ設定を微調整します。最も重要なのは、デフォルトの "AUTO_ACKNOWLEDGE" モードでは信頼性が保証されないため、信頼性が必要な場合にトランザクションセッションを使用することを確認してください。

@JmsListener アノテーションの処理は、JmsListenerAnnotationBeanPostProcessor を登録することによって実行されます。これは手動で行うか、<jms:annotation-driven/> 要素または @EnableJms アノテーションを使用して行うと便利です。

アノテーション付き JMS リスナーメソッドは、MessageMapping が提供するものと同様の柔軟な署名を持つことができます。

• JMS セッションへのアクセスを取得する SessionEE
• 未加工の JMS メッセージにアクセスするための MessageEE またはそのサブクラスの 1 つ
• Spring のメッセージング抽象化対応を使用する Message
• @Payload - 検証のサポートを含む、アノテーション付きメソッド引数
• @Header -JmsHeaders で定義された標準の JMS ヘッダーを含む、特定のヘッダー値を抽出するためのアノテーション付きメソッド引数
• @Headers - すべてのヘッダーへのアクセスを取得するために MapSE にも割り当て可能でなければならないアノテーション付きメソッド引数
• すべてのヘッダーへのアクセスを取得するための MessageHeaders 引数
• すべてのメソッド引数に簡単にアクセスできる MessageHeaderAccessor または JmsMessageHeaderAccessor

アノテーション付きメソッドには、void 以外の戻り値の型が含まれる場合があります。その場合、メソッド呼び出しの結果は、JMS 応答として、受信メッセージの JMSReplyTO ヘッダーで定義された宛先に送信されます。このヘッダーが設定されていない場合は、@SendTo をメソッド宣言に追加することにより、デフォルトの宛先を提供できます。

このアノテーションをメタアノテーションとして使用して、属性をオーバーライドしたカスタム合成アノテーションを作成できます。