インターフェース SubProtocolHandler
- すべての既知の実装クラス:
StompSubProtocolHandler
public interface SubProtocolHandler
WebSocket RFC 仕様で「サブプロトコル」と呼ばれる、上位レベルのプロトコルの一部として WebSocket メッセージを処理するための規約。クライアントからの
WebSocketMessages とクライアントへの Messages の両方を処理します。 このインターフェースの実装は、Sec-WebSocket-Protocol リクエストヘッダーを介してクライアントからリクエストされたサブプロトコルに基づいてメッセージを委譲するサブプロトコルハンドラーを選択する SubProtocolWebSocketHandler で構成できます。
- 導入:
- 4.0
- 作成者:
- Andy Wilkinson, Rossen Stoyanchev
メソッドのサマリー
修飾子と型メソッド説明voidafterSessionEnded(WebSocketSession session, CloseStatus closeStatus, MessageChannel outputChannel) WebSocketSessionが終了した後に呼び出されます。voidafterSessionStarted(WebSocketSession session, MessageChannel outputChannel) WebSocketSessionが開始した後に呼び出されます。このハンドラーでサポートされているサブプロトコルのリストを返します(非null)。voidhandleMessageFromClient(WebSocketSession session, WebSocketMessage<?> message, MessageChannel outputChannel) クライアントから受信した特定のWebSocketMessageを処理します。voidhandleMessageToClient(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