Перейти до вмісту

Імпорт gRPC (.proto або рефлексія)

До дерева gRPC у Restorm ведуть два шляхи.

Файл ▸ Імпортувати (Ctrl+I), а потім файл .proto. Вставлений вміст теж розпізнається (за наявністю syntax = "proto…" або service з rpc).

ЕлементЩо з нього робить Restorm
Кожен serviceТеку
Кожен rpcЗапит gRPC
Ознаки потоковостіТип виклику (unary, server-stream, client-stream, bidirectional-stream)
Вхідне повідомленняЗаздалегідь заповнений зразок повідомлення, побудований за формою повідомлення
Описи й типиДокументацію API та переліки

Через серверну рефлексію

Section titled “Через серверну рефлексію”

У модальному вікні імпорту gRPC вкажіть адресу host:port працюючого сервера. Restorm звернеться до його служби рефлексії й побудує таке саме дерево, як із .proto.

Модальне вікно «Сервер gRPC (reflection)»: поле адреси host, параметр «Використовувати TLS» і таблиця необов'язкових метаданих автентифікації

Дві помітні переваги:

  1. Далі це працює офлайн. Отриманий набір дескрипторів зберігається на кожному створеному запиті: виклики працюють, навіть якщо сервер рефлексії більше недосяжний.
  2. Це піддається повторній синхронізації. Повторне підключення до тієї самої адреси розпізнається як оновлення наявного дерева, а не як новий імпорт. Кнопка Оновити з рефлексії є також на вкладці запиту.

Якщо сервер не реалізує рефлексію, Restorm явно про це повідомить: тоді імпортуйте .proto.

gRPC належить до форматів, придатних до повторної синхронізації, в обох режимах. Див. Оновлення з джерела.