Ir al contenido principal

gRPC: protobuff (Protocol Buffers)

Los Protocol Buffers son mecanismos extensibles neutrales al idioma y a la plataforma para serializar datos estructurados.

Al compilar un archivo *.proto podemos elegir lenguajes como: Java, PHP, C#, Python y otros más.

Una definición de proto podría lucir así:

person.proto

message Person {
  optional string name = 1;
  optional int32 id = 2;
  optional string email = 3;
}

Y al generarse el código, por ejemplo en Java, la definición podría emplearse de la siguiente forma:

Person juan = Person.newBuilder()
    .setId(1234)
    .setName("Juan aldama")
    .setEmail("juan.aldama@spgf.dev.com")
    .build();
output = new FileOutputStream("salida.dat");
juan.writeTo(output);

Pero... ¿cómo instalamos Protobuf?

Para Windows podemos usar Chocolatey:

$ choco install protoc

Para Windows también podemos optar por descargar:

https://github.com/google/protobuf/releases

Extraer a C:\proto3 y crear la variable de entorno usando esta dirección: C:\proto3\bin

Para Linux podemos teclear:

$ sudo apt install -y protobuf-compiler

Comprobamos la instalación:

$ protoc --version

¿Y qué con los lenguajes de programación?

Si queremos usar Python con Protobuf debemos teclear esto para instalarlo:

$ pip install protobuf

Y esto es la forma para generar código Python usando Protobuf:

$ protoc --python_out=pyi_out:output_dir

Para crear un archivo *.proto es necesario saber que existen diferentes tipos de datos: los escalares numéricos como:

int32, int64, sint32, sint64, uint32, uint64, fixed32, fixed64, sfixed32, sfixed64, float, double

Además de otros tipos:

bytes, bool, string ...

Un archivo *.proto, por así decirlo, es similar a una clase Java, C++ o C# donde se específica el nombre de la "clase" y sus "atributos".

usuario.proto

message Usuario{
   string nombre = 1;
   optional string apellidos = 2;
   bool activo = 3;
   Direccion direccion = 4;
}

Puedes usar otras definiciones proto como miembros al importarlos a otro archivo. Crear tipos y enumeraciones similar a como se hace en lenguajes como Java, C/C++ y C#. Y así crear archivos relativamente complejos con una lógica bien definida.

En próximas entregas veremos ejemplos en

Si quisieramos generar código java del archivo person.proto teclearíamos:

protoc --java_out=java proto/person.proto

Si esto funcionó correctamente, tendremos nuestro código Java generado (PersonOuterClass.java). Más ejemplos en próximas entregas.

Enlaces:

https://protobuf.dev/

Comentarios

Entradas populares de este blog

Rocket: un framework web para Rust

Rocket Framework es: Un framework web escrito en Rust.   Inspirado en Rails, Flask, Bottle y Yesod.  Admite el manejo de solicitudes HTTP, Web Sockets, JSON, plantillas y más. Creando un proyecto con Rocket Framework En primer lugar, verificamos la instalación de Rust en nuestras máquinas: rustc - - version Continuamos con la configuración de Rust nightly como nuestra cadena de herramientas predeterminada ejecutando el comando: rustup default nightly Si lo prefieres, una vez que configuremos un directorio de proyecto en la siguiente sección, puedes usar anulaciones por directorio para usar la versión nocturna solo para tu proyecto Rocket ejecutando el siguiente comando en el directorio: rustup override set nightly Creamos nuevo proyecto `` hola-rocket `` y nos ubicamos en el directorio creado: cargo new hola - rocket - - bin cd hola - rocket Con Cargo, agregamos la dependencia de rocket: cargo add rocket Abrimos el archivo `` Cargo.toml `` Ca...

Odin language: el lenguaje de programación orientado a datos para un desarrollo de software sensato

En esta serie sobre lenguajes de programación hablamos de Odin , un lenguaje orientado a datos. Un nuevo lenguaje de programación que nos podrá recordar a lenguajes como C++, Python, Golang o hasta Rust. Instalación (Windows): 1 2 3 4 $ git clone https://github.com/odin-lang/Odin $ cd Odin $ git pull $ build.bat release Debemos asegurarnos de crear la variable de entorno: Nombre: ODIN_HOME Valor: C:\Users\HP\Documents\pruebasOdin\Odin Ejemplo 1. Como primer programa tendremos al clásico "Hola, mundo". holamundo.odin package holamundo import " core:fmt " main : : proc ( ) { fmt . println ( " ¡Hola, mundo desde Odin! " ) } Construimos: $ odin build holamundo . odin - file Ejecutamos: $ holamundo .exe Recordar que si usamos Visual Studio Code podemos instalar el plugin de Odin Language: https://marketplace.visualstudio.com/items?itemName=DanielGavin.ols Ejemplo 2. Programa que muestre las variables que pod...

Programación Windows Batch (CMD) parte 3

Crear ciclos para efectuar operaciones tediosas nos ahorrará tiempo para realizar otras tareas. En está ocasión veremos ciclos con FOR . ¿Cuál es la síntaxis de bucle FOR en Windows Batch? Si está dentro de un archivo *.bat : FOR %%variable IN (seq) DO operaciones Si lo ejecutamos en una terminal: FOR %variable IN (seq) DO operaciones Ejemplo 1 . Recorrer una secuencia de números del 0 al 5: recorrer.bat @ echo off FOR %%i in ( 0 1 2 3 4 5 ) DO echo Hola no. %%i pause Nos imprimirá en pantalla: Hola no. 0 Hola no. 1 Hola no. 2 Hola no. 3 Hola no. 4 Hola no. 5 ¿Puedo usar contadores? Si, se pueden usar. Ejemplo 2 . Uso de contadores: contador.bat @ echo off set numeros = 1 2 3 4 5 6 7 8 9 10 set cont = 0 for %%a in ( %numeros% ) do ( echo Hola no. %%a :: Contador set /a cont+ = 1 ) echo Total: %cont% Este código nos imprimirá, además de los mensajes Hola no. 0 ..., el total de valores conta...