アノテーションインターフェース SubscribeMapping
@TargetSE(METHODSE)
@RetentionSE(RUNTIMESE)
@DocumentedSE
@Reflective(MessageMappingReflectiveProcessor.class)
public @interface SubscribeMapping
サブスクリプションの宛先に基づいて、サブスクリプションメッセージを特定のハンドラーメソッドにマッピングするためのアノテーション。STOMP over WebSocket でのみサポートされます (たとえば、STOMP SUBSCRIBE フレーム)。
これは、型レベルの @MessageMapping
と組み合わせることができるメソッドレベルのアノテーションです。
@MessageMapping
と同じメソッド引数をサポートします。ただし、サブスクリプションメッセージには通常、本文はありません。
戻り値も @MessageMapping
の場合と同じルールに従いますが、メソッドに SendTo
または SendToUser
のアノテーションが付けられていない場合、メッセージは接続されたユーザーに直接送信され、メッセージブローカーを通過しません。これは、リクエスト / 応答パターンの実装に役立ちます。
注意 : コントローラーインターフェースを使用する場合 (たとえば、AOP プロキシ用)、@MessageMapping
や @SubscribeMapping
などのすべてのマッピングアノテーションを、実装クラスではなくコントローラーインターフェースに一貫して配置するようにしてください。
- 導入:
- 4.0
- 作成者:
- Rossen Stoyanchev
- 関連事項:
オプション要素の概要
オプション要素
要素の詳細
value
StringSE[] valueこのアノテーションによって表される宛先ベースのマッピング。これは STOMP メッセージの宛先です (例:
"/positions"
)。Ant スタイルのパスパターン (例:"/price.stock.*"
) とパステンプレート変数 (例:"/price.stock.{ticker}"
) もサポートされています。- デフォルト:
- {}