インターフェース SubProtocolHandler
- すべての既知の実装クラス:
StompSubProtocolHandler
public interface SubProtocolHandler
WebSocket RFC 仕様で「サブプロトコル」と呼ばれる、上位レベルのプロトコルの一部として WebSocket メッセージを処理するための規約。クライアントからの
WebSocketMessages
とクライアントへの Messages
の両方を処理します。 このインターフェースの実装は、Sec-WebSocket-Protocol
リクエストヘッダーを介してクライアントからリクエストされたサブプロトコルに基づいてメッセージを委譲するサブプロトコルハンドラーを選択する SubProtocolWebSocketHandler
で構成できます。
- 導入:
- 4.0
- 作成者:
- Andy Wilkinson, Rossen Stoyanchev
メソッドのサマリー
修飾子と型メソッド説明void
afterSessionEnded
(WebSocketSession session, CloseStatus closeStatus, MessageChannel outputChannel) WebSocketSession
が終了した後に呼び出されます。void
afterSessionStarted
(WebSocketSession session, MessageChannel outputChannel) WebSocketSession
が開始した後に呼び出されます。このハンドラーでサポートされているサブプロトコルのリストを返します(非null
)。void
handleMessageFromClient
(WebSocketSession session, WebSocketMessage<?> message, MessageChannel outputChannel) クライアントから受信した特定のWebSocketMessage
を処理します。void
handleMessageToClient
(WebSocketSession session, Message<?> message) 指定された WebSocket セッションに関連付けられたクライアントに対して、指定されたMessage
を処理します。resolveSessionId
(Message<?> message) 指定されたメッセージからセッション ID を解決するか、null
を返します。
メソッドの詳細
getSupportedProtocols
このハンドラーでサポートされているサブプロトコルのリストを返します(非null
)。handleMessageFromClient
void handleMessageFromClient(WebSocketSession session, WebSocketMessage<?> message, MessageChannel outputChannel) throws ExceptionSE クライアントから受信した特定のWebSocketMessage
を処理します。- パラメーター:
session
- クライアントセッションmessage
- クライアントメッセージoutputChannel
- メッセージを送信する出力チャネル- 例外:
ExceptionSE
handleMessageToClient
指定された WebSocket セッションに関連付けられたクライアントに対して、指定されたMessage
を処理します。- パラメーター:
session
- クライアントセッションmessage
- クライアントメッセージ- 例外:
ExceptionSE
resolveSessionId
指定されたメッセージからセッション ID を解決するか、null
を返します。- パラメーター:
message
- セッション ID を解決するメッセージ
afterSessionStarted
WebSocketSession
が開始した後に呼び出されます。- パラメーター:
session
- クライアントセッションoutputChannel
- チャンネル- 例外:
ExceptionSE
afterSessionEnded
void afterSessionEnded(WebSocketSession session, CloseStatus closeStatus, MessageChannel outputChannel) throws ExceptionSE WebSocketSession
が終了した後に呼び出されます。- パラメーター:
session
- クライアントセッションcloseStatus
- セッションが閉じられた理由outputChannel
- チャンネル- 例外:
ExceptionSE