gRPC (widok dewelopera)
gRPC to binarne RPC. To narzędzie nie wymaga przygotowania pliku .proto — gdy serwer ma włączone Server Reflection, klient sam odkrywa usługi i metody, a potem pozwala oglądać pola i wywoływać je na żądanie.
Przebieg podstawowy
Jak używać w UI (trzy kroki)
Na przykładowej usłudze qrtest.v1.EchoService (grpc://127.0.0.1:18089, jawne h2c):
- Połącz żądanie gRPC (url przechowuje
host:port). Refleksja uruchamia się automatycznie i daje drzewo metod:/qrtest.v1.EchoService/Echo— unary/qrtest.v1.EchoService/EchoStream— server-streaming/qrtest.v1.EchoService/Collect— client-streaming/qrtest.v1.EchoService/Chat— bidirectional streaming
- Obejrzyj schemat metody
Echo:- Wejście
EchoRequest { message: string, count: int32 } - Wyjście
EchoResponse { message: string, seq: int64, metadataJson: string }
- Wejście
- Wywołaj
Echoz{"message":"hello-grpc","count":3}:- Unary: jedna odpowiedź
{message:"hello-grpc", seq, metadataJson}, statusOK - Server-streaming
EchoStreamz tym samym wejściem: 3 ramkistream#1/#2/#3
- Unary: jedna odpowiedź
Metadane (nagłówki gRPC)
Nagłówki autoryzacji/śledzenia są przekazywane jako metadane z kluczami zapisanymi małymi literami; nagłówki zastrzeżone jak grpc-* i content-type są odfiltrowywane.
TLS / mTLS
Użyj Pre-URL grpcs:// i zaimportuj certyfikaty klienta w ustawieniach.
Pułapki (ważne)
- Status nie-OK to normalny wynik biznesowy, nie błąd połączenia: timeouty i błędy biznesowe wracają jako kod statusu z być może pustą odpowiedzią — nie traktuj ich jako błędów transportu. Tylko HTTP 4xx oznacza rzeczywisty błąd.
- Narzędzie obsługuje tylko unary i server-streaming; client-streaming / bidirectional streaming nie mogą być jeszcze wywoływane (dla pełnego streamingu w aplikacji autorytetem jest UI).
- Typy złożone: pola
mappojawiają się jako zagnieżdżonemapEntry; typy wskazywane pośrednio też są pobierane.
Powiązane: Pre-URL środowisk i konfiguracja TLS w concepts.