Protobuf - Revision history

ZAKARITOURE.ISMAEL at 11:51, 12 April 2016

2016-04-12T11:51:35Z

← Older revision		Revision as of 11:51, 12 April 2016
Line 80:		Line 80:
	==Java==		==Java==

			===Utilisation===
⚫	~~With~~ Maven : http://stackoverflow.com/questions/1578456/integrate-protocol-buffers-into-maven2-build
			L'utilisation est à peu près similaire : on commence par compiler
			<pre>
			protoc -I=$SRC_DIR --java_out=$DST_DIR $SRC_DIR/messages.proto
			</pre>
			Ceci génère un fichier MessageProto.java qui fourni tous les outils nécessaires aux encodage et décodage.

			Des exemples détailler se trouvent ici[https://developers.google.com/protocol-buffers/docs/javatutorial#parsing-and-serialization ici].

		⚫	Avec Maven : http://stackoverflow.com/questions/1578456/integrate-protocol-buffers-into-maven2-build

	=Conversion=		=Conversion=

2016-04-12T11:27:16Z

← Older revision		Revision as of 11:27, 12 April 2016
Line 68:		Line 68:

	===Utilisation===		===Utilisation===
			Avec Python, il s'agit dans un premier temps de compiler les buffers (''ProtoBuf'') à partir des ''messages.proto'' prédéfinis:
	<pre>		<pre>
			protoc -I=$SRC_DIR --python_out=$DST_DIR $SRC_DIR/messages.proto
	</pre>		</pre>
			Il suffit ensuite d'utiliser :
⚫	https://developers.google.com/protocol-buffers/docs/pythontutorial
			*SerializeToString(): pour '''sérialiser''' le message et retourner un type ''String''.
			*ParseFromString(data): pour '''parser''' le message à partir d'un type ''String''.

		⚫	Des exemples détailler se trouvent ici[https://developers.google.com/protocol-buffers/docs/pythontutorial ici].

	==Java==		==Java==

2016-04-12T11:13:25Z

Conversion

← Older revision		Revision as of 11:13, 12 April 2016
Line 78:		Line 78:
	=Conversion=		=Conversion=

	Il existe plusieurs méthode et outils de conversion des 'JSON'' en ''ProtoBuf''.<br>		Il existe plusieurs méthode et outils de conversion des 'JSON'' en ''ProtoBuf'' et vis-versa.<br>

		⚫	Une méthode de conversion consiste à utiliser [https://code.google.com/archive/p/protobuf-java-format/ protobuf-java-format].<br>
	==''ProtoBuf'' to ''JSON''==
			Voici Un exemple de conversion de ''ProtoBuf'' vers ''JSON'' :

	Une méthode de conversion de ''ProtoBuf'' vers ''JSON'' consiste à utiliser [https://code.google.com/archive/p/protobuf-java-format/ protobuf-java-format] ainsi :
	<pre>		<pre>
	JsonFormat.printToString(protoMessage)		JsonFormat.printToString(protoMessage)
	</pre>		</pre>
	~~Protobuf~~ ~~<-->~~ ~~JSON,~~ ~~XML :~~ https://code.google.com/archive/p/protobuf-java-format/		D'autres exemples ont disponibles [https://code.google.com/archive/p/protobuf-java-format/ ici]


	==''JSON'' to ''ProtoBuf''==

⚫	Une méthode de conversion ~~de ''ProtoBuf'' vers ''JSON''~~ consiste à utiliser [https://code.google.com/archive/p/protobuf-java-format/ protobuf-java-format]
	Protobuf <--> JSON, XML : https://code.google.com/archive/p/protobuf-java-format/

2016-04-12T11:07:29Z

@@ Line 53: / Line 53: @@
 })
 </pre>
-''Décodage :''
+'''Décodage :'''
 <pre>
 var obj = messages.Test.decode(buf)
@@ Line 64: / Line 64: @@
 ==Python==
-Un guide d'installation détaillé se trouve [https://github.com/google/protobuf/tree/master/python ici]
+Un guide d'installation détaillé se trouve [https://github.com/google/protobuf/tree/master/python ici].
 https://developers.google.com/protocol-buffers/docs/pythontutorial
@@ Line 72: / Line 77: @@
 =Conversion=
 Protobuf <--> JSON, XML : https://code.google.com/archive/p/protobuf-java-format/

2016-04-12T10:54:03Z

Python

← Older revision		Revision as of 10:54, 12 April 2016
Line 63:		Line 63:

	==Python==		==Python==

			Un guide d'installation détaillé se trouve [https://github.com/google/protobuf/tree/master/python ici]
	https://developers.google.com/protocol-buffers/docs/pythontutorial		https://developers.google.com/protocol-buffers/docs/pythontutorial

2016-04-12T10:46:29Z

← Older revision		Revision as of 10:46, 12 April 2016
Line 35:		Line 35:

	===Utilisation===		===Utilisation===
	Soit un fichier '''test.proto'''		Soit un fichier ''test.proto''
	<pre>		<pre>
	message Luminosité {		message Luminosité {
	required int intensité = 50; // La propiété "intensité" est obligatoire.		required int intensité = 50; // La propiété "intensité" est obligatoire.
	optional string type = "solaire"; // La propiété "type" est optionnelle.		optional string type = "solaire"; // La propiété "type" est optionnelle.
	}		}
	</pre>		</pre>
	''Encodage :''		'''Encodage :'''
	<pre>		<pre>
	var protobuf = require('protocol-buffers')		var protobuf = require('protocol-buffers')

2016-04-12T10:41:01Z

@@ Line 29: / Line 29: @@
 ===Installation===
-Rine de plus simple pour l'intaller:
+Rien de plus simple pour l'installer:
 <pre>
  npm install protocol-buffers
@@ Line 35: / Line 35: @@
 ===Utilisation===
-Soit un fichier test.proto
+Soit un fichier '''test.proto'''
 <pre>
 </pre>
 https://www.npmjs.org/package/node-protobuf

2016-04-12T10:31:30Z

Node.js

← Older revision		Revision as of 10:31, 12 April 2016
Line 27:		Line 27:

	==Node.js==		==Node.js==

			===Installation===
			Rine de plus simple pour l'intaller:
			<pre>
			npm install protocol-buffers
			</pre>

			===Utilisation===
			Soit un fichier test.proto
			<pre>
			</pre>
	https://www.npmjs.org/package/node-protobuf		https://www.npmjs.org/package/node-protobuf

2016-04-12T10:16:34Z

API

← Older revision		Revision as of 10:16, 12 April 2016
Line 11:		Line 11:

	''ProtoBuf'' ou ''Protocol Buffers'' est un sérialisateur de structures de données. Il implique dans un premier temps, l'utilisation d'une "Interface de Description de ''Message''" qui décrit la structure de données à sérialiser. Il implique dans un second temps, l'utilisation d'un programme (compilateur) générant le code source à partir de ces description. Ce code source est utilisé pour créer et parser des flux de données au format décrit par les messages.<br/>		''ProtoBuf'' ou ''Protocol Buffers'' est un sérialisateur de structures de données. Il implique dans un premier temps, l'utilisation d'une "Interface de Description de ''Message''" qui décrit la structure de données à sérialiser. Il implique dans un second temps, l'utilisation d'un programme (compilateur) générant le code source à partir de ces description. Ce code source est utilisé pour créer et parser des flux de données au format décrit par les messages.<br/>
	''Exemple de description de Message :''		'''Exemple de description de Message :'''
	<pre>		<pre>
	message Luminosité {		message Luminosité {

2016-04-12T10:15:44Z

← Older revision		Revision as of 10:15, 12 April 2016
Line 9:		Line 9:

	=API=		=API=

			''ProtoBuf'' ou ''Protocol Buffers'' est un sérialisateur de structures de données. Il implique dans un premier temps, l'utilisation d'une "Interface de Description de ''Message''" qui décrit la structure de données à sérialiser. Il implique dans un second temps, l'utilisation d'un programme (compilateur) générant le code source à partir de ces description. Ce code source est utilisé pour créer et parser des flux de données au format décrit par les messages.<br/>
			''Exemple de description de Message :''
			<pre>
			message Luminosité {
			required int intensité = 50; // La propiété "intensité" est obligatoire.
			optional string type = "naturelle"; // La propiété "type" est optionnelle.
			}

			message Humidité {
			required double taux = 60.0; // La propiété "taux" est obligatoire.
			optional string lieu = "sol"; // La propiété "lieu" est optionnelle.
			}
			</pre>

			La conception de ''Protobuf'' par Google s'est axée sur un usage interne. Cependant plusieurs compilateurs pour différents langages (C++, C#, Python, Java, Ruby, NodeJS, etc.) ont été développé et mis à disposition sous licence gratuite. Voici quelques exemples d'usages pour les langages Node.js, Python et Java.

	==Node.js==		==Node.js==