Cómo leer una definición .proto en el navegador

Pega una definición Protocol Buffers y pulsa Inspeccionar localmente: la página enumera lo que puede leer del texto — la línea de sintaxis, el paquete, cada mensaje con sus campos en el orden del archivo, las enumeraciones con sus valores, los grupos oneof y los servicios gRPC con sus métodos, marcando las llamadas en streaming. Para el primer mensaje del archivo se construye un ejemplo JSON estructural. No se compila ni se sube nada: sin protoc, sin llamada gRPC, sin ida y vuelta al servidor.

El analizador lee texto proto2 y proto3 igual, por patrones, así que devuelve lo que está escrito y no lo que protoc haría con ello. Con el panel de red del navegador abierto, inspeccionar una definición no genera ninguna petición; el resumen, los contadores y la tabla se rellenan dentro de la pestaña.

Pega tu definición en el cuadro o pulsa Cargar ejemplo para partir del archivo incluido: un mensaje User con tres campos y un servicio Users con una RPC, que los contadores informan como 1 messages, 0 enums, 1 services y 4 fields / RPCs.
Pulsa Inspeccionar localmente y lee el Resumen del protocolo desde arriba: syntax = "proto3", el nombre del paquete y después cada mensaje con sus campos tal como están escritos — map<string, string> metadata = 4;, optional string idempotency_key = 11; y las opciones de campo, conservadas literalmente.
Revisa la tabla de abajo. Cada campo, enumeración y RPC ocupa una fila: un campo map se lee map<string, string> · tag 4, un mensaje anidado aparece con su nombre con puntos, como Wrapper.Inner, y un método en streaming se muestra como WatchRequest → stream CaptureResponse.
Usa Copiar para llevar todo el resumen al portapapeles — el bloque se copia tal cual, comprobado desde el clic hasta el pegado — o Limpiar para vaciar el cuadro, el resumen, los contadores y la tabla de una vez.

Qué cubre el resumen y qué deja fuera el analizador

El ejemplo JSON sigue la codificación de proto3

Los valores se tipan como los codifica proto3 JSON: un campo string recibe "example", int64 y uint64 pasan a la cadena "0", bytes pasa a "base64-data", bool a true y un campo repeated es un array de un elemento. Un campo map se convierte en un objeto con una clave de relleno, y un campo de tipo mensaje se expande en su propio objeto anidado.

Un campo de enumeración toma el primer valor declarado en esa enumeración, así que un campo Currency queda como "CURRENCY_UNSPECIFIED" en lugar de un número. Un mensaje que se referencia a sí mismo se corta en un objeto vacío, lo que mantiene finito el ejemplo, y solo el primer mensaje del archivo recibe ejemplo: si te interesa otro tipo, súbelo al principio.

Tipos de campo que vienen de otro sitio

Cuando un tipo de campo no está declarado en el texto pegado — google.protobuf.Timestamp, por ejemplo, o un mensaje de un import — el ejemplo muestra un objeto vacío y el panel añade un aviso como «1 field type(s) come from imported or external definitions». El nombre del tipo sigue apareciendo en el resumen y en la tabla.

La herramienta nunca descarga ese archivo importado: una línea import no cambia la salida y ninguna petición sale de la página. Toma el ejemplo como un boceto estructural que contrastar con el esquema real, no como una carga útil lista para enviar a un servidor.

Qué lee el analizador y qué ignora

Los comentarios se omiten, tanto // como /* */, y los caracteres dentro de un literal de cadena no se interpretan, de modo que un valor por defecto como [default = "{"] se lee bien. Un mensaje anidado se convierte en una entrada propia con nombre punteado, y el mensaje contenedor solo enumera los campos declarados directamente en él.

Algunas líneas se dejan fuera a propósito: las declaraciones reserved, los rangos extensions, las opciones de archivo como option java_package = "com.acme"; y las líneas import. No aparecen ni en el resumen ni en la tabla ni en los contadores: la salida describe solo mensajes, enumeraciones, campos y RPC.

Errores, límites y tamaño de archivo

Un texto sin declaración de mensaje, enumeración o servicio termina con «No message, enum or service declaration was found in this .proto text.», y un bloque sin cerrar termina con el nombre del bloque, como «Unclosed message block: User». Leer por patrones implica además que no hay validación de nivel protoc: un número de campo repetido, la etiqueta 0 y una etiqueta del rango reservado 19000–19999 se listan sin objeción.

La salida enumera todo lo que encuentra, así que crece con el archivo: 305 KB con 600 mensajes dieron 12.200 filas en torno a un tercio de segundo, y 1,5 MB con 3.000 mensajes y 60.200 filas terminaron en menos de dos segundos en Chrome. Una fila de enumeración muestra sus primeros 12 valores y luego puntos suspensivos, mientras el resumen los imprime todos.