gRPC (глазами разработчика)
gRPC — бинарный RPC. Инструменту не нужно готовить файл .proto — пока на сервере включен Server Reflection, клиент автоматически обнаруживает сервисы и методы, затем изучает поля и вызывает их по требованию.
Основной поток
Как пользоваться в UI (три шага)
На примере сервиса qrtest.v1.EchoService (grpc://127.0.0.1:18089, открытый h2c):
- Подключите 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
- Изучите схему метода
Echo:- Вход
EchoRequest { message: string, count: int32 } - Выход
EchoResponse { message: string, seq: int64, metadataJson: string }
- Вход
- Вызовите
Echoс{"message":"hello-grpc","count":3}:- Unary: один ответ
{message:"hello-grpc", seq, metadataJson}, статусOK - Server-streaming
EchoStreamс тем же входом: 3 фреймаstream#1/#2/#3
- Unary: один ответ
Метаданные (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.