RPC 框架之 Goole protobuf

Goole 的 protobuf  即 Protocol Buffers  是一个很好的RPC 框架，支持 c++ python  java 接下来进行官方文档的解读，然后你会对protobuf 会有一个很好的认识：

Protocol buffers  are language-neutral, platform-netural extensible mechanism for serializing strutctured data ,think xml . but smaller，faster . and simpler

You define how you want your data to be structured once 。then you can use special generated of soure code to easilly write and read your structured data

to and from a variety of data streams and using a variety of languages

即 protocol buffers 是一个语言中立，平台中立的 可扩展机制用于序列化结构化的数据,就像xml 一样，但是它的体积更小,更快，和更简单（放屁用的，难了谁学），

你需要定义一次你的什么样的数据结构,然后即就可以使用特殊生成的源代码去使用各种语言很轻松的读和写你的结构化数据进入到你的各种数据流中

Protocol buffers  currently supports generated code in java python ,Objective-C and c++ .With our new proto3 language version ,you can also work with Go ,Ruby ....with more

languages to come

Protocol buffers   当前支持 python .java ob c++ 代码的生成，在proto3 版本中，支持了GO Ruby 等更多语言；

java 如何使用之官方文档 tutorials ---指南，教程

the complete sample code for each application is also provided

在官网中每一个应用都提供了完整的例子代码

this tutorial  provides a basic java programmers's introduction to  working with protocol buffeers ,By walking through creating a　simple example application 。it shows you how to

　　　　　　1.Define meassage formats in a .proto file

　　　　　　2.Use the protocol buffer compiler

　　　　　　3.Use the java protocol  api to write and read message

这个指南提供了额一个基础的 java 程序在protobuf 运行介绍,通过建立一个简单的例子应用，展示你怎么去

　　　　　　1. 定义消息格式在你的。proto file 文件中

　　　　　　2. 使用protbuf 编译器

　　　　　　3.使用java api 去读写消息

How do you serialize and retrieve structured data like this ?  There are a few ways to solve this problem

那你怎么去序列化和收到结构化数据呢，这是一些方式去解决这些问题

1.use java Seralization  this is the default approach since it's build into the language ,but it has a host of well-known problems ，and also dosen't work very well  if you need to

share data with applications　written  in C++ or python

1.使用java 序列化，它是默认的方法，因为他是java 的内置的，但是它有很多已知的问题，所以如果你需要去分享数据和其他语言，它不能进行很好的工作就是不能用的意思

2.you can invent an ad-hoc way to encode the data items into a singal string 。such as encoding 4 ints as "12:3:-23：67"   this is a simple and flexible approach although

it dose require writing one-off encoding and parsing code and the parsing imposes a small run-time cost . this works best for enoding very small data

2.你可以发明一种 ad-hoc  的 方式去编码数据条目成为字符串 ，比如 编码4个整数 为12:3:-23；67  这是一个简单而且灵活的方式，虽然他需要编写一次性的编码和解析代码

以及 解析代码会强加一些运行时的损耗 ，所以如果编码小的数据的话，他可以很好的工作

3.Serialize the data to XML ,this approach can be very attractive since XML is (sort of) human readable and there are binding libraries for lots of languages .this  can be a good choice if you want to share date with other appliation/project  .  however XML is notoriously space intensive  and encoding/decoding it can impose a huge performance penalty

on application  also navigating an xml DOM tree is considerably more complicated than navigating simple fields in class normally would be

3.序列化data 成xml ，这个方法是非常有吸引力的，因为XML 是一个人类可读的和 在很多语言中都有关于XMl的绑定库 如果你想要和其他语言应用进行分享数据，这是一个很好的选择,然而 xml 是臭名昭著的占据空间 ,在应用中，它编解码会强加很多性能执行的坏处损耗，xml dom 树导航 是非常的复杂的比去遍历class字段

-----显然，上面3点都有自己的局限性，看protocolbuffers 给我们提供了什么？

Protocol buffers are flexible ,efficient automated solution to  solve exactly this problem, With Protocol buffers ,you writer a .proto description of data structure you wish to store

From that. protocol compiler creates a class that implemients automatic encoding and parsing of the protocol buffer data with an efficient binary format The generated class provides getter and setters as aunit ,importantly .the protocolbuf format supports the ideas of extending the format over time in such a way that the code can still read data

encoded with the old format

protocol buffers 是一个灵活的 有效的自动化解决方案去正确的解决这个问题(上面的三点),对于Protocol buffers 你可以写一个你希望存储的结构化描述proto  文件

针对这个文件，protocol 编译器会生成一个class文件 自动实现了在有效的的二进制protocol buffer 数据格式中进行编码与解码  生成的class 提供了get set 方法 

重要的是 protocolbuf  格式支持一个思想就是 这个格式随着时间的推移，这些code 仍然可以读取数据，用旧的格式编码

------接下来就是 .pro文件改如何编写，官网有很好的例子：

The proto file starts with a package declaration .which helps to prevent naming conflicts between different project  。the package name is used as the java package unless you

have explicitly  specified a java_package  . as we have here  even if  you do provide a java_package .you should still define  a normal package  as well to avoid name collisions

in the protocol buffers name space as well as in no java languages

proto 文件以一个包名声明开始，它是用来去阻止在不同的工程中的命名冲突，这个包名被用作java  的包 除非你已经明确指定了一个 java_package，但是呢， 尽管你已经提供了一个java_package，你也应该仍然定义一个 正常的包名来避免在protobuf 命名空间中的命名冲突 在不是java 环境下的

　　说白了,我们开发中，必须定义package 与 java_package ，包名以java_package  为准

The =1，=2 markers on each element identify the unique 'tag' that field uses in the binary encoding .  tag-numbers 1-15 require one less byte to encode than height number