Définitions Protocol Buffers
Examinez une définition proto3 autonome sous forme d’arbre, de source mise en forme ou de structure JSON, en conservant ses numéros de champ.
Le code reste dans votre navigateur. Aucun import ni appel réseau n’est effectué.
Sous-ensemble proto3 dans un seul fichier. Sans imports, options personnalisées, compilation ni contrôle de compatibilité. Modifier la source réinitialise la racine.
Limites : 100 000 caractères UTF-16, 20 000 jetons, 2 000 déclarations, 32 niveaux ; délai de 8 secondes.
Résultat périmé. L’export est désactivé.
Le formatage Protobuf rend une définition compacte plus facile à relire, mais une indentation correcte ne garantit pas la validité du contrat. Un numéro réservé ou une référence inconnue peut encore s’y cacher. Les contrôles pris en charge sont donc exécutés avant de rendre les résultats exportables.
L’arbre expose les noms du fichier et les chemins complets des types. Le JSON Schema décrit, lui, une forme de données pour le message choisi. Gardez la définition d’origine pour les services, les réservations historiques et les comportements que cette projection ne représente pas.
Le formatage Protobuf conserve l’ordre des déclarations. Les références utilisent des noms complets : OuterA.Item et OuterB.Item restent deux types distincts. Une référence récursive apparaît comme un chemin, sans ouvrir une nouvelle branche à l’infini.
Un fichier peut contenir plusieurs messages. Le choix de la racine modifie le $ref principal, tandis que les définitions partagées restent dans $defs. Vous pouvez ainsi examiner les listes, les maps et les coordonnées mutuellement exclusives avant de les utiliser dans une intégration.
Le premier message du fichier est sélectionné par défaut. Un paquet, une énumération ou un service ne devient pas la racine. Choisissez un autre nom complet dans les options. Modifier la source réinitialise ce choix afin de ne pas conserver une référence à un type supprimé.
Développez les déclarations et revenez au code par leur numéro de ligne. L’arbre affiche les entrées visibles par lots de 50. L’export de structure contient toutes les déclarations, y compris celles qui sont repliées ou pas encore affichées ; le parcours n’altère pas le contrat.
La vérification automatique attend 350 ms après une modification. La désactiver fait apparaître le bouton principal et permet Ctrl/Cmd + Enter. Les exports périmés sont bloqués immédiatement. Exemple et Vider présentent un aperçu ; le retour à la version précédente restaure source et résultat.
L’indentation peut utiliser deux ou quatre espaces. Les commentaires et le contenu des chaînes restent intacts, même avec des accolades ou des points-virgules. Le nom, le numéro et l’ordre des champs sont conservés. La sortie est analysée une seconde fois pour comparer son descripteur à celui du fichier initial.
Les tags doivent être positifs, uniques dans un message et hors de la plage 19000–19999. Les réservations sont contrôlées même si elles suivent les champs. Une énumération proto3 commence par zéro ; les alias numériques nécessitent allow_alias. Ces vérifications concernent le fichier actuel, pas les anciennes versions du protocole.
L’arbre contient paquets, messages, enums, groupes oneof, services et RPC. Les références anticipées, imbriquées et récursives sont résolues sans dépendance externe. Un type introuvable bloque la génération. Les noms snake_case du code restent visibles même si leur représentation JSON utilise lowerCamelCase.
Le document JSON Schema 2020-12 référence des noms complets dans $defs. repeated produit un tableau, map un objet et int64 une chaîne. Un oneof autorise zéro ou un membre présent, jamais deux. Aucun champ ne devient obligatoire automatiquement, y compris ceux marqués optional.
Non. Un tag de message va de 1 à 536870911, en excluant 19000–19999, réservés à l’implémentation. Les enums suivent une règle différente : la première déclaration d’une énumération proto3 doit valoir zéro. Le contrôle distingue ces deux usages pour ne pas confondre un tag interdit avec une valeur d’énumération obligatoire.
Oui, les tags ne doivent pas être consécutifs. Un champ 1 suivi d’un champ 20 est valable en l’absence de conflit. La mise en forme ne referme pas cet intervalle et ne change pas l’ordre des champs. Utilisez reserved pour empêcher la réutilisation d’un ancien tag ; une simple absence de numéro ne mémorise pas cet historique.
Placez optional devant son type pour conserver une information explicite de présence dans le code généré. L’arbre montre ce choix. Le schéma JSON permet cependant l’absence des champs simples comme des champs optional ; il ne décrit ni la méthode has générée, ni la différence entre une valeur absente et une valeur par défaut renvoyée à l’exécution.
Une valeur numérique JavaScript ne représente pas exactement tous les entiers 64 bits. Les sorties ProtoJSON courantes utilisent donc des chaînes décimales. La projection suit cette forme sans conversion en Number. Le motif contrôle l’écriture, mais le respect exact de la plage signée ou non signée nécessite un contrôle supplémentaire.
Le compilateur recherche les fichiers par rapport à des racines d’import configurées. Ce panneau ne possède ni arborescence de fichiers ni résolveur de dépendances : il refuse chaque import. Vérifiez le projet complet avec protoc ou Buf. Aucun chemin n’est téléchargé ou ignoré pour fabriquer un succès apparent.
Une définition devrait être prise en charge ?
Le formatage Protobuf aide à examiner les déclarations prises en charge avant de rapporter la source et sa forme JSON au projet. La compilation finale demande toujours l’ensemble des dépendances.