TsgcHTTPServer › プロパティ › FallBack

FallBack プロパティ

共有サーバーエンジンから継承されたプロパティで、このコンポーネントは WebSocket アップグレードを一切行わないため効果がありません（解説を参照）。

構文

property FallBack: TsgcWSFallBack_Options read FFallBack write SetFallBack;

デフォルト値

ServerSentEvents.Enabled=False

解説

FallBack は、TsgcWebSocketHTTPServer も利用する共有サーバーエンジンからそのまま継承されたプロパティで、そちらではネイティブ WebSocket 接続を開けないブラウザ向けに代替トランスポートとして Server-Sent-Events を設定します。TsgcHTTPServer は WebSocket アップグレードを一切行わないため、ServerSentEvents はこのコンポーネント上では有効化されません。フォールバックすべき WebSocket 接続自体が存在しないためです。このプロパティは共有エンジンとのインターフェース互換性のために公開されたままになっているので、既定値のままにしてください。WebSocket を使わずに HTTP/SSE 形式のサーバープッシュが必要な場合は、レスポンスストリームを開いたままにして text/event-stream コンテンツを直接書き込む OnCommandGet ハンドラーを作成してください。

使用例

(完全性のために示していますが、TsgcHTTPServer には観測可能な効果はありません)

oServer := TsgcHTTPServer.Create(nil);
oServer.FallBack.ServerSentEvents.Enabled := true;
oServer.FallBack.ServerSentEvents.Retry := 3;
oServer.Active := true;

プロパティに戻る