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

gRPC (Погляд розробника)

gRPC — бінарний RPC. Цей інструмент не вимагає готувати файл .proto — якщо сервер увімкнув Server Reflection, клієнт автоматично виявляє сервіси та методи, а потім переглядає поля та викликає їх за потреби.

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

Як користуватися в UI (три кроки)​

Використовуючи приклад сервісу qrtest.v1.EchoService (grpc://127.0.0.1:18089, відкритий h2c):

  1. З'єднайте gRPC-запит (url зберігає host:port). Reflection запускається автоматично і дає дерево методів:
    • /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.