gRPC

Clic derecho en el árbol ▸ Añadir ▸ Petición gRPC.

Configuración

Campo	Función
URL	host:port del servidor
Servicio / Método	El servicio y la RPC invocada
Tipo de llamada	unary, server-stream, client-stream, bidirectional-stream
Mensaje de la petición	El mensaje, en JSON
Metadatos	Los pares clave / valor transmitidos con la llamada (es ahí donde viajan las credenciales)

De dónde viene la definición del servicio

Tres orígenes posibles, por orden de prioridad:

1. un juego de descriptores obtenido por reflexión del servidor: es lo que coloca la importación por reflexión, y prevalece sobre el resto;
2. el contenido .proto en línea, almacenado en el proyecto;
3. una ruta a un .proto en el disco.

La primera opción tiene una consecuencia práctica importante: una petición importada por reflexión sigue funcionando sin conexión, sin que el servidor esté alcanzable.

Importar por reflexión

Desde la ventana modal de importación gRPC, indique host:port: Restorm consulta el servicio de reflexión, carga los descriptores y construye el árbol: una carpeta por servicio, una petición por RPC, con un mensaje de ejemplo.

Volver a conectarse a la misma dirección se reconoce como una resincronización y actualiza el árbol existente en lugar de duplicarlo.

Si el servidor no implementa la reflexión, Restorm lo indica explícitamente: importe entonces el .proto. Consulte Importar un .proto gRPC.

Transportes

Hay tres transportes disponibles:

Transporte	Cuándo usarlo
grpc (por defecto)	gRPC nativo sobre HTTP/2
grpc-web	Servidor detrás de un proxy gRPC-Web
connect	Servidor Connect-RPC

Llamadas en flujo

En los tres modos en flujo, el panel de respuesta muestra los mensajes de forma continua. En un escenario, use las acciones Conexión gRPC, Envío gRPC y Cierre gRPC: la conexión permanece abierta entre las cajas, cada mensaje recibido emite un evento y el cierre efectúa el cierre parcial del lado del cliente.

Modo servidor

Restorm sabe alojar un servidor gRPC de simulación: una lista de métodos simulados, cada uno con su mensaje de respuesta (un arreglo JSON para un flujo), su código de estado, sus metadatos finales, o un script. La reflexión del servidor se expone por defecto, y TLS se configura mediante certificado y clave en formato PEM. Consulte Simular una API gRPC.

Fragmentos de código

Catorce destinos: grpcurl, grpc_cli, grpcurl en gRPC-Web, curl en Connect-RPC, JavaScript y TypeScript (@grpc/grpc-js), Python (grpcio), Go, Java (grpc-java), C# (Grpc.Net.Client), Ruby, Rust (tonic), Kotlin (grpc-kotlin), Swift (grpc-swift).