Symulowanie usługi gRPC

Kliknięcie prawym przyciskiem na folderze ▸ Dodaj ▸ Serwer gRPC.

Konfiguracja

Każda symulowana metoda jest wpisem listy:

Pole	Rola
Usługa / Metoda	To, co jest obsługiwane
Typ wywołania	unary, server-stream, client-stream, bidirectional-stream
Komunikat odpowiedzi	Zwracany komunikat, w JSON — tablica JSON w przypadku strumienia, gdzie każdy element jest jedną ramką
Kod statusu	0 dla OK albo dowolny inny kod gRPC
Komunikat statusu	Powiązany komunikat
Metadane końcowe	Trailery
Skrypt	JavaScript, który ma pierwszeństwo przed komunikatem odpowiedzi

Symulowanie błędu

To najbardziej opłacalne zastosowanie: odtworzenie kodów statusu, z którymi klient musi umieć sobie poradzić.

Kod	Przydatny do testowania
4 DEADLINE_EXCEEDED	Zachowania po przekroczeniu limitu czasu
8 RESOURCE_EXHAUSTED	Ograniczania przepustowości
14 UNAVAILABLE	Mechanizmu zapasowego i ponawiania
16 UNAUTHENTICATED	Odnawiania tokenu

Wystarczy wpisać kod, komunikat oraz metadane końcowe, a następnie sprawdzić, czy klient reaguje poprawnie.

Strumienie

W trybie strumieniowym komunikat odpowiedzi jest tablicą JSON: każdy element zostaje wysłany jako odrębna ramka.

Refleksja

Serwer domyślnie udostępnia usługę refleksji gRPC. Klienci — w tym grpcurl oraz import przez refleksję w aplikacji Restorm — mogą więc odkryć usługę bez pliku .proto.

TLS

Dwa pola, tlsCertPem i tlsKeyPem, przyjmują certyfikat i klucz w formacie PEM, co pozwala obsługiwać ruch przez TLS.

W scenariuszu

Akcje Serwer gRPC oraz Zamknięcie serwera gRPC. Zob. Serwery hostowane.