gRPC

Vantagens do gRPC

Como pudemos ver, o gRPC tem várias vantagens sobre o modelo ReST tradicional:

Mais leve e mais rápido por utilizar codificação binária e HTTP/2
Multi plataforma com a mesma interface de contratos
Funciona em muitas plataformas com pouco ou nenhum overhead
O código é auto documentado
Implementação relativamente fácil depois do desenvolvimento inicial
Excelente para trabalhos entre times que não vão se encontrar, principalmente para definir contratos de projetos open source.

Problemas

Assim como toda a tecnologia, o gRPC não é uma bala de prata e não resolve todos os problemas, temos alguns defeitos:

O protobuf não possui um package manager para poder gerenciar as dependências entre arquivos de interface
Exige uma pequena mudança de paradigma em relação ao modelo ReST
Curva de aprendizado inicial é mais complexa
Não é uma especificação conhecida por muitos
Por conta de não ser muito conhecido, a documentação é esparsa
A arquitetura de um sistema usando gRPC pode se tornar um pouco mais complexa

O que são buffers de protocolo?

Os protobuf são o mecanismo extensível, neutro em termos de linguagem e plataforma do Google para serializar dados estruturados – pense em XML, mas menor, mais rápido e mais simples. Você define como deseja que seus dados sejam estruturados uma vez e, em seguida, pode usar o código-fonte gerado especial para escrever e ler facilmente seus dados estruturados de e para uma variedade de fluxos de dados e usando uma variedade de linguagens.

representação do Json no protobuf

message Pessoa{
    uint64 id = 1;
    string  = 2;
}

Json de pessoas

{
  "id": 1,
  "email:"hello@gmail.dev"
}

Encoding

Quando utilizamos o compilador do protobuf (chamado de protoc), podemos rodar o comando a seguir usando o nosso exemplo anterior: echo 'name: "Lucas";age: 26' | protoc --encode=Name name.proto > name.bin.

Isso vai criar um arquivo binário com o nome name.bin, se abrirmos o arquivo binário em um hex viewer (como o do VSCode), teremos a seguinte cadeia de bits:

compilando o protocolo

protoc --js_out=import_style=commonjs,binary:. ./pessoa.proto

O compilador vai criar um arquivo pessoa_pb.js que contém o código necessário para podermos serializar e desserializar nossos dados no formato binário usado pelo protobuf.

ao serializar o json vamos ter o resultado abaixo.

codigo serializar esta na no aquivo main.js no exemplo 1

  8,   1,  18, 15, 104, 101,
  108, 108, 111, 64, 103,  97,
  109, 105, 108, 46, 100, 101,
  118

Agora, vamos começar com a organização do arquivo, eu geralmente organizo um arquivo protobuf seguindo a ideia de Serviço -> Entidades -> Requests -> Responses. De acordo com as boas práticas da Uber, também é interessante utilizarmos um marcador de namespace como com.seuusername.notes.v1 caso precisemos manter mais de uma versão ao mesmo tempo, porém, para facilitar o desenvolvimento aqui, vamos utilizar a forma mais simples sem nenhum namespace.

Streaming

Além das que são chamadas Unary Calls, temos também Streaming calls, que nada mais são do que respostas e requisições realizadas por meio de uma stream de dados assíncrona. Temos três tipos de streaming calls no gRPC:

Serverside streaming: Quando a requisição é enviada de forma simples (unária), mas a resposta do servidor é uma stream de dados.
Clientside streaming: É o oposto da anterior, quando temos a requisição sendo enviada em forma de streams de dados e a resposta do servidor é unária.
Duplex streaming: Quando tanto a requisição quando a resposta são streams de dados.