{"id":1247,"date":"2017-05-30T17:04:34","date_gmt":"2017-05-30T17:04:34","guid":{"rendered":"http:\/\/www.testingdocs.com\/questions\/?p=1247"},"modified":"2024-09-04T15:39:21","modified_gmt":"2024-09-04T15:39:21","slug":"what-are-protocol-buffers","status":"publish","type":"post","link":"https:\/\/www.testingdocs.com\/questions\/what-are-protocol-buffers\/","title":{"rendered":"What are Protocol Buffers?"},"content":{"rendered":"

What are Protocol Buffers?<\/h2>\n

Protocol buffers a.k.a Protobufs are Google’s language-neutral, platform-neutral, extensible mechanism for serializing structured data. When you compare Protobuf with other serialization formats like XML and JSON, Protobufs are smaller, faster, and simpler. You can use Protobufs with many programming languages like Java,C#, C++, Python etc.<\/p>\n

You need to define your messages in .proto file with the protocol buffers language syntax. ( proto3 or proto2 syntax)<\/p>\n

For Example, Explicit ‘optional’ labels are disallowed in the Proto3 syntax. To define ‘optional’ fields in Proto3, simply remove the ‘optional’ label, as fields are ‘optional’ by default. Required fields are not allowed in proto3.<\/p>\n

More information can be found at Official Protocol Buffer github repository :<\/p>\n

https:\/\/github.com\/google\/protobuf<\/a><\/p>\n

Working with protocol buffers.<\/strong><\/h3>\n

Basic steps involved in working with PBs are as follows:<\/p>\n

Step: Define message formats in a .proto file.<\/p>\n

syntax = \"proto3\";\r\n\r\npackage com.testingdocs.messages;\r\n\r\noption java_package = \"com.testingdocs.proto\";\r\noption java_outer_classname = \"PersonProto\";\r\n\r\nmessage Person {\r\n\r\nrequired string name = 1;\r\n required int32 id = 2;\r\n optional string email = 3;\r\n \r\n}<\/pre>\n
 <\/p>\n
Step: Download the compiler from here:<\/p>\n
https:\/\/github.com\/google\/protobuf\/releases\/tag\/v3.3.0<\/a><\/p>\n
Use the protocol buffer compiler ( protoc ).<\/p>\n
Example sample command : dots in the command denote preset directory for -I\u00a0 and –java_out parameters. You can specify the source directories.<\/p>\n
\/> protoc.exe -I=. –java_out=. person.proto<\/p>\n
Step: Use the Java PB API to read\/write messages.<\/p>\n
Protocol Buffer Maven dependency for Java:<\/strong><\/h3>\n
<!-- https:\/\/mvnrepository.com\/artifact\/com.google.protobuf\/protobuf-java -->\r\n<dependency>\r\n <groupId>com.google.protobuf<\/groupId>\r\n <artifactId>protobuf-java<\/artifactId>\r\n <version>3.3.1<\/version>\r\n<\/dependency>\r\n\r\n\r\n<\/pre>\n
 <\/p>\n
\"Google<\/pre>\n
<\/h3>\n
Sample Java Program:<\/strong><\/h3>\n
import java.io.FileOutputStream;\r\n\r\nimport com.testingdocs.proto.PersonProto.Person;\r\n\r\npublic class ProtoBufferExample {\r\n \r\n public static void main(String[] args) throws Exception {\r\n FileOutputStream output;\r\n Person surendra = Person.newBuilder()\r\n .setId(007)\r\n .setName(\"S Kumar\")\r\n .setEmail(\"email@testingdocs.com\")\r\n .build();\r\n output = new FileOutputStream(\"ProgramOutput.txt\");\r\n surendra.writeTo(output);\r\n output.close();\r\n }\r\n\r\n}<\/pre>\n
 <\/p>\n","protected":false},"excerpt":{"rendered":"
What are Protocol Buffers? Protocol buffers a.k.a Protobufs are Google’s language-neutral, platform-neutral, extensible mechanism for serializing structured data. When you compare Protobuf with other serialization formats like XML and JSON, Protobufs are smaller, faster, and simpler. You can use Protobufs with many programming languages like Java,C#, C++, Python etc. You need to define your messages […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-1247","post","type-post","status-publish","format-standard","hentry","category-automation","has-post-title","has-post-date","has-post-category","has-post-tag","has-post-comment","has-post-author",""],"_links":{"self":[{"href":"https:\/\/www.testingdocs.com\/questions\/wp-json\/wp\/v2\/posts\/1247","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.testingdocs.com\/questions\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.testingdocs.com\/questions\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.testingdocs.com\/questions\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.testingdocs.com\/questions\/wp-json\/wp\/v2\/comments?post=1247"}],"version-history":[{"count":6,"href":"https:\/\/www.testingdocs.com\/questions\/wp-json\/wp\/v2\/posts\/1247\/revisions"}],"predecessor-version":[{"id":24186,"href":"https:\/\/www.testingdocs.com\/questions\/wp-json\/wp\/v2\/posts\/1247\/revisions\/24186"}],"wp:attachment":[{"href":"https:\/\/www.testingdocs.com\/questions\/wp-json\/wp\/v2\/media?parent=1247"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.testingdocs.com\/questions\/wp-json\/wp\/v2\/categories?post=1247"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.testingdocs.com\/questions\/wp-json\/wp\/v2\/tags?post=1247"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}