Importar gRPC (.proto o reflexión)
Hay dos caminos que llevan a un árbol gRPC en Restorm.
Desde un archivo .proto
Section titled “Desde un archivo .proto”Archivo ▸ Importar (Ctrl+I) y después el archivo .proto. El contenido pegado
también se reconoce (presencia de syntax = "proto…", o de un service con rpc).
| Elemento | Lo que Restorm hace con él |
|---|---|
Cada service | Una carpeta |
Cada rpc | Una petición gRPC |
| Los indicadores de flujo | El tipo de llamada (unary, server-stream, client-stream, bidirectional-stream) |
| El mensaje de entrada | Un mensaje de ejemplo rellenado previamente, construido a partir de la forma del mensaje |
| Descripciones y tipos | La documentación de API y las enumeraciones |
Por reflexión del servidor
Section titled “Por reflexión del servidor”Desde la ventana modal de importación gRPC, indique la dirección host:port de un
servidor en funcionamiento. Restorm consulta su servicio de reflexión y construye el
mismo árbol que a partir de un .proto.
Dos ventajas notables:
- Después funciona sin conexión. El juego de descriptores obtenido se almacena en cada petición creada: las llamadas funcionan aunque el servidor de reflexión ya no esté alcanzable.
- Es resincronizable. Volver a conectarse a la misma dirección se reconoce como una actualización del árbol existente, no como una importación nueva. También existe un botón Actualizar desde la reflexión en la pestaña de petición.
Si el servidor no implementa la reflexión, Restorm lo indica explícitamente: importe
entonces el .proto.
Actualizar
Section titled “Actualizar”gRPC forma parte de los formatos resincronizables, en los dos modos. Consulte Actualizar desde el origen.