Importar gRPC (.proto ou reflexão)
Dois caminhos levam a uma árvore gRPC no Restorm.
A partir de um ficheiro .proto
Section titled “A partir de um ficheiro .proto”Ficheiro ▸ Importar (Ctrl+I) e depois o ficheiro .proto. O conteúdo
colado também é reconhecido (presença de syntax = "proto…", ou de um service
com rpc).
| Elemento | O que o Restorm faz com ele |
|---|---|
Cada service | Uma pasta |
Cada rpc | Um pedido gRPC |
| Os indicadores de stream | O tipo de chamada (unary, server-stream, client-stream, bidirectional-stream) |
| A mensagem de entrada | Uma mensagem de exemplo pré-preenchida, construída a partir da forma da mensagem |
| Descrições e tipos | A documentação de API e as enumerações |
Por reflexão do servidor
Section titled “Por reflexão do servidor”Na janela de importação gRPC, indique o endereço host:port de um servidor em
funcionamento. O Restorm interroga o respetivo serviço de reflexão e constrói a
mesma árvore que a partir de um .proto.
Duas vantagens notáveis:
- Depois funciona sem ligação. O conjunto de descritores obtido é guardado em cada pedido criado: as chamadas funcionam mesmo que o servidor de reflexão já não esteja acessível.
- É ressincronizável. Voltar a ligar-se ao mesmo endereço é reconhecido como uma atualização da árvore existente e não como uma nova importação. Existe igualmente um botão Atualizar a partir da reflexão no separador do pedido.
Se o servidor não implementar a reflexão, o Restorm indica-o explicitamente:
importe então o .proto.
Atualizar
Section titled “Atualizar”O gRPC faz parte dos formatos ressincronizáveis, em ambos os modos. Consulte Atualizar a partir da origem.