Pular para o conteúdo principal

gRPC (visão do desenvolvedor)

gRPC é RPC binário. Esta ferramenta não exige que você prepare um arquivo .proto — desde que o servidor ative Server Reflection, o cliente descobre serviços e métodos automaticamente, depois inspeciona campos e invoca sob demanda.

Fluxo principal​

Como usar na UI (três passos)​

Usando o serviço de exemplo qrtest.v1.EchoService (grpc://127.0.0.1:18089, h2c em texto puro):

  1. Conecte a requisição gRPC (a url armazena host:port). A Reflection roda automaticamente e gera a árvore de métodos:
    • /qrtest.v1.EchoService/Echo — unary
    • /qrtest.v1.EchoService/EchoStream — server-streaming
    • /qrtest.v1.EchoService/Collect — client-streaming
    • /qrtest.v1.EchoService/Chat — bidirectional streaming
  2. Inspecione o schema do método Echo:
    • Entrada EchoRequest { message: string, count: int32 }
    • Saída EchoResponse { message: string, seq: int64, metadataJson: string }
  3. Invoque Echo com {"message":"hello-grpc","count":3}:
    • Unary: uma resposta {message:"hello-grpc", seq, metadataJson}, status OK
    • Server-streaming EchoStream com a mesma entrada: 3 frames stream#1/#2/#3

Metadados (cabeçalhos gRPC)​

Cabeçalhos de autenticação/tracing são passados como metadados com chaves em minúsculas; cabeçalhos reservados como grpc-* e content-type são filtrados.

TLS / mTLS​

Use um Pre-URL grpcs:// e importe certificados de cliente nas configurações.

Pontos de atenção (importante)​

  • Um status não-OK é um resultado normal de negócio, não uma falha de conexão: timeouts e erros de negócio voltam como código de status com uma resposta possivelmente vazia — não os trate como erros de transporte. Apenas HTTP 4xx indica erro real.
  • A ferramenta suporta apenas unary e server-streaming; client-streaming / bidirectional streaming ainda não podem ser invocados (para streaming completo no app, a UI é a autoridade).
  • Tipos complexos: campos map aparecem como mapEntry aninhados; tipos referenciados indiretamente também são carregados.

Relacionado: Pre-URLs de ambiente e configuração TLS em concepts.