TsgcHTTPServer Zdarzenia

Zdarzenia, które można obsługiwać, pogrupowane według przeznaczenia, a następnie pełna lista alfabetyczna.

Cykl życia

Nazwa	Opis
OnStartup	Wywoływane po uruchomieniu serwera i jego gotowości do akceptowania połączeń.
OnShutdown	Wywoływane po zatrzymaniu serwera i zakończeniu akceptowania połączeń.
OnTCPConnect	Wywoływane po nawiązaniu połączenia klienta na poziomie TCP i przed przeanalizowaniem żądania HTTP, umożliwiając zaakceptowanie lub odrzucenie połączenia.
OnConnect	Wywoływane za każdym razem, gdy zostaje nawiązane połączenie klienta.
OnDisconnect	Wywoływane za każdym razem, gdy połączenie klienta zostaje zerwane.
OnError	Wywoływane za każdym razem, gdy podczas przetwarzania połączenia klienta wystąpi błąd na poziomie protokołu.
OnException	Wywoływane za każdym razem, gdy podczas przetwarzania połączenia klienta zostanie zgłoszony nieobsługiwany wyjątek.
OnUnknownProtocol	Wywoływane, gdy pierwsze odebrane bajty nie wyglądają na prawidłowe żądanie HTTP, umożliwiając zaakceptowanie lub odrzucenie połączenia.
OnUnknownAuthentication	Wywoływane, gdy uwierzytelnianie jest włączone, a metoda uwierzytelniania nie jest rozpoznawana przez serwer.

HTTP

Nazwa	Opis
OnBeforeCommand	Wywoływane przed OnCommandGet lub OnCommandOther, aby żądanie mogło być sprawdzone, autoryzowane lub krótko-obwodowane odpowiedzią 401.
OnCommandGet	Wywoływane, gdy serwer HTTP odbiera żądanie GET, POST lub HEAD, umożliwiając aplikacji przygotowanie odpowiedzi.
OnCommandOther	Wywoływane, gdy serwer HTTP odbiera metodę inną niż GET, POST lub HEAD (PUT, DELETE, OPTIONS, PATCH...).
OnBeforeForwardHTTP	Wywoływane przed wysłaniem żądania HTTP, aby mogło być ono przekazane (reverse-proxy) do innego serwera HTTP.
OnAfterForwardHTTP	Wywoływane po przesłaniu żądania HTTP, aby aplikacja mogła sprawdzić wynik lub błąd zwrócony przez serwer nadrzędny.
OnHTTP2BeforeAsyncRequest	Wywoływane przed umieszczeniem żądania HTTP/2 w kolejce, umożliwiając aplikacji wybór, czy zostanie ono wykonane w puli wątków, czy w wątku połączenia.

Sesje

Nazwa	Opis
OnCreateSession	Wywoływane, gdy serwer HTTP musi utworzyć nową sesję, aby aplikacja mogła dostarczyć własną instancję TIdHTTPSession.
OnSessionStart	Wywoływane po uruchomieniu sesji HTTP i dodaniu jej do listy SessionList.
OnSessionEnd	Wywoływane, gdy sesja HTTP zostaje zamknięta, jawnie lub po wygaśnięciu SessionTimeout.
OnInvalidSession	Wywoływane, gdy żądanie HTTP zawiera nieznany lub wygasły identyfikator sesji, umożliwiając aplikacji podjęcie decyzji o sposobie reakcji.

Przesyłanie HTTP

Nazwa	Opis
OnHTTPUploadBeforeSaveFile	Wywoływane przed zapisaniem na dysku pliku wyodrębnionego z przesłanego formularza multipart/form-data, co umożliwia dostosowanie nazwy i ścieżki.
OnHTTPUploadAfterSaveFile	Wywoływane po zapisaniu na dysku pliku wyodrębnionego z przesyłanego multipart/form-data.
OnHTTPUploadReadInput	Wywoływane, gdy dekoder multipart/form-data odczytuje pole wejściowe niebędące plikiem, aby można było przechwycić jego wartość.
OnHTTPUploadBeforeCreatePostStream	Wywoływane po odczytaniu nagłówków żądania, a przed utworzeniem strumienia POST, umożliwiając akceptację lub odrzucenie przesyłania.

Niezawodność

Nazwa	Opis
OnSendBufferFull	Wywoływane, gdy kolejka wychodząca połączenia klienta osiągnie skonfigurowany limit, zanim zostanie zastosowana zasada przepełnienia.

Bezpieczeństwo

Nazwa	Opis
OnAuthentication	Wywoływane, gdy uwierzytelnianie jest włączone, co umożliwia aplikacji sprawdzenie nazwy użytkownika i hasła oraz zaakceptowanie lub odrzucenie połączenia.
OnSSLGetHandler	Wywoływane przed utworzeniem procedury obsługi SSL, co umożliwia dostarczenie niestandardowej instancji procedury obsługi po stronie serwera.
OnSSLAfterCreateHandler	Wywoływane po utworzeniu procedury obsługi SSL, umożliwiając dostosowanie jej właściwości.
OnSSLALPNSelect	Wywoływane podczas uzgadniania z włączonym ALPN, aby aplikacja mogła wybrać protokół do negocjacji.
OnSSLVerifyPeer	Wywoływane, gdy VerifyCertificate jest włączone i klient przedstawia certyfikat do zaakceptowania lub odrzucenia.

