Do método declarado à chamada pela rede
O gRPC é um sistema de chamadas de procedimento remoto: uma aplicação chama métodos implementados por outro serviço e troca mensagens com ele. A definição do serviço especifica os métodos disponíveis e os tipos de entrada e de resposta.
No uso padrão com Protocol Buffers, essa definição fica em um arquivo .proto. A geração de código produz um cliente, também chamado de stub, que prepara as mensagens e realiza a comunicação. O servidor recebe a chamada e executa a implementação do método correspondente.
Uma consulta de estoque
Este exemplo didático declara um método unário, com uma mensagem de entrada e uma de resposta:
syntax = "proto3";
service Estoque { rpc Consultar (Consulta) returns (Saldo);}
message Consulta { string sku = 1;}
message Saldo { int32 unidades = 1;}O cliente envia o campo sku para identificar o item. A implementação de Consultar busca o estoque e devolve o campo unidades. Uma resposta com unidades: 12 informa o saldo retornado pelo servidor naquela consulta. O arquivo define a troca de mensagens, mas a lógica de consulta ao estoque precisa ser escrita no servidor.
Prazo e falhas da chamada
Você precisa definir quanto tempo o cliente aceita esperar pela resposta. O gRPC usa um prazo, chamado de deadline, e retorna DEADLINE_EXCEEDED ao cliente quando esse prazo é ultrapassado. Por padrão, o gRPC não define esse limite, como explica o guia de deadlines.
O erro por prazo vencido não comprova que o servidor deixou de executar o método. O ciclo de uma chamada gRPC permite que cliente e servidor tenham conclusões diferentes sobre a mesma execução. Em métodos que alteram registros, você precisa considerar esse comportamento ao implementar novas tentativas.
Dúvidas frequentes
Perguntas frequentes sobre gRPC
- Cliente e servidor precisam usar a mesma linguagem?
- Eles podem usar linguagens diferentes entre as suportadas pelo gRPC. Cada lado usa código compatível com a definição do serviço e com as mensagens trocadas.
- O gRPC exige Protocol Buffers?
- O Protocol Buffers é a opção padrão para definir serviços e serializar mensagens. O gRPC também pode trabalhar com outros formatos, conforme a implementação utilizada.
- Uma chamada gRPC sempre tem uma única resposta?
- Uma chamada unária envia uma mensagem e recebe uma mensagem. O gRPC também admite fluxos de mensagens enviados pelo cliente, pelo servidor ou nos dois sentidos.
Para continuar
Recursos relacionados
Documentação
gRPC: interfaces de cliente e servidor
Apresenta a definição de serviços, a geração do cliente e o uso padrão de Protocol Buffers.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Orientação técnica ao vivo para revisar o contrato de uma integração e investigar erros nas chamadas entre serviços.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
A implementação de integrações exige compreender o contrato do serviço e tratar os erros que uma chamada remota pode retornar.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.