gRPC

Una solicitud gRPC llama a un método de un servicio. Escribes el mensaje como JSON; Echolot lo codifica con la descripción del servicio, lo envía por HTTP/2 y muestra la respuesta como JSON junto con el estado de la llamada.

Crea una solicitud gRPCCopy Anchor Link

Elige Archivo › Nueva solicitud gRPC, o Nueva solicitud gRPC en el menú + junto a Solicitudes en la barra lateral. La dirección es el servidor, como http://localhost:50051 ({{grpcURL}} en Alpenglow), sin ruta.

El editor tiene estas pestañas: Docs, Mensaje, Cabeceras, Autenticación, Variables, Pruebas, Scripts y Ajustes. Las cabeceras son los metadatos de la llamada. Las llamadas gRPC son siempre POST, así que la insignia dice gRPC en lugar de un método.

Describe el servicioCopy Anchor Link

La pestaña Mensaje empieza por el lugar donde se describen los servicios:

• Un archivo .proto en la carpeta specs/ del espacio de trabajo, como specs/inventory.proto. Sus imports se leen de junto a él, y los tipos conocidos de google.protobuf no necesitan ningún archivo. Los archivos .proto se añaden y se editan en la página Especificaciones: consulta archivos proto.
• Reflexión del servidor: Echolot le pide al servidor sus servicios. El servidor tiene que ofrecer el servicio de reflexión. La llamada de reflexión va a la dirección de la solicitud con sus cabeceras, su autenticación y sus variables.

Elige Cargar para leer los servicios. Después elige el servicio y el método. Junto al método, Echolot muestra su tipo: unaria, streaming del servidor, streaming del cliente o streaming bidireccional.

Escribe el mensajeCopy Anchor Link

El mensaje es JSON, en la correspondencia JSON de protobuf, con {{variables}}:

{
  "sku": "TNT-MH-2P",
  "quantity": 1,
  "order_id": "{{orderId}}"
}

Ejemplo sustituye el mensaje por todos los campos de la entrada del método con un valor de ejemplo, incluidos los mensajes anidados, para que partas de ahí.

En la correspondencia JSON, los enteros de 64 bits son cadenas, los bytes son Base64, las enumeraciones son sus nombres, los mapas son objetos, y Timestamp, Duration, FieldMask, los wrappers, Struct y Any tienen sus formas JSON habituales. Una clave que el tipo de mensaje no tiene se rechaza, para que un error tipográfico no pase inadvertido.

Tipos de llamadaCopy Anchor Link

En Inventory › Watch stock, una llamada de streaming del servidor, el mensaje nombra los productos que vigilar y la respuesta es la lista de niveles de existencias que envió el servidor.

Estado, metadatos y trailersCopy Anchor Link

gRPC informa de cómo fue una llamada en su estado, que llega en los trailers después de los mensajes. El resumen de la respuesta lo muestra: OK en verde, o el estado y su código en rojo, como NOT_FOUND (5), con el número de mensajes recibidos y su compresión. La pestaña Cabeceras de la respuesta muestra las cabeceras de la respuesta.

Para comprobar el estado en las pruebas, añade una comprobación Estado gRPC en la pestaña Pruebas: es igual a OK por defecto, y acepta nombres (NOT_FOUND) o códigos (5). Consulta scripts y pruebas.

Compresión y plazoCopy Anchor Link

La insignia gRPC antes de la dirección es un menú:

• Comprimir mensajes: Ninguno, gzip o deflate. Las respuestas comprimidas se leen siempre, diga lo que diga este ajuste.
• Plazo: Sin límite, o 500 ms, 1 s, 5 s o 30 s. El plazo se envía al servidor, y una llamada que lo supera termina con DEADLINE_EXCEEDED.

TLS y certificadosCopy Anchor Link

Una dirección http:// llama al servidor por HTTP/2 sin TLS. Una dirección https:// usa TLS, con las reglas de certificados del espacio de trabajo, así que funcionan los certificados de CA personalizados y los certificados de cliente. Consulta ajustes de la solicitud.

Desde la línea de comandosCopy Anchor Link

echolot grpc describe lista los servicios y métodos de un servidor, y echolot grpc call hace una llamada y termina con 1 si el estado no es OK. Consulta echolot grpc.