Перейти к основному содержимому

gRPC (глазами разработчика)

gRPC — бинарный RPC. Инструменту не нужно готовить файл .proto — пока на сервере включен Server Reflection, клиент автоматически обнаруживает сервисы и методы, затем изучает поля и вызывает их по требованию.

Основной поток​

Как пользоваться в UI (три шага)​

На примере сервиса qrtest.v1.EchoService (grpc://127.0.0.1:18089, открытый h2c):

  1. Подключите gRPC-запрос (url хранит host:port). Рефлексия выполняется автоматически и выдает дерево методов:
    • /qrtest.v1.EchoService/Echo — unary
    • /qrtest.v1.EchoService/EchoStream — server-streaming
    • /qrtest.v1.EchoService/Collect — client-streaming
    • /qrtest.v1.EchoService/Chat — bidirectional streaming
  2. Изучите схему метода Echo:
    • Вход EchoRequest { message: string, count: int32 }
    • Выход EchoResponse { message: string, seq: int64, metadataJson: string }
  3. Вызовите Echo с {"message":"hello-grpc","count":3}:
    • Unary: один ответ {message:"hello-grpc", seq, metadataJson}, статус OK
    • Server-streaming EchoStream с тем же входом: 3 фрейма stream#1/#2/#3

Метаданные (gRPC-заголовки)​

Заголовки аутентификации/трассировки передаются как метаданные с ключами в нижнем регистре; зарезервированные заголовки вроде grpc-* и content-type отфильтровываются.

TLS / mTLS​

Используйте Pre-URL grpcs:// и импортируйте клиентские сертификаты в настройках.

Важные нюансы​

  • Не-OK статус — это нормальный бизнес-результат, а не сбой соединения: таймауты и бизнес-ошибки возвращаются кодом статуса с возможно пустым ответом — не считайте их транспортными ошибками. Реальную ошибку обозначает только HTTP 4xx.
  • Инструмент поддерживает только unary и server-streaming; client-streaming / bidirectional streaming пока вызвать нельзя (для полноценного стриминга внутри приложения авторитетен UI).
  • Сложные типы: поля map отображаются как вложенные mapEntry; косвенно упомянутые типы тоже подтягиваются.

Связанное: Pre-URL окружения и настройка TLS в concepts.