Wszystkie zdarzenia (alfabetycznie)

Nazwa	Opis
OnAfterForwardHTTP	Wywoływane po przesłaniu żądania HTTP, aby aplikacja mogła sprawdzić wynik lub błąd zwrócony przez serwer nadrzędny.
OnAuthentication	Wywoływane, gdy uwierzytelnianie jest włączone, co umożliwia aplikacji sprawdzenie nazwy użytkownika i hasła oraz zaakceptowanie lub odrzucenie połączenia.
OnBeforeCommand	Wywoływane przed OnCommandGet lub OnCommandOther, aby żądanie mogło być sprawdzone, autoryzowane lub krótko-obwodowane odpowiedzią 401.
OnBeforeForwardHTTP	Wywoływane przed wysłaniem żądania HTTP, aby mogło być ono przekazane (reverse-proxy) do innego serwera HTTP.
OnCommandGet	Wywoływane, gdy serwer HTTP odbiera żądanie GET, POST lub HEAD, umożliwiając aplikacji przygotowanie odpowiedzi.
OnCommandOther	Wywoływane, gdy serwer HTTP odbiera metodę inną niż GET, POST lub HEAD (PUT, DELETE, OPTIONS, PATCH...).
OnConnect	Wywoływane za każdym razem, gdy zostaje nawiązane połączenie klienta.
OnCreateSession	Wywoływane, gdy serwer HTTP musi utworzyć nową sesję, aby aplikacja mogła dostarczyć własną instancję TIdHTTPSession.
OnDisconnect	Wywoływane za każdym razem, gdy połączenie klienta zostaje zerwane.
OnError	Wywoływane za każdym razem, gdy podczas przetwarzania połączenia klienta wystąpi błąd na poziomie protokołu.
OnException	Wywoływane za każdym razem, gdy podczas przetwarzania połączenia klienta zostanie zgłoszony nieobsługiwany wyjątek.
OnHTTP2BeforeAsyncRequest	Wywoływane przed umieszczeniem żądania HTTP/2 w kolejce, umożliwiając aplikacji wybór, czy zostanie ono wykonane w puli wątków, czy w wątku połączenia.
OnHTTPUploadAfterSaveFile	Wywoływane po zapisaniu na dysku pliku wyodrębnionego z przesyłanego multipart/form-data.
OnHTTPUploadBeforeCreatePostStream	Wywoływane po odczytaniu nagłówków żądania, a przed utworzeniem strumienia POST, umożliwiając akceptację lub odrzucenie przesyłania.
OnHTTPUploadBeforeSaveFile	Wywoływane przed zapisaniem na dysku pliku wyodrębnionego z przesłanego formularza multipart/form-data, co umożliwia dostosowanie nazwy i ścieżki.
OnHTTPUploadReadInput	Wywoływane, gdy dekoder multipart/form-data odczytuje pole wejściowe niebędące plikiem, aby można było przechwycić jego wartość.
OnInvalidSession	Wywoływane, gdy żądanie HTTP zawiera nieznany lub wygasły identyfikator sesji, umożliwiając aplikacji podjęcie decyzji o sposobie reakcji.
OnSendBufferFull	Wywoływane, gdy kolejka wychodząca połączenia klienta osiągnie skonfigurowany limit, zanim zostanie zastosowana zasada przepełnienia.
OnSessionEnd	Wywoływane, gdy sesja HTTP zostaje zamknięta, jawnie lub po wygaśnięciu SessionTimeout.
OnSessionStart	Wywoływane po uruchomieniu sesji HTTP i dodaniu jej do listy SessionList.
OnShutdown	Wywoływane po zatrzymaniu serwera i zakończeniu akceptowania połączeń.
OnSSLAfterCreateHandler	Wywoływane po utworzeniu procedury obsługi SSL, umożliwiając dostosowanie jej właściwości.
OnSSLALPNSelect	Wywoływane podczas uzgadniania z włączonym ALPN, aby aplikacja mogła wybrać protokół do negocjacji.
OnSSLGetHandler	Wywoływane przed utworzeniem procedury obsługi SSL, co umożliwia dostarczenie niestandardowej instancji procedury obsługi po stronie serwera.
OnSSLVerifyPeer	Wywoływane, gdy VerifyCertificate jest włączone i klient przedstawia certyfikat do zaakceptowania lub odrzucenia.
OnStartup	Wywoływane po uruchomieniu serwera i jego gotowości do akceptowania połączeń.
OnTCPConnect	Wywoływane po nawiązaniu połączenia klienta na poziomie TCP i przed przeanalizowaniem żądania HTTP, umożliwiając zaakceptowanie lub odrzucenie połączenia.
OnUnknownAuthentication	Wywoływane, gdy uwierzytelnianie jest włączone, a metoda uwierzytelniania nie jest rozpoznawana przez serwer.
OnUnknownProtocol	Wywoływane, gdy pierwsze odebrane bajty nie wyglądają na prawidłowe żądanie HTTP, umożliwiając zaakceptowanie lub odrzucenie połączenia.