TsgcWebSocketServer_HTTPAPI › イベント

TsgcWebSocketServer_HTTPAPI イベント

処理可能なイベントを目的別にグループ化し、その後完全なアルファベット順リストを表示します。

ライフサイクル

名前説明
OnStartupHTTP APIサーバーが起動し、接続を受け入れる準備ができた後に発生します。
OnShutdownHTTP APIサーバーが停止し、これ以上リクエストを受け付けなくなった後に発生します。
OnBeforeBindingサーバーが設定された URL にバインドする前に発生します。バインディングのリストを検査またはカスタマイズできます。
OnTCPConnectクライアントが TCP レベルで接続し WebSocket ハンドシェイクが行われる前に発生します。これにより接続を受け入れるか拒否するかを決定できます。
OnConnectクライアントとの WebSocket 接続が確立されるたびに発生します。
OnDisconnectクライアントとのWebSocket接続が切断されるたびに発生します。
OnHandshakeサーバー側でハンドシェイクが評価された後、レスポンスが送信される前に発生します。
OnError不正な形式のハンドシェイクなど、WebSocketプロトコルエラーが発生するたびに発生します。
OnExceptionクライアント接続の処理中に未処理の例外が発生するたびに発火します。
OnUnknownProtocol現在 HTTP API サーバーではサポートされていません。TsgcWebSocketServer との API 互換性のために宣言されています。

データ

名前説明
OnMessageクライアントがテキストメッセージを送信してサーバーで受信されるたびに発生します。
OnBinaryクライアントがバイナリメッセージを送信してサーバーが受信するたびに発生します。
OnFragmentedメッセージのフラグメントが受信されたときに発生します (Options.FragmentedMessages が frgAll または frgOnlyFragmented の場合のみ)。

HTTP

名前説明
OnHTTPRequestサーバーが HTTP リクエストを受信したときにアプリケーションがレスポンスを構築できるよう発生します。
OnBeforeForwardHTTPHTTP リクエストが送信される前に発火し、別の HTTP サーバーへ転送(リバースプロキシ)できるようにします。
OnAfterForwardHTTPHTTPリクエストが転送された後に発生し、アプリケーションが結果や上流サーバーから返されたエラーを検査できるようにします。

HTTP アップロード

名前説明
OnHTTPUploadBeforeSaveFilemultipart/form-dataアップロードから抽出されたファイルがディスクに保存される前に発生するため、名前とパスをカスタマイズできます。
OnHTTPUploadAfterSaveFilemultipart/form-data アップロードから抽出されたファイルがディスクに保存された後に発生します。
OnHTTPUploadReadInputmultipart/form-data デコーダーがファイルではない入力フィールドを読み取ったときに発生し、その値をキャプチャできます。
OnHTTPUploadBeforeCreatePostStreamリクエストヘッダーが読み込まれた後、POST ストリームが作成される前に発火し、アップロードを受け入れるか拒否できます。

信頼性

名前説明
OnBeforeHeartBeat各 HeartBeat ping の前に発生し、アプリケーションがカスタムキープアライブを実装できるようにします。
OnAsynchronousHTTP APIサーバーによって開始された非同期送信操作が完了したときに発生します。

セキュリティ

名前説明
OnAuthentication認証が有効になっているときに発生し、アプリケーションがユーザーとパスワードを確認して接続を受け入れるか拒否できます。

すべてのイベント (アルファベット順)

名前説明
OnAfterForwardHTTPHTTPリクエストが転送された後に発生し、アプリケーションが結果や上流サーバーから返されたエラーを検査できるようにします。
OnAsynchronousHTTP APIサーバーによって開始された非同期送信操作が完了したときに発生します。
OnAuthentication認証が有効になっているときに発生し、アプリケーションがユーザーとパスワードを確認して接続を受け入れるか拒否できます。
OnBeforeBindingサーバーが設定された URL にバインドする前に発生します。バインディングのリストを検査またはカスタマイズできます。
OnBeforeForwardHTTPHTTP リクエストが送信される前に発火し、別の HTTP サーバーへ転送(リバースプロキシ)できるようにします。
OnBeforeHeartBeat各 HeartBeat ping の前に発生し、アプリケーションがカスタムキープアライブを実装できるようにします。
OnBinaryクライアントがバイナリメッセージを送信してサーバーが受信するたびに発生します。
OnConnectクライアントとの WebSocket 接続が確立されるたびに発生します。
OnDisconnectクライアントとのWebSocket接続が切断されるたびに発生します。
OnError不正な形式のハンドシェイクなど、WebSocketプロトコルエラーが発生するたびに発生します。
OnExceptionクライアント接続の処理中に未処理の例外が発生するたびに発火します。
OnFragmentedメッセージのフラグメントが受信されたときに発生します (Options.FragmentedMessages が frgAll または frgOnlyFragmented の場合のみ)。
OnHandshakeサーバー側でハンドシェイクが評価された後、レスポンスが送信される前に発生します。
OnHTTPRequestサーバーが HTTP リクエストを受信したときにアプリケーションがレスポンスを構築できるよう発生します。
OnHTTPUploadAfterSaveFilemultipart/form-data アップロードから抽出されたファイルがディスクに保存された後に発生します。
OnHTTPUploadBeforeCreatePostStreamリクエストヘッダーが読み込まれた後、POST ストリームが作成される前に発火し、アップロードを受け入れるか拒否できます。
OnHTTPUploadBeforeSaveFilemultipart/form-dataアップロードから抽出されたファイルがディスクに保存される前に発生するため、名前とパスをカスタマイズできます。
OnHTTPUploadReadInputmultipart/form-data デコーダーがファイルではない入力フィールドを読み取ったときに発生し、その値をキャプチャできます。
OnMessageクライアントがテキストメッセージを送信してサーバーで受信されるたびに発生します。
OnShutdownHTTP APIサーバーが停止し、これ以上リクエストを受け付けなくなった後に発生します。
OnStartupHTTP APIサーバーが起動し、接続を受け入れる準備ができた後に発生します。
OnTCPConnectクライアントが TCP レベルで接続し WebSocket ハンドシェイクが行われる前に発生します。これにより接続を受け入れるか拒否するかを決定できます。
OnUnknownProtocol現在 HTTP API サーバーではサポートされていません。TsgcWebSocketServer との API 互換性のために宣言されています。