Natywna implementacja WebSocket RFC 6455 dla Delphi i C++Builder. Buduj klientów i serwery, które trzymają tysiące jednoczesnych połączeń, działają na Windows, macOS, Linux, iOS i Android i przeżywają niestabilne sieci dzięki wbudowanemu automatycznemu ponownemu łączeniu WatchDog.
Drop-in komponent VCL/FMX, który zamienia protokół WebSocket w API właściwości i zdarzeń, które natywni deweloperzy Delphi rozpoznają.
Komponent WebSocket dla Delphi to niewizualny komponent, który upuszczasz na formularz (lub instancjonujesz w czasie wykonania), aby otworzyć pełnoduplexowy kanał TCP między aplikacją Delphi a dowolnym peerem WebSocket RFC 6455 — przeglądarką, usługą Node.js, reverse proxy nginx, brokerem Mosquitto, endpointem OpenAI Realtime lub innym procesem Delphi. W przeciwieństwie do polling HTTP, WebSocket trzyma połączenie otwarte: serwer może pchać dane w momencie, gdy są dostępne, z latencją milisekundową i bez narzutu HTTP per-wiadomość.
sgcWebSockets jest referencyjną biblioteką WebSocket w ekosystemie Delphi od 2013 roku. Te same komponenty TsgcWebSocketClient i TsgcWebSocketHTTPServer działają bez zmian na Delphi 7 do Delphi 13, na Win32, Win64, Linux64, macOS, iOS i Android oraz na C++Builder C2007 do C13. Nie ma zarządzanego runtime, nie ma warstwy interop .NET, nie ma mostu JavaScript — to czysta implementacja Pascala, która kompiluje się do Twojego binarnego.
Napisanie jednego handlera PING/PONG jest łatwe. Przetrwanie reverse proxy terminującego TLS, modułu WebSocket IIS, firmowego firewalla, mobilnego handoveru komórkowego i testu obciążenia 5000 klientów to nie.
Zwykły WebSocket (ws://), TLS WebSocket (wss://), WebSocket nad HTTP/2, WebSocket nad QUIC/HTTP/3, surowy fallback TCP — ten sam komponent, te same zdarzenia. Przełącz transport, zmieniając jedną właściwość.
Włącz WatchDog, a klient ponownie się połączy z wykładniczym backoff, ponownie uwierzytelni, ponownie zasubskrybuje tematy MQTT i odtworzy wszelkie kolejkowane publikacje — kanoniczny wzorzec mobilny / IoT, już napisany.
Serwer pod maską używa reaktora IOCP / kqueue / epoll. Piszesz handlery zdarzeń; biblioteka planuje je w puli wątków z serializacją per-połączenie.
Negocjowane automatycznie według RFC 7692. Tnie ładunki JSON o 70–90 % i jest wspierane przez każdą nowoczesną przeglądarkę i load balancer.
MQTT 3.1.1/5.0, AMQP 0.9.1/1.0, STOMP, WAMP i Server-Sent Events jadą na wierzchu tego samego transportu WebSocket — jedno gniazdo TCP, wiele protokołów aplikacji.
TsgcWebSocketHTTPServer serwuje pliki statyczne, endpointy REST, zasoby chronione JWT i OAuth2, odpowiedzi skompresowane gzip i upgrade HTTP/2 w tym samym procesie co Twój endpoint WebSocket.
OpenSSL (cross-platform), SChannel (Windows kernel TLS) lub HTTP.sys. Certyfikaty klienta, SNI, ALPN, TLS 1.3 z 0-RTT.
Serwerowe Channels grupują połączenia po nazwie. Broadcast, BroadcastByChannel i BroadcastByUser rozsyłają do tysięcy peerów w pojedynczym wywołaniu.
W produkcji w bankach, na giełdach, w flotach IoT i firmach tradingowych od 2013 roku. Aktualizowane co miesiąc; history.txt śledzi każdą poprawkę.
Wszystko, co mówi RFC, plus operacyjne utwardzenie, którego potrzebują prawdziwe wdrożenia.
| Możliwość | Klient | Serwer |
|---|---|---|
| Ramkowanie RFC 6455 (text, binary, ping, pong, close) | Tak | Tak |
| permessage-deflate (RFC 7692) | Tak | Tak |
| Fragmentowane i ramki kontynuacji | Tak | Tak |
| Maskowane wiadomości klienta | Tak | n/d |
| TLS 1.2 / 1.3 (OpenSSL + SChannel) | Tak | Tak |
| Certyfikaty klienta / mTLS | Tak | Tak |
| Uwierzytelnianie JWT i OAuth2 | Tak | Tak |
| HTTP/2 + WebSocket (RFC 8441) | Tak | Tak |
| HTTP/3 + WebSocket nad QUIC (RFC 9220) | Tak | Tak |
| Automatyczne ponowne łączenie WatchDog | Tak | n/d |
| Heart-beat (PING/PONG) | Tak | Tak |
| Kanały i rozgłaszanie | n/d | Tak |
| Podprotokoły (MQTT / AMQP / STOMP / WAMP / SSE) | Tak | Tak |
| Hosting HTTP.sys (Windows kernel) | n/d | Tak |
| Tryb daemon Linux | Tak | Tak |
Upuść TsgcWebSocketClient na formularz, ustaw Host / Port, obsłuż OnMessage, ustaw Active := True.
uses
sgcWebSocket, sgcWebSocket_Classes;
procedure TForm1.FormCreate(Sender: TObject);
begin
WS := TsgcWebSocketClient.Create(nil);
WS.URL := 'wss://echo.websocket.events';
WS.WatchDog.Enabled := True;
WS.WatchDog.Interval := 5;
WS.OnConnect := WSConnect;
WS.OnMessage := WSMessage;
WS.OnDisconnect := WSDisconnect;
WS.Active := True;
end;
procedure TForm1.WSMessage(Connection: TsgcWSConnection; const Text: string);
begin
Memo1.Lines.Add('<< ' + Text);
end;
procedure TForm1.ButtonSendClick(Sender: TObject);
begin
WS.WriteData('{"hello":"world"}');
end;Strona serwera jest symetryczna — upuść TsgcWebSocketHTTPServer, ustaw Port, obsłuż OnConnect i OnMessage, wywołaj Broadcast, aby rozesłać do każdego podłączonego peera.
Jedno drzewo źródłowe, 22 pakiety runtime — pokrywające każde wydanie Delphi nadal w aktywnym użyciu komercyjnym.
| Edycja | Wersje |
|---|---|
| Delphi / RAD Studio | 7, 2007, 2009, 2010, XE, XE2, XE3, XE4, XE5, XE6, XE7, XE8, 10 Seattle, 10.1 Berlin, 10.2 Tokyo, 10.3 Rio, 10.4 Sydney, 11 Alexandria, 12 Athens, 13 |
| C++Builder | 2007, 2009, 2010, XE, XE2, XE3, XE4, XE5, XE6, XE7, XE8, 10, 10.1, 10.2, 10.3, 10.4, 11, 12, 13 |
| FreePascal / Lazarus | 3.x (przez bazę sgcIndy) |
| Platformy | Win32, Win64, Linux64, macOS Intel/ARM, iOS device + symulator, Android ARM/ARM64 |
Transport WebSocket to fundament każdego innego protokołu w bibliotece.
Tło protokołu RFC 6455, handshake, ramkowanie i przypadki użycia.
Uruchom MQTT 3.1.1 / 5.0 nad tym samym połączeniem WebSocket.
Multipleksowane HTTP/2 z server push i WebSocket-over-HTTP/2.
WebSocket vs SSE vs HTTP/2 push vs MQTT vs WebRTC — matryca decyzyjna.
Przewodnik wzorców rozgłaszania do podzbiorów połączeń.
Jak działa cykl życia automatycznego ponownego łączenia pod maską.
Strojenie permessage-deflate dla przepustowości vs CPU.
Każde komercyjne wydanie Delphi od Delphi 7 (2002) do Delphi 13 (2025), plus pasujące wersje C++Builder. Dostarczamy 22 oddzielne pakiety runtime — jeden na IDE — z pojedynczego drzewa źródłowego. Nie ma oddzielnego SKU „legacy”; każdy klient dostaje każdą wersję.
Tak. Ustaw URL := 'wss://...' i wybierz dostawcę TLS: OpenSSL (cross-platform, dostarczany z wersją próbną), SChannel (Windows kernel TLS, bez DLL do wdrożenia) lub HTTP.sys (po stronie serwera, certyfikat przechowywany w Windows certificate store). Certyfikaty klienta, SNI, ALPN, TLS 1.3 i 0-RTT są wszystkie wspierane.
Na Windows serwer używa IOCP i rutynowo skaluje się do ponad 50 000 jednoczesnych połączeń na proces na sprzęcie commodity. Na Linux reaktor epoll skaluje się podobnie. Twardy limit jest na poziomie OS (deskryptory plików, zakres portów efemerycznych, pamięć kernela), a nie biblioteka.
Bezpłatna od opłat licencyjnych wieczysta licencja per-deweloper z jednym rokiem aktualizacji wliczonym. Dostępne licencje single-developer, team i site — zobacz cennik. Kod źródłowy jest wliczony w każdą edycję komercyjną.