在erlang项目中使用protobuf

在erlang项目中使用protobuf

http://blog.csdn.net/mycwq/article/details/21864191

protobuf是google的一个序列化框架，类似XML，JSON，其特点是基于二进制，比XML表示同样一段内容要短小得多，还可以定义一些可选字段，广泛用于服务端与客户端通信。文章将着重介绍在erlang中如何使用protobuf。

首先google没有提供对erlang语言的直接支持，所以这里使用到的第三方的protobuf库（erlang_protobuffs）

https://github.com/basho/erlang_protobuffs

定义一个protobuf结构，保存为test.proto，如下：

1. enum PhoneType {

2. 　　PhoneType_Home = 1;
3. PhoneType_Company = 2;
4. }
5. message Person {
6. required int32 age = 1;
7. required string name = 2;
8. }
9. message Other {
10. required PhoneType type = 1;
11. required string phone = 2;
12. }
13. message Family {
14. required int32 mainid = 1;
15. optional Other other = 2;
16. repeated Person person = 3;
17. }

编译这个protobuf结构，生成相应的erlang代码：

1. % 生成相应的erl和hrl文件
2. protobuffs_compile:generate_source("test.proto").
3. % 生成相应的beam和hrl文件
4. protobuffs_compile:scan_file("test.proto").

下面我们以例子简单说明如何使用：

1. -module(test).
2. -compile([export_all]).
3. -include("test_pb.hrl").
4. encode() ->
5. Person = #person{age=25, name="John"},
6. test_pb:encode_person(Person).
7. decode() ->
8. Data = erlang:iolist_to_binary(encode()),
9. io:format("Data is ~p~n", [Data]),
10. test_pb:decode_person(Data).
11. encode_repeat() ->
12. OtherData = #other{type='PhoneType_Company', phone="028-12345678"},
13. RepeatData =
14. [
15. #person{age=25, name="John"},
16. #person{age=23, name="Lucy"},
17. #person{age=2, name="Tony"}
18. ],
19. Family = #family{mainid=111, other=OtherData, person=RepeatData},
20. test_pb:encode_family(Family).
21. decode_repeat() ->
22. Data = erlang:iolist_to_binary(encode_repeat()),
23. io:format("Data is ~p~n", [Data]),
24. %test_pb:decode_family(Data).
25. FamilyData = test_pb:decode_family(Data),
26. {family, _, _, PersonData} = FamilyData,
27. io:format("~p~n", [FamilyData]),
28. io:format("Per Len is ~w~n~n", [length(PersonData)]),
29. parse_repeat(PersonData).
30. parse_repeat([]) ->
31. ok;
32. parse_repeat([H|T]) ->
33. if is_record(H, person) ->
34. 　　　　   io:format("age[~p],name[~p]~n", [H#person.age, H#person.name])
35. end,
36. parse_repeat(T).

运行代码，如下：

1. 5> c(test_pb).
2. {ok,test_pb}
3. 6> c(test).
4. {ok,test}
5. 7> test:encode().
6. [[["\b",[25]],[[18],[4],<<"John">>]]]
7. 8> test:decode().

8. Data is <<8,25,18,4,74,111,104,110>>
   {person,25,"John"}

9. 9> test:encode_repeat().

10. [[["\b","o"],
    [[18],[16],[[["\b",[2]],[[18],"\f",<<"028-12345678">>]]]],
    [[[26],"\b",[[["\b",[25]],[[18],[4],<<"John">>]]]],
    [[26],"\b",[[["\b",[23]],[[18],[4],<<"Lucy">>]]]],
    [[26],"\b",[[["\b",[2]],[[18],[4],<<"Tony">>]]]]]]]

11. 10> test:decode_repeat().

    Data is <<8,111,18,16,8,2,18,12,48,50,56,45,49,50,51,52,53,54,55,56,26,8,8,25,
    18,4,74,111,104,110,26,8,8,23,18,4,76,117,99,121,26,8,8,2,18,4,84,
    111,110,121>>
    {family,111,
    {other,'PhoneType_Company',"028-12345678"},
    [{person,25,"John"},{person,23,"Lucy"},{person,2,"Tony"}]}
    Per Len is 3

    age[25],name["John"]
    age[23],name["Lucy"]
    age[2],name["Tony"]
    ok

文章完整例子下载：http://download.csdn.net/detail/cwqcwk1/7087293