Thrift binary protocol - Revision history

Effect2: Removed no-longer-relevant (after further research in the course of writing the page) remark

2019-05-20T05:25:48Z

Removed no-longer-relevant (after further research in the course of writing the page) remark

Effect2: Added :Category:Apache

2019-05-20T05:24:20Z

Effect2: Created page with "{{FormatInfo |formattype=electronic |subcat=Serialization |released=2007 }} Apache Thrift, a serialization/RPC system with much more emphasis on RPC than serialization, ca..."

2019-05-20T05:21:51Z

Created page with "{{FormatInfo |formattype=electronic |subcat=Serialization |released=2007 }} Apache Thrift, a serialization/RPC system with much more emphasis on RPC than serialization, ca..."

New page

{{FormatInfo
|formattype=electronic
|subcat=Serialization
|released=2007
}}
Apache Thrift, a [[serialization]]/RPC system with much more emphasis on RPC than serialization, calls its serialization formats "protocols"; the oldest Thrift-specific protocol is the "'''binary"''' protocol, while the newer one is the "[[Thrift compact protocol|compact]]" protocol.<ref>https://thrift.apache.org/docs/concepts#protocol</ref>

== Identification ==
In the new<ref name="commit">Commit 589859984f43af1ed0f9ee45ce8374a0d1640813</ref> ("strict") header type, binary protocol files start with a one-byte message type, a zero byte, and then the version indicator <code>0x01 0x00 0x00 0x08</code>.<ref>Thrift source → /lib/java/src/org/apache/thrift/protocol/TBinaryProtocol.java → definition of VERSION_MASK and VERSION_1, and of writeMessageBegin(). https://stackoverflow.com/questions/8402479/error-while-compiling-thrift-server indicates that the version/size integer is presumably stored [[endianness|little-endian]].</ref>. (This version indicator has been steady since at least as far back as 2011.) This is followed by an encoded string (a 32-bit length and series of bytes) and a 32-bit sequence ID.<ref>Thrift source → /lib/java/src/org/apache/thrift/protocol/TBinaryProtocol.java → readMessageBegin(); /lib/java/src/org/apache/thrift/protocol/TMessage.java</ref>

In the old<ref name="commit" /> (non-"strict") header type, the message begins with the encoded string of the message name, followed by the type byte, followed by a 32-bit sequence ID.<ref>Thrift source → /lib/java/src/org/apache/thrift/protocol/TBinaryProtocol.java → readMessageBegin()</ref>

== Links ==
* [https://thrift.apache.org/ Thrift website]
* [https://thrift.apache.org/static/files/thrift-20070401.pdf The original Thrift description]
* [https://thrift.apache.org/docs/concepts#protocol A brief description of protocols]

== References ==
<references />

[[Category:Facebook]]

← Older revision		Revision as of 05:24, 20 May 2019
Line 19:		Line 19:
	<references />		<references />

		+	[[Category:Apache]]
	[[Category:Facebook]]		[[Category:Facebook]]

@@ Line 7: / Line 7: @@
 == Identification ==
-In the new<ref name="commit">Commit 589859984f43af1ed0f9ee45ce8374a0d1640813</ref> ("strict") header type, binary protocol files start with a one-byte message type, a zero byte, and then the version indicator <code>0x01 0x00 0x00 0x08</code>.<ref>Thrift source → /lib/java/src/org/apache/thrift/protocol/TBinaryProtocol.java → definition of VERSION_MASK and VERSION_1, and of writeMessageBegin(). https://stackoverflow.com/questions/8402479/error-while-compiling-thrift-server indicates that the version/size integer is presumably stored [[endianness|little-endian]].</ref>. (This version indicator has been steady since at least as far back as 2011.) This is followed by an encoded string (a 32-bit length and series of bytes) and a 32-bit sequence ID.<ref>Thrift source → /lib/java/src/org/apache/thrift/protocol/TBinaryProtocol.java → readMessageBegin(); /lib/java/src/org/apache/thrift/protocol/TMessage.java</ref>
+In the new<ref name="commit">Commit 589859984f43af1ed0f9ee45ce8374a0d1640813</ref> ("strict") header type, binary protocol files start with a one-byte message type, a zero byte, and then the version indicator <code>0x01 0x00 0x00 0x08</code>.<ref>Thrift source → /lib/java/src/org/apache/thrift/protocol/TBinaryProtocol.java → definition of VERSION_MASK and VERSION_1, and of writeMessageBegin(). https://stackoverflow.com/questions/8402479/error-while-compiling-thrift-server indicates that the version/size integer is presumably stored [[endianness|little-endian]].</ref>. This is followed by an encoded string (a 32-bit length and series of bytes) and a 32-bit sequence ID.<ref>Thrift source → /lib/java/src/org/apache/thrift/protocol/TBinaryProtocol.java → readMessageBegin(); /lib/java/src/org/apache/thrift/protocol/TMessage.java</ref>
 In the old<ref name="commit" /> (non-"strict") header type, the message begins with the encoded string of the message name, followed by the type byte, followed by a 32-bit sequence ID.<ref>Thrift source → /lib/java/src/org/apache/thrift/protocol/TBinaryProtocol.java → readMessageBegin()</ref>