TsgcHTTP3Server › イベント › OnH3Exception

OnH3Exception イベント

HTTP/3 接続のサービス中に未処理の例外が発生したときに発生します。

構文

property OnH3Exception: TsgcQUICServerExceptionEvent;
// TsgcQUICServerExceptionEvent = procedure(Sender: TObject; const aConnection: TsgcQUICServerConnection; const aException: Exception) of object

デフォルト値

—

パラメータ

名前	タイプ	説明
aConnection	const TsgcQUICServerConnection	例外が発生した QUIC 接続。単一の接続に関連しないエラーの場合は nil になることがあります。
aException	Exception	キャッチされた例外。

解説

OnH3Exception は、サーバーが接続の QUIC/HTTP/3 トラフィックを処理中（例：ハンドシェイク、フレーム解析、リクエストディスパッチ、レスポンス書き込み）に未処理の例外が発生したときに発生します。このイベントを処理することで、アプリケーションは失敗をログに記録し、サーバーを実行し続けることができます。エラーはリスナーを終了させるのではなく、影響を受けた接続に分離されます。

利用可能な場合は aConnection パラメータを使用して関係するピアを特定し、エラーの詳細は aException.Message を読み取ってください。

使用例

procedure OnH3ExceptionEvent(Sender: TObject; const aConnection:
    TsgcQUICServerConnection; const aException: Exception);
begin
  Log('HTTP/3 error: ' + aException.Message);
end;

イベントに戻る