Import gRPC (.proto lub refleksja)
Do drzewa gRPC w aplikacji Restorm prowadzą dwie drogi.
Z pliku .proto
Section titled “Z pliku .proto”Plik ▸ Importuj (Ctrl+I), a następnie plik .proto. Rozpoznawana jest
również wklejona treść (obecność syntax = "proto…" albo service
z wywołaniami rpc).
| Element | Co z tym robi Restorm |
|---|---|
Każdy service | Folder |
Każde rpc | Żądanie gRPC |
| Wskaźniki strumieniowania | Typ wywołania (unary, server-stream, client-stream, bidirectional-stream) |
| Wiadomość wejściowa | Wstępnie wypełniona przykładowa wiadomość, zbudowana na podstawie jej struktury |
| Opisy i typy | Dokumentacja API oraz wyliczenia |
Przez refleksję serwera
Section titled “Przez refleksję serwera”W oknie dialogowym importu gRPC należy podać adres host:port działającego
serwera. Restorm odpytuje jego usługę refleksji i buduje to samo drzewo, co na
podstawie pliku .proto.
Dwie istotne zalety:
- Później działa to bez połączenia. Uzyskany zestaw deskryptorów jest przechowywany przy każdym utworzonym żądaniu: wywołania działają nawet wtedy, gdy serwer refleksji przestaje być osiągalny.
- Da się to ponownie zsynchronizować. Ponowne połączenie z tym samym adresem jest rozpoznawane jako aktualizacja istniejącego drzewa, a nie jako nowy import. Przycisk Odśwież z refleksji dostępny jest także w zakładce żądania.
Jeśli serwer nie implementuje refleksji, Restorm wyraźnie to zgłasza: należy
wtedy zaimportować plik .proto.
Aktualizacja
Section titled “Aktualizacja”gRPC należy do formatów, które można ponownie synchronizować, w obu trybach. Zob. Aktualizacja ze źródła.