gRPC

Klikněte pravým tlačítkem ve stromu ▸ Přidat ▸ Požadavek gRPC.

Karta gRPC: adresa serveru, typ volání „Unární“, vyhodnocená cesta služba/metoda, zpráva požadavku v JSON a metadata

Konfigurace

Pole	Role
URL	`host:port` serveru
Služba / Metoda	Služba a volaná RPC
Typ volání	`unary`, `server-stream`, `client-stream`, `bidirectional-stream`
Zpráva požadavku	Zpráva, v JSON
Metadata	Páry klíč / hodnota přenášené s voláním (právě tudy jdou přihlašovací údaje)

Odkud se bere definice služby

Tři možné zdroje, v tomto pořadí priority:

sada deskriptorů získaná serverovou reflexí — to je to, co ukládá import pomocí reflexe, a má přednost před ostatním;
vložený obsah .proto, uložený v projektu;
cesta k souboru .proto na disku.

První možnost má důležitý praktický důsledek: požadavek importovaný pomocí reflexe funguje dál i bez připojení, aniž by byl server dosažitelný.

Import pomocí reflexe

V dialogu importu gRPC zadejte host:port: Restorm se dotáže služby reflexe, načte deskriptory a sestaví podstrom — jednu složku pro každou službu, jeden požadavek pro každou RPC, s ukázkovou zprávou.

Opětovné připojení na tutéž adresu se rozpozná jako opětovná synchronizace a existující podstrom se aktualizuje, místo aby se zduplikoval.

Pokud server reflexi neimplementuje, Restorm to řekne výslovně: pak importujte soubor .proto. Viz Import .proto pro gRPC.

Transporty

K dispozici jsou tři transporty:

Transport	Kdy jej použít
`grpc` (výchozí)	Nativní gRPC nad HTTP/2
`grpc-web`	Server za proxy gRPC-Web
`connect`	Server Connect-RPC

Streamovaná volání

U všech tří streamovaných režimů zobrazuje panel odpovědi zprávy průběžně. Ve scénáři použijte akce Připojení gRPC, Odeslání gRPC a Zavřít připojení gRPC: připojení zůstává mezi bloky otevřené, každá přijatá zpráva vysílá událost a zavření provede poloviční uzavření na straně klienta.

Režim serveru

Restorm umí hostovat simulační server gRPC: seznam simulovaných metod, každá se svou zprávou odpovědi (pro stream pole JSON), svým stavovým kódem, svými koncovými metadaty, nebo se skriptem. Serverová reflexe je ve výchozím stavu vystavená a TLS lze nakonfigurovat certifikátem a klíčem ve formátu PEM. Viz Simulace služby gRPC.

Ukázky kódu

Čtrnáct cílů: grpcurl, grpc_cli, grpcurl v režimu gRPC-Web, curl v režimu Connect-RPC, JavaScript a TypeScript (@grpc/grpc-js), Python (grpcio), Go, Java (grpc-java), C# (Grpc.Net.Client), Ruby, Rust (tonic), Kotlin (grpc-kotlin), Swift (grpc-swift).