Protobuf y definiciones de servicios

gRPC es un framework de RPC de alto rendimiento basado en HTTP/2 y Protocol Buffers. En Rust, el crate tonic implementa gRPC de extremo a extremo.

Protobuf es el lenguaje de definición de interfaces (IDL). Describa los mensajes y servicios una sola vez en un archivo .proto, y los generadores de código producirán stubs de cliente y servidor con tipos estáticos.

Cada archivo proto declara una versión de sintaxis y un paquete. El paquete pone los tipos generados en un espacio de nombres y evita colisiones.

Use proto3 con tonic. Tras la generación, el nombre del paquete se asigna a una ruta de módulo de Rust.

Un mensaje es un registro tipado. Cada campo tiene un tipo, un nombre y un número de campo único que se utiliza para la codificación en el cable.

Los números de campo deben ser estables: nunca reutilice ni renumere un campo cuando ya existan datos, o romperá la compatibilidad.

Los escalares de Protobuf se asignan a tipos de Rust mediante prost. string se convierte en String, int32 en i32, bool en bool y bytes en Vec<u8>.

En proto3, cada escalar tiene un valor predeterminado (cadena vacía, 0, false); no son opcionales salvo que se marquen como tales.

Un service agrupa métodos RPC. Cada rpc declara un nombre de método, un mensaje de solicitud y un mensaje de respuesta.

tonic genera un trait de servidor y una estructura de cliente a partir de este bloque. Implementar el trait es la forma de proporcionar el comportamiento.

gRPC admite cuatro formas de streaming: unaria, streaming del servidor, streaming del cliente y streaming bidireccional.

Indique un stream con la palabra clave stream en el lado de la solicitud, en el de la respuesta o en ambos.

Las enumeraciones están respaldadas por enteros. En proto3, el primer valor debe tener el número 0 y actúa como valor predeterminado.

prost genera una enumeración de Rust y funciones auxiliares para convertir desde el i32 subyacente, ya que pueden llegar valores desconocidos a través del cable.

Un campo repeated es una lista y se asigna a Vec<T> en Rust. Los mensajes pueden anidarse o referenciarse por nombre.

Esto permite modelar colecciones y cargas útiles compuestas sin una complejidad adicional.

Para los métodos que no reciben ni devuelven nada, importe google/protobuf/empty.proto y use Empty.

Otros tipos conocidos son Timestamp y Duration. tonic incluye estas definiciones para que pueda importarlas en su compilación.

Incluir una versión en el paquete, como greeter.v1, permite evolucionar una API de forma segura. Un cambio incompatible se incorpora a greeter.v2, mientras v1 sigue atendiendo solicitudes.

Esta convención mantiene limpios los módulos de Rust generados: greeter::v1 y greeter::v2 coexisten.

Añadir un campo nuevo con un número sin usar es compatible con versiones anteriores; los clientes antiguos lo ignoran. Eliminar un campo es arriesgado, a menos que reserve su número y su nombre.

Reservarlo impide que alguien reutilice el número de un campo retirado y corrompa la decodificación.

Compruebe su comprensión de las definiciones de servicios de proto3.

Ha definido servicios y mensajes en proto3: números de campo estables, correspondencias de escalares con Rust, enumeraciones, campos repetidos y anidados, las cuatro formas de RPC, tipos conocidos y control de versiones mediante paquetes.

A continuación convertirá estas definiciones en código de Rust con tonic-build.