Tovább a tartalomhoz

gRPC importálása (.proto vagy reflexió)

Két út vezet gRPC-fához a Restormban.

Fájl ▸ Importálás (Ctrl+I), majd a .proto fájl. A beillesztett tartalom is felismert (a syntax = "proto…" jelenléte, vagy egy service rpc elemekkel).

ElemAmit a Restorm készít belőle
Minden serviceEgy mappa
Minden rpcEgy gRPC-kérés
A folyamjelzőkA hívás típusa (unary, server-stream, client-stream, bidirectional-stream)
A bemeneti üzenetAz üzenet alakja alapján felépített, előre kitöltött példaüzenet
Leírások és típusokAz API-dokumentáció és a felsorolások

A gRPC importálási párbeszédpanelen meg kell adni egy futó kiszolgáló host:port címét. A Restorm lekérdezi a reflexiós szolgáltatását, és ugyanazt a fát építi fel, mint egy .proto fájlból.

A „gRPC-szerver (reflection)” párbeszédpanel: a host címmező, a TLS használata beállítás és az opcionális hitelesítési metaadatok táblázata

Két figyelemre méltó előnye van:

  1. Utána offline is működik. A kapott leírókészlet minden létrejövő kérésen eltárolódik: a hívások akkor is működnek, ha a reflexiós szolgáltatása már nem érhető el.
  2. Újraszinkronizálható. Az ugyanahhoz a címhez való újbóli kapcsolódást a Restorm a meglévő fa frissítéseként ismeri fel, nem új importálásként. A kérés lapján is található egy Frissítés reflectionből gomb.

Ha a kiszolgáló nem valósítja meg a reflexiót, a Restorm ezt kifejezetten jelzi: ilyenkor a .proto fájlt kell importálni.

A gRPC mindkét módban az újraszinkronizálható formátumok közé tartozik. Lásd: Frissítés a forrásból.