{"id":1526,"date":"2017-11-17T17:00:49","date_gmt":"2017-11-17T09:00:49","guid":{"rendered":"http:\/\/39.100.100.179\/?p=1526"},"modified":"2017-11-17T17:00:49","modified_gmt":"2017-11-17T09:00:49","slug":"protobuf%e8%af%ad%e8%a8%80%e6%8c%87%e5%8d%97-proto%e6%96%87%e4%bb%b6%e8%af%ad%e6%b3%95%e8%af%a6%e8%a7%a3","status":"publish","type":"post","link":"http:\/\/www.u3d8.com\/?p=1526","title":{"rendered":"Protobuf\u8bed\u8a00\u6307\u5357\u2014\u2014.proto\u6587\u4ef6\u8bed\u6cd5\u8be6\u89e3"},"content":{"rendered":"

\u8f6c\u8f7d\uff1ahttp:\/\/www.open-open.com\/home\/space.php?uid=37924&do=blog&id=5873<\/a><\/p>\n

\u672c\u6307\u5357\u63cf\u8ff0\u4e86\u600e\u6837\u4f7f\u7528protocolbuffer\u8bed\u8a00\u6765\u6784\u9020\u4f60\u7684protocol buffer\u6570\u636e\uff0c\u5305\u62ec.proto\u6587\u4ef6\u8bed\u6cd5\u4ee5\u53ca\u600e\u6837\u751f\u6210.proto\u6587\u4ef6\u7684\u6570\u636e\u8bbf\u95ee\u7c7b\u3002<\/p>\n

\u672c\u6587\u662f\u4e00\u4e2a\u53c2\u8003\u6307\u5357\u2014\u2014\u5982\u679c\u8981\u67e5\u770b\u5982\u4f55\u4f7f\u7528\u672c\u6587\u4e2d\u63cf\u8ff0\u7684\u591a\u4e2a\u7279\u6027\u7684\u5faa\u5e8f\u6e10\u8fdb\u7684\u4f8b\u5b50\uff0c\u8bf7\u5728http:\/\/code.google.com\/intl\/zh-CN\/apis\/protocolbuffers\/docs\/tutorials.html<\/a>\u4e2d\u67e5\u627e\u9700\u8981\u7684\u8bed\u8a00\u7684\u6559\u7a0b\u3002<\/p>\n

\u5b9a\u4e49\u4e00\u4e2a\u6d88\u606f\u7c7b\u578b<\/h2>\n

\u5148\u6765\u770b\u4e00\u4e2a\u975e\u5e38\u7b80\u5355\u7684\u4f8b\u5b50\u3002\u5047\u8bbe\u4f60\u60f3\u5b9a\u4e49\u4e00\u4e2a\u201c\u641c\u7d22\u8bf7\u6c42\u201d\u7684\u6d88\u606f\u683c\u5f0f\uff0c\u6bcf\u4e00\u4e2a\u8bf7\u6c42\u542b\u6709\u4e00\u4e2a\u67e5\u8be2\u5b57\u7b26\u4e32\u3001\u4f60\u611f\u5174\u8da3\u7684\u67e5\u8be2\u7ed3\u679c\u6240\u5728\u7684\u9875\u6570\uff0c\u4ee5\u53ca\u6bcf\u4e00\u9875\u591a\u5c11\u6761\u67e5\u8be2\u7ed3\u679c\u3002\u53ef\u4ee5\u91c7\u7528\u5982\u4e0b\u7684\u65b9\u5f0f\u6765\u5b9a\u4e49\u6d88\u606f\u7c7b\u578b\u7684.proto\u6587\u4ef6\u4e86\uff1a<\/p>\n

message SearchRequest {\r\n  required string query = 1;\r\n  optional int32 page_number = 2;\r\n  optional int32 result_per_page = 3;\r\n}<\/pre>\n
SearchRequest\u6d88\u606f\u683c\u5f0f\u67093\u4e2a\u5b57\u6bb5\uff0c\u5728\u6d88\u606f\u4e2d\u627f\u8f7d\u7684\u6570\u636e\u5206\u522b\u5bf9\u5e94\u4e8e\u6bcf\u4e00\u4e2a\u5b57\u6bb5\u3002\u5176\u4e2d\u6bcf\u4e2a\u5b57\u6bb5\u90fd\u6709\u4e00\u4e2a\u540d\u5b57\u548c\u4e00\u79cd\u7c7b\u578b\u3002<\/p>\n
\u00d8\u00a0\u00a0\u6307\u5b9a\u5b57\u6bb5\u7c7b\u578b<\/p>\n
\u5728\u4e0a\u9762\u7684\u4f8b\u5b50\u4e2d\uff0c\u6240\u6709\u5b57\u6bb5\u90fd\u662f\u6807\u91cf\u7c7b\u578b\uff1a\u4e24\u4e2a\u6574\u578b\uff08page_number\u548cresult_per_page\uff09\uff0c\u4e00\u4e2astring\u7c7b\u578b\uff08query\uff09\u3002\u5f53\u7136\uff0c\u4f60\u4e5f\u53ef\u4ee5\u4e3a\u5b57\u6bb5\u6307\u5b9a\u5176\u4ed6\u7684\u5408\u6210\u7c7b\u578b\uff0c\u5305\u62ec\u679a\u4e3e\uff08enumerations<\/a>\uff09\u6216\u5176\u4ed6\u6d88\u606f\u7c7b\u578b\u3002<\/p>\n
\u00d8\u00a0 \u00a0\u5206\u914d\u6807\u8bc6\u53f7<\/p>\n
\u6b63\u5982\u4e0a\u8ff0\u6587\u4ef6\u683c\u5f0f\uff0c\u5728\u6d88\u606f\u5b9a\u4e49\u4e2d\uff0c\u6bcf\u4e2a\u5b57\u6bb5\u90fd\u6709\u552f\u4e00\u7684\u4e00\u4e2a\u6807\u8bc6\u7b26\u3002\u8fd9\u4e9b\u6807\u8bc6\u7b26\u662f\u7528\u6765\u5728\u6d88\u606f\u7684\u4e8c\u8fdb\u5236\u683c\u5f0f\u4e2d\u8bc6\u522b\u5404\u4e2a\u5b57\u6bb5\u7684\uff0c\u4e00\u65e6\u5f00\u59cb\u4f7f\u7528\u5c31\u4e0d\u80fd\u591f\u518d\u6539 \u53d8\u3002\u6ce8\uff1a[1,15]\u4e4b\u5185\u7684\u6807\u8bc6\u53f7\u5728\u7f16\u7801\u7684\u65f6\u5019\u4f1a\u5360\u7528\u4e00\u4e2a\u5b57\u8282\u3002[16,2047]\u4e4b\u5185\u7684\u6807\u8bc6\u53f7\u5219\u5360\u75282\u4e2a\u5b57\u8282\u3002\u6240\u4ee5\u5e94\u8be5\u4e3a\u90a3\u4e9b\u9891\u7e41\u51fa\u73b0\u7684\u6d88\u606f\u5143\u7d20\u4fdd\u7559 [1,15]\u4e4b\u5185\u7684\u6807\u8bc6\u53f7\u3002\u5207\u8bb0\uff1a\u8981\u4e3a\u5c06\u6765\u6709\u53ef\u80fd\u6dfb\u52a0\u7684\u3001\u9891\u7e41\u51fa\u73b0\u7684\u6807\u8bc6\u53f7\u9884\u7559\u4e00\u4e9b\u6807\u8bc6\u53f7\u3002<\/p>\n
\u6700\u5c0f\u7684\u6807\u8bc6\u53f7\u53ef\u4ee5\u4ece1\u5f00\u59cb\uff0c\u6700\u5927\u5230229<\/sup>\u00a0- 1, or 536,870,911\u3002\u4e0d\u53ef\u4ee5\u4f7f\u7528\u5176\u4e2d\u7684[19000\uff0d19999]\u7684\u6807\u8bc6\u53f7\uff0c Protobuf\u534f\u8bae\u5b9e\u73b0\u4e2d\u5bf9\u8fd9\u4e9b\u8fdb\u884c\u4e86\u9884\u7559\u3002\u5982\u679c\u975e\u8981\u5728.proto\u6587\u4ef6\u4e2d\u4f7f\u7528\u8fd9\u4e9b\u9884\u7559\u6807\u8bc6\u53f7\uff0c\u7f16\u8bd1\u65f6\u5c31\u4f1a\u62a5\u8b66\u3002<\/p>\n
\u00d8\u00a0\u00a0\u6307\u5b9a\u5b57\u6bb5\u89c4\u5219<\/p>\n
\u6240\u6307\u5b9a\u7684\u6d88\u606f\u5b57\u6bb5\u4fee\u9970\u7b26\u5fc5\u987b\u662f\u5982\u4e0b\u4e4b\u4e00\uff1a<\/p>\n
\u00b2\u00a0 required\uff1a\u4e00\u4e2a\u683c\u5f0f\u826f\u597d\u7684\u6d88\u606f\u4e00\u5b9a\u8981\u542b\u67091\u4e2a\u8fd9\u79cd\u5b57\u6bb5\u3002\u8868\u793a\u8be5\u503c\u662f\u5fc5\u987b\u8981\u8bbe\u7f6e\u7684\uff1b<\/p>\n
\u00b2\u00a0 optional\uff1a\u6d88\u606f\u683c\u5f0f\u4e2d\u8be5\u5b57\u6bb5\u53ef\u4ee5\u67090\u4e2a\u62161\u4e2a\u503c\uff08\u4e0d\u8d85\u8fc71\u4e2a\uff09\u3002<\/p>\n
\u00b2\u00a0 repeated\uff1a\u5728\u4e00\u4e2a\u683c\u5f0f\u826f\u597d\u7684\u6d88\u606f\u4e2d\uff0c\u8fd9\u79cd\u5b57\u6bb5\u53ef\u4ee5\u91cd\u590d\u4efb\u610f\u591a\u6b21\uff08\u5305\u62ec0\u6b21\uff09\u3002\u91cd\u590d\u7684\u503c\u7684\u987a\u5e8f\u4f1a\u88ab\u4fdd\u7559\u3002\u8868\u793a\u8be5\u503c\u53ef\u4ee5\u91cd\u590d\uff0c\u76f8\u5f53\u4e8ejava\u4e2d\u7684List\u3002<\/p>\n
\u7531\u4e8e\u4e00\u4e9b\u5386\u53f2\u539f\u56e0\uff0c\u57fa\u672c\u6570\u503c\u7c7b\u578b\u7684repeated\u7684\u5b57\u6bb5\u5e76\u6ca1\u6709\u88ab\u5c3d\u53ef\u80fd\u5730\u9ad8\u6548\u7f16\u7801\u3002\u5728\u65b0\u7684\u4ee3\u7801\u4e2d\uff0c\u7528\u6237\u5e94\u8be5\u4f7f\u7528\u7279\u6b8a\u9009\u9879[packed=true]\u6765\u4fdd\u8bc1\u66f4\u9ad8\u6548\u7684\u7f16\u7801\u3002\u5982\uff1a<\/p>\n
repeated int32 samples = 4 [packed=true];<\/pre>\n
required\u662f\u6c38\u4e45\u6027\u7684\uff1a\u5728\u5c06\u4e00\u4e2a\u5b57\u6bb5\u6807\u8bc6\u4e3arequired\u7684\u65f6\u5019\uff0c\u5e94\u8be5\u7279\u522b\u5c0f\u5fc3\u3002\u5982\u679c\u5728\u67d0\u4e9b\u60c5\u51b5\u4e0b\u4e0d\u60f3\u5199\u5165\u6216\u8005\u53d1\u9001\u4e00\u4e2arequired\u7684 \u5b57\u6bb5\uff0c\u5c06\u539f\u59cb\u8be5\u5b57\u6bb5\u4fee\u9970\u7b26\u66f4\u6539\u4e3aoptional\u53ef\u80fd\u4f1a\u9047\u5230\u95ee\u9898\u2014\u2014\u65e7\u7248\u672c\u7684\u4f7f\u7528\u8005\u4f1a\u8ba4\u4e3a\u4e0d\u542b\u8be5\u5b57\u6bb5\u7684\u6d88\u606f\u662f\u4e0d\u5b8c\u6574\u7684\uff0c\u4ece\u800c\u53ef\u80fd\u4f1a\u65e0\u76ee\u7684\u7684\u62d2\u7edd\u89e3\u6790\u3002\u5728\u8fd9 \u79cd\u60c5\u51b5\u4e0b\uff0c\u4f60\u5e94\u8be5\u8003\u8651\u7f16\u5199\u7279\u522b\u9488\u5bf9\u4e8e\u5e94\u7528\u7a0b\u5e8f\u7684\u3001\u81ea\u5b9a\u4e49\u7684\u6d88\u606f\u6821\u9a8c\u51fd\u6570\u3002Google\u7684\u4e00\u4e9b\u5de5\u7a0b\u5e08\u5f97\u51fa\u4e86\u4e00\u4e2a\u7ed3\u8bba\uff1a\u4f7f\u7528required\u5f0a\u591a\u4e8e\u5229\uff1b\u4ed6\u4eec\u66f4 \u613f\u610f\u4f7f\u7528optional\u548crepeated\u800c\u4e0d\u662frequired\u3002\u5f53\u7136\uff0c\u8fd9\u4e2a\u89c2\u70b9\u5e76\u4e0d\u5177\u6709\u666e\u904d\u6027\u3002<\/p>\n
\u00d8\u00a0 \u00a0\u6dfb\u52a0\u66f4\u591a\u6d88\u606f\u7c7b\u578b<\/p>\n
\u5728\u4e00\u4e2a.proto\u6587\u4ef6\u4e2d\u53ef\u4ee5\u5b9a\u4e49\u591a\u4e2a\u6d88\u606f\u7c7b\u578b\u3002\u5728\u5b9a\u4e49\u591a\u4e2a\u76f8\u5173\u7684\u6d88\u606f\u7684\u65f6\u5019\uff0c\u8fd9\u4e00\u70b9\u7279\u522b\u6709\u7528\u2014\u2014\u4f8b\u5982\uff0c\u5982\u679c\u60f3\u5b9a\u4e49\u4e0eSearchResponse\u6d88\u606f\u7c7b\u578b\u5bf9\u5e94\u7684\u56de\u590d\u6d88\u606f\u683c\u5f0f\u7684\u8bdd\uff0c\u4f60\u53ef\u4ee5\u5c06\u5b83\u6dfb\u52a0\u5230\u76f8\u540c\u7684.proto\u6587\u4ef6\u4e2d\uff0c\u5982\uff1a<\/p>\n
message SearchRequest {\r\n  required string query = 1;\r\n  optional int32 page_number = 2;\r\n  optional int32 result_per_page = 3;\r\n}\r\nmessage SearchResponse {\r\n \u2026\r\n}<\/pre>\n
\u00d8\u00a0\u00a0\u6dfb\u52a0\u6ce8\u91ca<\/p>\n
\u5411.proto\u6587\u4ef6\u6dfb\u52a0\u6ce8\u91ca\uff0c\u53ef\u4ee5\u4f7f\u7528C\/C++\/java\u98ce\u683c\u7684\u53cc\u659c\u6760\uff08\/\/\uff09\u00a0\u8bed\u6cd5\u683c\u5f0f\uff0c\u5982\uff1a<\/p>\n
message SearchRequest {\r\n  required string query = 1;\r\n  optional int32 page_number = 2;\/\/ \u6700\u7ec8\u8fd4\u56de\u7684\u9875\u6570\r\n  optional int32 result_per_page = 3;\/\/ \u6bcf\u9875\u8fd4\u56de\u7684\u7ed3\u679c\u6570\r\n}<\/pre>\n
\u00d8\u00a0\u00a0\u4ece.proto\u6587\u4ef6\u751f\u6210\u4e86\u4ec0\u4e48\uff1f<\/p>\n
\u5f53\u7528protocolbuffer\u7f16\u8bd1\u5668\u6765\u8fd0\u884c.proto\u6587\u4ef6\u65f6\uff0c\u7f16\u8bd1\u5668\u5c06\u751f\u6210\u6240\u9009\u62e9\u8bed\u8a00\u7684\u4ee3\u7801\uff0c\u8fd9\u4e9b\u4ee3\u7801\u53ef\u4ee5\u64cd\u4f5c\u5728.proto\u6587\u4ef6\u4e2d\u5b9a\u4e49\u7684\u6d88\u606f\u7c7b\u578b\uff0c\u5305\u62ec\u83b7\u53d6\u3001\u8bbe\u7f6e\u5b57\u6bb5\u503c\uff0c\u5c06\u6d88\u606f\u5e8f\u5217\u5316\u5230\u4e00\u4e2a\u8f93\u51fa\u6d41\u4e2d\uff0c\u4ee5\u53ca\u4ece\u4e00\u4e2a\u8f93\u5165\u6d41\u4e2d\u89e3\u6790\u6d88\u606f\u3002<\/p>\n
\u00b2\u00a0 \u5bf9C++\u6765\u8bf4\uff0c\u7f16\u8bd1\u5668\u4f1a\u4e3a\u6bcf\u4e2a.proto\u6587\u4ef6\u751f\u6210\u4e00\u4e2a.h\u6587\u4ef6\u548c\u4e00\u4e2a.cc\u6587\u4ef6\uff0c.proto\u6587\u4ef6\u4e2d\u7684\u6bcf\u4e00\u4e2a\u6d88\u606f\u6709\u4e00\u4e2a\u5bf9\u5e94\u7684\u7c7b\u3002<\/p>\n
\u00b2\u00a0 \u5bf9Java\u6765\u8bf4\uff0c\u7f16\u8bd1\u5668\u4e3a\u6bcf\u4e00\u4e2a\u6d88\u606f\u7c7b\u578b\u751f\u6210\u4e86\u4e00\u4e2a.java\u6587\u4ef6\uff0c\u4ee5\u53ca\u4e00\u4e2a\u7279\u6b8a\u7684Builder\u7c7b\uff08\u8be5\u7c7b\u662f\u7528\u6765\u521b\u5efa\u6d88\u606f\u7c7b\u63a5\u53e3\u7684\uff09\u3002<\/p>\n
\u00b2\u00a0 \u5bf9Python\u6765\u8bf4\uff0c\u6709\u70b9\u4e0d\u592a\u4e00\u6837\u2014\u2014Python\u7f16\u8bd1\u5668\u4e3a.proto\u6587\u4ef6\u4e2d\u7684\u6bcf\u4e2a\u6d88\u606f\u7c7b\u578b\u751f\u6210\u4e00\u4e2a\u542b\u6709\u9759\u6001\u63cf\u8ff0\u7b26\u7684\u6a21\u5757\uff0c\uff0c\u8be5\u6a21\u5757\u4e0e\u4e00\u4e2a\u5143\u7c7b\uff08metaclass\uff09\u5728\u8fd0\u884c\u65f6\uff08runtime\uff09\u88ab\u7528\u6765\u521b\u5efa\u6240\u9700\u7684Python\u6570\u636e\u8bbf\u95ee\u7c7b\u3002<\/p>\n
\u4f60\u53ef\u4ee5\u4ece\u5982\u4e0b\u7684\u6587\u6863\u94fe\u63a5\u4e2d\u83b7\u53d6\u6bcf\u79cd\u8bed\u8a00\u66f4\u591aAPI\u3002http:\/\/code.google.com\/intl\/zh-CN\/apis\/protocolbuffers\/docs\/reference\/overview.html<\/a><\/p>\n
\u6807\u91cf\u6570\u503c\u7c7b\u578b<\/h2>\n
\u4e00\u4e2a\u6807\u91cf\u6d88\u606f\u5b57\u6bb5\u53ef\u4ee5\u542b\u6709\u4e00\u4e2a\u5982\u4e0b\u7684\u7c7b\u578b\u2014\u2014\u8be5\u8868\u683c\u5c55\u793a\u4e86\u5b9a\u4e49\u4e8e.proto\u6587\u4ef6\u4e2d\u7684\u7c7b\u578b\uff0c\u4ee5\u53ca\u4e0e\u4e4b\u5bf9\u5e94\u7684\u3001\u5728\u81ea\u52a8\u751f\u6210\u7684\u8bbf\u95ee\u7c7b\u4e2d\u5b9a\u4e49\u7684\u7c7b\u578b\uff1a<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
.proto\u7c7b\u578b<\/td>\nJava \u7c7b\u578b<\/td>\nC++\u7c7b\u578b<\/td>\n\u5907\u6ce8<\/td>\n<\/tr>\n
double<\/td>\ndouble<\/td>\ndouble<\/td>\n<\/td>\n<\/tr>\n
float<\/td>\nfloat<\/td>\nfloat<\/td>\n<\/td>\n<\/tr>\n
int32<\/td>\nint<\/td>\nint32<\/td>\n\u4f7f\u7528\u53ef\u53d8\u957f\u7f16\u7801\u65b9\u5f0f\u3002\u7f16\u7801\u8d1f\u6570\u65f6\u4e0d\u591f\u9ad8\u6548\u2014\u2014\u5982\u679c\u4f60\u7684\u5b57\u6bb5\u53ef\u80fd\u542b\u6709\u8d1f\u6570\uff0c\u90a3\u4e48\u8bf7\u4f7f\u7528sint32\u3002<\/td>\n<\/tr>\n
int64<\/td>\nlong<\/td>\nint64<\/td>\n\u4f7f\u7528\u53ef\u53d8\u957f\u7f16\u7801\u65b9\u5f0f\u3002\u7f16\u7801\u8d1f\u6570\u65f6\u4e0d\u591f\u9ad8\u6548\u2014\u2014\u5982\u679c\u4f60\u7684\u5b57\u6bb5\u53ef\u80fd\u542b\u6709\u8d1f\u6570\uff0c\u90a3\u4e48\u8bf7\u4f7f\u7528sint64\u3002<\/td>\n<\/tr>\n
uint32<\/td>\nint[1]<\/td>\nuint32<\/td>\nUses variable-length encoding.<\/td>\n<\/tr>\n
uint64<\/td>\nlong[1]<\/td>\nuint64<\/td>\nUses variable-length encoding.<\/td>\n<\/tr>\n
sint32<\/td>\nint<\/td>\nint32<\/td>\n\u4f7f\u7528\u53ef\u53d8\u957f\u7f16\u7801\u65b9\u5f0f\u3002\u6709\u7b26\u53f7\u7684\u6574\u578b\u503c\u3002\u7f16\u7801\u65f6\u6bd4\u901a\u5e38\u7684int32\u9ad8\u6548\u3002<\/td>\n<\/tr>\n
sint64<\/td>\nlong<\/td>\nint64<\/td>\n\u4f7f\u7528\u53ef\u53d8\u957f\u7f16\u7801\u65b9\u5f0f\u3002\u6709\u7b26\u53f7\u7684\u6574\u578b\u503c\u3002\u7f16\u7801\u65f6\u6bd4\u901a\u5e38\u7684int64\u9ad8\u6548\u3002<\/td>\n<\/tr>\n
fixed32<\/td>\nint[1]<\/td>\nuint32<\/td>\n\u603b\u662f4\u4e2a\u5b57\u8282\u3002\u5982\u679c\u6570\u503c\u603b\u662f\u6bd4\u603b\u662f\u6bd4228<\/sup>\u5927\u7684\u8bdd\uff0c\u8fd9\u4e2a\u7c7b\u578b\u4f1a\u6bd4uint32\u9ad8\u6548\u3002<\/td>\n<\/tr>\n
fixed64<\/td>\nlong[1]<\/td>\nuint64<\/td>\n\u603b\u662f8\u4e2a\u5b57\u8282\u3002\u5982\u679c\u6570\u503c\u603b\u662f\u6bd4\u603b\u662f\u6bd4256<\/sup>\u5927\u7684\u8bdd\uff0c\u8fd9\u4e2a\u7c7b\u578b\u4f1a\u6bd4uint64\u9ad8\u6548\u3002<\/td>\n<\/tr>\n
sfixed32<\/td>\nint<\/td>\nint32<\/td>\n\u603b\u662f4\u4e2a\u5b57\u8282\u3002<\/td>\n<\/tr>\n
sfixed64<\/td>\nlong<\/td>\nint64<\/td>\n\u603b\u662f8\u4e2a\u5b57\u8282\u3002<\/td>\n<\/tr>\n
bool<\/td>\nboolean<\/td>\nbool<\/td>\n<\/td>\n<\/tr>\n
string<\/td>\nString<\/td>\nstring<\/td>\n\u4e00\u4e2a\u5b57\u7b26\u4e32\u5fc5\u987b\u662fUTF-8\u7f16\u7801\u6216\u80057-bit ASCII\u7f16\u7801\u7684\u6587\u672c\u3002<\/td>\n<\/tr>\n
bytes<\/td>\nByteString<\/td>\nstring<\/td>\n\u53ef\u80fd\u5305\u542b\u4efb\u610f\u987a\u5e8f\u7684\u5b57\u8282\u6570\u636e\u3002<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\u4f60\u53ef\u4ee5\u5728\u6587\u7ae0http:\/\/code.google.com\/apis\/protocolbuffers\/docs\/encoding.html<\/a>\u00a0\u4e2d\uff0c\u627e\u5230\u66f4\u591a\u201c\u5e8f\u5217\u5316\u6d88\u606f\u65f6\u5404\u79cd\u7c7b\u578b\u5982\u4f55\u7f16\u7801\u201d\u7684\u4fe1\u606f\u3002<\/p>\n
Optional\u7684\u5b57\u6bb5\u548c\u9ed8\u8ba4\u503c<\/h2>\n
\u5982\u4e0a\u6240\u8ff0\uff0c\u6d88\u606f\u63cf\u8ff0\u4e2d\u7684\u4e00\u4e2a\u5143\u7d20\u53ef\u4ee5\u88ab\u6807\u8bb0\u4e3a\u201c\u53ef\u9009\u7684\u201d\uff08optional\uff09\u3002\u4e00\u4e2a\u683c\u5f0f\u826f\u597d\u7684\u6d88\u606f\u53ef\u4ee5\u5305\u542b0\u4e2a\u6216\u4e00\u4e2aoptional\u7684\u5143\u7d20\u3002\u5f53\u89e3 \u6790\u6d88\u606f\u65f6\uff0c\u5982\u679c\u5b83\u4e0d\u5305\u542boptional\u7684\u5143\u7d20\u503c\uff0c\u90a3\u4e48\u89e3\u6790\u51fa\u6765\u7684\u5bf9\u8c61\u4e2d\u7684\u5bf9\u5e94\u5b57\u6bb5\u5c31\u88ab\u7f6e\u4e3a\u9ed8\u8ba4\u503c\u3002\u9ed8\u8ba4\u503c\u53ef\u4ee5\u5728\u6d88\u606f\u63cf\u8ff0\u6587\u4ef6\u4e2d\u6307\u5b9a\u3002\u4f8b\u5982\uff0c\u8981\u4e3a SearchRequest\u6d88\u606f\u7684result_per_page\u5b57\u6bb5\u6307\u5b9a\u9ed8\u8ba4\u503c10\uff0c\u5728\u5b9a\u4e49\u6d88\u606f\u683c\u5f0f\u65f6\u5982\u4e0b\u6240\u793a\uff1a<\/p>\n
optional int32 result_per_page = 3 [default = 10];<\/pre>\n
\u5982\u679c\u6ca1\u6709\u4e3aoptional\u7684\u5143\u7d20\u6307\u5b9a\u9ed8\u8ba4\u503c\uff0c\u5c31\u4f1a\u4f7f\u7528\u4e0e\u7279\u5b9a\u7c7b\u578b\u76f8\u5173\u7684\u9ed8\u8ba4\u503c\uff1a\u5bf9string\u6765\u8bf4\uff0c\u9ed8\u8ba4\u503c\u662f\u7a7a\u5b57\u7b26\u4e32\u3002\u5bf9bool\u6765\u8bf4\uff0c\u9ed8\u8ba4\u503c\u662ffalse\u3002\u5bf9\u6570\u503c\u7c7b\u578b\u6765\u8bf4\uff0c\u9ed8\u8ba4\u503c\u662f0\u3002\u5bf9\u679a\u4e3e\u6765\u8bf4\uff0c\u9ed8\u8ba4\u503c\u662f\u679a\u4e3e\u7c7b\u578b\u5b9a\u4e49\u4e2d\u7684\u7b2c\u4e00\u4e2a\u503c\u3002<\/p>\n
\u679a\u4e3e<\/h2>\n
\u5f53\u9700\u8981\u5b9a\u4e49\u4e00\u4e2a\u6d88\u606f\u7c7b\u578b\u7684\u65f6\u5019\uff0c\u53ef\u80fd\u60f3\u4e3a\u4e00\u4e2a\u5b57\u6bb5\u6307\u5b9a\u67d0\u201c\u9884\u5b9a\u4e49\u503c\u5e8f\u5217\u201d\u4e2d\u7684\u4e00\u4e2a\u503c\u3002\u4f8b\u5982\uff0c\u5047\u8bbe\u8981\u4e3a\u6bcf\u4e00\u4e2aSearchRequest\u6d88\u606f\u6dfb\u52a0\u4e00\u4e2a corpus\u5b57\u6bb5\uff0c\u800ccorpus\u7684\u503c\u53ef\u80fd\u662fUNIVERSAL\uff0cWEB\uff0cIMAGES\uff0cLOCAL\uff0cNEWS\uff0cPRODUCTS\u6216VIDEO\u4e2d\u7684\u4e00\u4e2a\u3002 \u5176\u5b9e\u53ef\u4ee5\u5f88\u5bb9\u6613\u5730\u5b9e\u73b0\u8fd9\u4e00\u70b9\uff1a\u901a\u8fc7\u5411\u6d88\u606f\u5b9a\u4e49\u4e2d\u6dfb\u52a0\u4e00\u4e2a\u679a\u4e3e\uff08enum\uff09\u5c31\u53ef\u4ee5\u4e86\u3002\u4e00\u4e2aenum\u7c7b\u578b\u7684\u5b57\u6bb5\u53ea\u80fd\u7528\u6307\u5b9a\u7684\u5e38\u91cf\u96c6\u4e2d\u7684\u4e00\u4e2a\u503c\u4f5c\u4e3a\u5176\u503c\uff08\u5982\u679c\u5c1d \u8bd5\u6307\u5b9a\u4e0d\u540c\u7684\u503c\uff0c\u89e3\u6790\u5668\u5c31\u4f1a\u628a\u5b83\u5f53\u4f5c\u4e00\u4e2a\u672a\u77e5\u7684\u5b57\u6bb5\u6765\u5bf9\u5f85\uff09\u3002\u5728\u4e0b\u9762\u7684\u4f8b\u5b50\u4e2d\uff0c\u5728\u6d88\u606f\u683c\u5f0f\u4e2d\u6dfb\u52a0\u4e86\u4e00\u4e2a\u53eb\u505aCorpus\u7684\u679a\u4e3e\u7c7b\u578b\u2014\u2014\u5b83\u542b\u6709\u6240\u6709\u53ef\u80fd\u7684\u503c \u2014\u2014\u4ee5\u53ca\u4e00\u4e2a\u7c7b\u578b\u4e3aCorpus\u7684\u5b57\u6bb5\uff1a<\/p>\n
message SearchRequest {\r\n  required string query = 1;\r\n  optional int32 page_number = 2;\r\n  optional int32 result_per_page = 3 [default = 10];\r\n  enum Corpus {\r\n    UNIVERSAL = 0;\r\n    WEB = 1;\r\n    IMAGES = 2;\r\n    LOCAL = 3;\r\n    NEWS = 4;\r\n    PRODUCTS = 5;\r\n    VIDEO = 6;\r\n  }\r\n  optional Corpus corpus = 4 [default = UNIVERSAL];\r\n}<\/pre>\n
\u679a\u4e3e\u5e38\u91cf\u5fc5\u987b\u572832\u4f4d\u6574\u578b\u503c\u7684\u8303\u56f4\u5185\u3002\u56e0\u4e3aenum\u503c\u662f\u4f7f\u7528\u53ef\u53d8\u7f16\u7801\u65b9\u5f0f\u7684\uff0c\u5bf9\u8d1f\u6570\u4e0d\u591f\u9ad8\u6548\uff0c\u56e0\u6b64\u4e0d\u63a8\u8350\u5728enum\u4e2d\u4f7f\u7528\u8d1f\u6570\u3002\u5982\u4e0a\u4f8b\u6240\u793a\uff0c\u53ef\u4ee5\u5728 \u4e00\u4e2a\u6d88\u606f\u5b9a\u4e49\u7684\u5185\u90e8\u6216\u5916\u90e8\u5b9a\u4e49\u679a\u4e3e\u2014\u2014\u8fd9\u4e9b\u679a\u4e3e\u53ef\u4ee5\u5728.proto\u6587\u4ef6\u4e2d\u7684\u4efb\u4f55\u6d88\u606f\u5b9a\u4e49\u91cc\u91cd\u7528\u3002\u5f53\u7136\u4e5f\u53ef\u4ee5\u5728\u4e00\u4e2a\u6d88\u606f\u4e2d\u58f0\u660e\u4e00\u4e2a\u679a\u4e3e\u7c7b\u578b\uff0c\u800c\u5728\u53e6\u4e00\u4e2a\u4e0d\u540c \u7684\u6d88\u606f\u4e2d\u4f7f\u7528\u5b83\u2014\u2014\u91c7\u7528MessageType.EnumType\u7684\u8bed\u6cd5\u683c\u5f0f\u3002<\/p>\n
\u5f53\u5bf9\u4e00\u4e2a\u4f7f\u7528\u4e86\u679a\u4e3e\u7684.proto\u6587\u4ef6\u8fd0\u884cprotocol buffer\u7f16\u8bd1\u5668\u7684\u65f6\u5019\uff0c\u751f\u6210\u7684\u4ee3\u7801\u4e2d\u5c06\u6709\u4e00\u4e2a\u5bf9\u5e94\u7684enum\uff08\u5bf9Java\u6216C++\u6765\u8bf4\uff09\uff0c\u6216\u8005\u4e00\u4e2a\u7279\u6b8a\u7684EnumDescriptor\u7c7b\uff08\u5bf9 Python\u6765\u8bf4\uff09\uff0c\u5b83\u88ab\u7528\u6765\u5728\u8fd0\u884c\u65f6\u751f\u6210\u7684\u7c7b\u4e2d\u521b\u5efa\u4e00\u7cfb\u5217\u7684\u6574\u578b\u503c\u7b26\u53f7\u5e38\u91cf\uff08symbolic constants\uff09\u3002<\/p>\n
\u5173\u4e8e\u5982\u4f55\u5728\u4f60\u7684\u5e94\u7528\u7a0b\u5e8f\u7684\u6d88\u606f\u4e2d\u4f7f\u7528\u679a\u4e3e\u7684\u66f4\u591a\u4fe1\u606f\uff0c\u8bf7\u67e5\u770b\u6240\u9009\u62e9\u7684\u8bed\u8a00http:\/\/code.google.com\/intl\/zh-CN\/apis\/protocolbuffers\/docs\/reference\/overview.html\u3002<\/p>\n
\u4f7f\u7528\u5176\u4ed6\u6d88\u606f\u7c7b\u578b<\/h2>\n
\u4f60\u53ef\u4ee5\u5c06\u5176\u4ed6\u6d88\u606f\u7c7b\u578b\u7528\u4f5c\u5b57\u6bb5\u7c7b\u578b\u3002\u4f8b\u5982\uff0c\u5047\u8bbe\u5728\u6bcf\u4e00\u4e2aSearchResponse\u6d88\u606f\u4e2d\u5305\u542bResult\u6d88\u606f\uff0c\u6b64\u65f6\u53ef\u4ee5\u5728\u76f8\u540c\u7684.proto\u6587\u4ef6\u4e2d\u5b9a\u4e49\u4e00\u4e2aResult\u6d88\u606f\u7c7b\u578b\uff0c\u7136\u540e\u5728SearchResponse\u6d88\u606f\u4e2d\u6307\u5b9a\u4e00\u4e2aResult\u7c7b\u578b\u7684\u5b57\u6bb5\uff0c\u5982\uff1a<\/p>\n
message SearchResponse {\r\n  repeated Result result = 1;\r\n}\r\nmessage Result {\r\n  required string url = 1;\r\n  optional string title = 2;\r\n  repeated string snippets = 3;\r\n}<\/pre>\n
\u00d8\u00a0\u00a0\u5bfc\u5165\u5b9a\u4e49<\/p>\n
\u5728\u4e0a\u9762\u7684\u4f8b\u5b50\u4e2d\uff0cResult\u6d88\u606f\u7c7b\u578b\u4e0eSearchResponse\u662f\u5b9a\u4e49\u5728\u540c\u4e00\u6587\u4ef6\u4e2d\u7684\u3002\u5982\u679c\u60f3\u8981\u4f7f\u7528\u7684\u6d88\u606f\u7c7b\u578b\u5df2\u7ecf\u5728\u5176\u4ed6.proto\u6587\u4ef6\u4e2d\u5df2\u7ecf\u5b9a\u4e49\u8fc7\u4e86\u5462\uff1f<\/p>\n
\u4f60\u53ef\u4ee5\u901a\u8fc7\u5bfc\u5165\uff08importing\uff09\u5176\u4ed6.proto\u6587\u4ef6\u4e2d\u7684\u5b9a\u4e49\u6765\u4f7f\u7528\u5b83\u4eec\u3002\u8981\u5bfc\u5165\u5176\u4ed6.proto\u6587\u4ef6\u7684\u5b9a\u4e49\uff0c\u4f60\u9700\u8981\u5728\u4f60\u7684\u6587\u4ef6\u4e2d\u6dfb\u52a0\u4e00\u4e2a\u5bfc\u5165\u58f0\u660e\uff0c\u5982\uff1a<\/p>\n
import \"myproject\/other_protos.proto\";<\/pre>\n
protocol\u7f16\u8bd1\u5668\u5c31\u4f1a\u5728\u4e00\u7cfb\u5217\u76ee\u5f55\u4e2d\u67e5\u627e\u9700\u8981\u88ab\u5bfc\u5165\u7684\u6587\u4ef6\uff0c\u8fd9\u4e9b\u76ee\u5f55\u901a\u8fc7protocol\u7f16\u8bd1\u5668\u7684\u547d\u4ee4\u884c\u53c2\u6570-I\/\u2013import_path\u6307\u5b9a\u3002\u5982\u679c\u4e0d\u63d0\u4f9b\u53c2\u6570\uff0c\u7f16\u8bd1\u5668\u5c31\u5728\u5176\u8c03\u7528\u76ee\u5f55\u4e0b\u67e5\u627e\u3002<\/p>\n
\u5d4c\u5957\u7c7b\u578b<\/h2>\n
\u4f60\u53ef\u4ee5\u5728\u5176\u4ed6\u6d88\u606f\u7c7b\u578b\u4e2d\u5b9a\u4e49\u3001\u4f7f\u7528\u6d88\u606f\u7c7b\u578b\uff0c\u5728\u4e0b\u9762\u7684\u4f8b\u5b50\u4e2d\uff0cResult\u6d88\u606f\u5c31\u5b9a\u4e49\u5728SearchResponse\u6d88\u606f\u5185\uff0c\u5982\uff1a<\/p>\n
message SearchResponse {\r\n  message Result {\r\n    required string url = 1;\r\n    optional string title = 2;\r\n    repeated string snippets = 3;\r\n  }\r\n  repeated Result result = 1;\r\n}<\/pre>\n
\u5982\u679c\u4f60\u60f3\u5728\u5b83\u7684\u7236\u6d88\u606f\u7c7b\u578b\u7684\u5916\u90e8\u91cd\u7528\u8fd9\u4e2a\u6d88\u606f\u7c7b\u578b\uff0c\u4f60\u9700\u8981\u4ee5Parent.Type\u7684\u5f62\u5f0f\u4f7f\u7528\u5b83\uff0c\u5982\uff1a<\/p>\n
message SomeOtherMessage {\r\n  optional SearchResponse.Result result = 1;\r\n}<\/pre>\n
\u5f53\u7136\uff0c\u4f60\u4e5f\u53ef\u4ee5\u5c06\u6d88\u606f\u5d4c\u5957\u4efb\u610f\u591a\u5c42\uff0c\u5982\uff1a<\/p>\n
message Outer {                  \/\/ Level 0\r\n  message MiddleAA {  \/\/ Level 1\r\n    message Inner {   \/\/ Level 2\r\n      required int64 ival = 1;\r\n      optional bool  booly = 2;\r\n    }\r\n  }\r\n  message MiddleBB {  \/\/ Level 1\r\n    message Inner {   \/\/ Level 2\r\n      required int32 ival = 1;\r\n      optional bool  booly = 2;\r\n    }\r\n  }\r\n}<\/pre>\n
\u00d8\u00a0\u00a0\u7ec4<\/p>\n
\u6ce8\uff1a\u8be5\u7279\u6027\u5df2\u88ab\u5f03\u7528\uff0c\u5728\u521b\u5efa\u65b0\u7684\u6d88\u606f\u7c7b\u578b\u7684\u65f6\u5019\uff0c\u4e0d\u5e94\u8be5\u518d\u4f7f\u7528\u5b83\u2014\u2014\u53ef\u4ee5\u4f7f\u7528\u5d4c\u5957\u6d88\u606f\u7c7b\u578b\u6765\u4ee3\u66ff\u5b83\u3002<\/p>\n
\u201c\u7ec4\u201d\u662f\u6307\u5728\u6d88\u606f\u5b9a\u4e49\u4e2d\u5d4c\u5957\u4fe1\u606f\u7684\u53e6\u4e00\u79cd\u65b9\u6cd5\u3002\u6bd4\u5982\uff0c\u5728SearchResponse\u4e2d\u5305\u542b\u82e5\u5e72Result\u7684\u53e6\u4e00\u79cd\u65b9\u6cd5\u662f\u00a0\uff1a<\/p>\n
message SearchResponse {\r\n  repeated group Result = 1 {\r\n    required string url = 2;\r\n    optional string title = 3;\r\n    repeated string snippets = 4;\r\n  }\r\n}<\/pre>\n
\u4e00\u4e2a\u201c\u7ec4\u201d\u53ea\u662f\u7b80\u5355\u5730\u5c06\u4e00\u4e2a\u5d4c\u5957\u6d88\u606f\u7c7b\u578b\u548c\u4e00\u4e2a\u5b57\u6bb5\u6346\u7ed1\u5230\u4e00\u4e2a\u5355\u72ec\u7684\u58f0\u660e\u4e2d\u3002\u5728\u4ee3\u7801\u4e2d\uff0c\u53ef\u4ee5\u628a\u5b83\u770b\u6210\u662f\u542b\u6709\u4e00\u4e2aResult\u7c7b\u578b\u3001\u540d\u53ebresult\u7684\u5b57\u6bb5\u7684\u6d88\u606f\uff08\u540e\u9762\u7684\u540d\u5b57\u88ab\u8f6c\u6362\u6210\u4e86\u5c0f\u5199\uff0c\u6240\u4ee5\u5b83\u4e0d\u4f1a\u4e0e\u524d\u9762\u7684\u51b2\u7a81\uff09\u3002<\/p>\n
\u56e0\u6b64\uff0c\u9664\u4e86\u6570\u636e\u4f20\u8f93\u683c\u5f0f\u4e0d\u540c\u4e4b\u5916\uff0c\u8fd9\u4e2a\u4f8b\u5b50\u4e0e\u4e0a\u9762\u7684SearchResponse\u4f8b\u5b50\u662f\u5b8c\u5168\u7b49\u4ef7\u7684\u3002<\/p>\n
\u66f4\u65b0\u4e00\u4e2a\u6d88\u606f\u7c7b\u578b<\/h2>\n
\u5982\u679c\u4e00\u4e2a\u5df2\u6709\u7684\u6d88\u606f\u683c\u5f0f\u5df2\u65e0\u6cd5\u6ee1\u8db3\u65b0\u7684\u9700\u6c42\u2014\u2014\u5982\uff0c\u8981\u5728\u6d88\u606f\u4e2d\u6dfb\u52a0\u4e00\u4e2a\u989d\u5916\u7684\u5b57\u6bb5\u2014\u2014\u4f46\u662f\u540c\u65f6\u65e7\u7248\u672c\u5199\u7684\u4ee3\u7801\u4ecd\u7136\u53ef\u7528\u3002\u4e0d\u7528\u62c5\u5fc3\uff01\u66f4\u65b0\u6d88\u606f\u800c\u4e0d\u7834\u574f\u5df2\u6709\u4ee3\u7801\u662f\u975e\u5e38\u7b80\u5355\u7684\u3002\u5728\u66f4\u65b0\u65f6\u53ea\u8981\u8bb0\u4f4f\u4ee5\u4e0b\u7684\u89c4\u5219\u5373\u53ef\u3002<\/p>\n
\u00b2\u00a0 \u4e0d\u8981\u66f4\u6539\u4efb\u4f55\u5df2\u6709\u7684\u5b57\u6bb5\u7684\u6570\u503c\u6807\u8bc6\u3002<\/p>\n
\u00b2\u00a0 \u6240\u6dfb\u52a0\u7684\u4efb\u4f55\u5b57\u6bb5\u90fd\u5fc5\u987b\u662foptional\u6216repeated\u7684\u3002\u8fd9\u5c31\u610f\u5473\u7740\u4efb\u4f55\u4f7f\u7528\u201c\u65e7\u201d\u7684\u6d88\u606f\u683c\u5f0f\u7684\u4ee3\u7801\u5e8f\u5217\u5316\u7684\u6d88\u606f\u53ef\u4ee5\u88ab\u65b0\u7684\u4ee3\u7801\u6240\u89e3\u6790\uff0c\u56e0\u4e3a\u5b83\u4eec \u4e0d\u4f1a\u4e22\u6389\u4efb\u4f55required\u7684\u5143\u7d20\u3002\u5e94\u8be5\u4e3a\u8fd9\u4e9b\u5143\u7d20\u8bbe\u7f6e\u5408\u7406\u7684\u9ed8\u8ba4\u503c\uff0c\u8fd9\u6837\u65b0\u7684\u4ee3\u7801\u5c31\u80fd\u591f\u6b63\u786e\u5730\u4e0e\u8001\u4ee3\u7801\u751f\u6210\u7684\u6d88\u606f\u4ea4\u4e92\u4e86\u3002\u7c7b\u4f3c\u5730\uff0c\u65b0\u7684\u4ee3\u7801\u521b\u5efa\u7684\u6d88\u606f \u4e5f\u80fd\u88ab\u8001\u7684\u4ee3\u7801\u89e3\u6790\uff1a\u8001\u7684\u4e8c\u8fdb\u5236\u7a0b\u5e8f\u5728\u89e3\u6790\u7684\u65f6\u5019\u53ea\u662f\u7b80\u5355\u5730\u5c06\u65b0\u5b57\u6bb5\u5ffd\u7565\u3002\u7136\u800c\uff0c\u672a\u77e5\u7684\u5b57\u6bb5\u662f\u6ca1\u6709\u88ab\u629b\u5f03\u7684\u3002\u6b64\u540e\uff0c\u5982\u679c\u6d88\u606f\u88ab\u5e8f\u5217\u5316\uff0c\u672a\u77e5\u7684\u5b57\u6bb5\u4f1a\u968f\u4e4b\u4e00 \u8d77\u88ab\u5e8f\u5217\u5316\u2014\u2014\u6240\u4ee5\uff0c\u5982\u679c\u6d88\u606f\u4f20\u5230\u4e86\u65b0\u4ee3\u7801\u90a3\u91cc\uff0c\u5219\u65b0\u7684\u5b57\u6bb5\u4ecd\u7136\u53ef\u7528\u3002\u6ce8\u610f\uff1a\u5bf9Python\u6765\u8bf4\uff0c\u5bf9\u672a\u77e5\u5b57\u6bb5\u7684\u4fdd\u7559\u7b56\u7565\u662f\u65e0\u6548\u7684\u3002<\/p>\n
\u00b2\u00a0 \u975erequired\u7684\u5b57\u6bb5\u53ef\u4ee5\u79fb\u9664\u2014\u2014\u53ea\u8981\u5b83\u4eec\u7684\u6807\u8bc6\u53f7\u5728\u65b0\u7684\u6d88\u606f\u7c7b\u578b\u4e2d\u4e0d\u518d\u4f7f\u7528\uff08\u66f4\u597d\u7684\u505a\u6cd5\u53ef\u80fd\u662f\u91cd\u547d\u540d\u90a3\u4e2a\u5b57\u6bb5\uff0c\u4f8b\u5982\u5728\u5b57\u6bb5\u524d\u6dfb\u52a0\u201cOBSOLETE_\u201d\u524d\u7f00\uff0c\u90a3\u6837\u7684\u8bdd\uff0c\u4f7f\u7528\u7684.proto\u6587\u4ef6\u7684\u7528\u6237\u5c06\u6765\u5c31\u4e0d\u4f1a\u65e0\u610f\u4e2d\u91cd\u65b0\u4f7f\u7528\u4e86\u90a3\u4e9b\u4e0d\u8be5\u4f7f\u7528\u7684\u6807\u8bc6\u53f7\uff09\u3002<\/p>\n
\u00b2\u00a0 \u4e00\u4e2a\u975erequired\u7684\u5b57\u6bb5\u53ef\u4ee5\u8f6c\u6362\u4e3a\u4e00\u4e2a\u6269\u5c55\uff0c\u53cd\u4e4b\u4ea6\u7136\u2014\u2014\u53ea\u8981\u5b83\u7684\u7c7b\u578b\u548c\u6807\u8bc6\u53f7\u4fdd\u6301\u4e0d\u53d8\u3002<\/p>\n
\u00b2\u00a0 int32,\u00a0uint32,\u00a0int64,\u00a0uint64,\u548cbool\u662f\u5168\u90e8\u517c\u5bb9\u7684\uff0c\u8fd9\u610f\u5473\u7740\u53ef\u4ee5\u5c06\u8fd9\u4e9b\u7c7b\u578b\u4e2d\u7684\u4e00\u4e2a\u8f6c\u6362\u4e3a\u53e6\u5916\u4e00\u4e2a\uff0c\u800c\u4e0d\u4f1a\u7834\u574f\u5411\u524d\u3001 \u5411\u540e\u7684\u517c\u5bb9\u6027\u3002\u5982\u679c\u89e3\u6790\u51fa\u6765\u7684\u6570\u5b57\u4e0e\u5bf9\u5e94\u7684\u7c7b\u578b\u4e0d\u76f8\u7b26\uff0c\u90a3\u4e48\u7ed3\u679c\u5c31\u50cf\u5728C++\u4e2d\u5bf9\u5b83\u8fdb\u884c\u4e86\u5f3a\u5236\u7c7b\u578b\u8f6c\u6362\u4e00\u6837\uff08\u4f8b\u5982\uff0c\u5982\u679c\u628a\u4e00\u4e2a64\u4f4d\u6570\u5b57\u5f53\u4f5cint32\u6765 \u8bfb\u53d6\uff0c\u90a3\u4e48\u5b83\u5c31\u4f1a\u88ab\u622a\u65ad\u4e3a32\u4f4d\u7684\u6570\u5b57\uff09\u3002<\/p>\n
\u00b2\u00a0 sint32\u548csint64\u662f\u4e92\u76f8\u517c\u5bb9\u7684\uff0c\u4f46\u662f\u5b83\u4eec\u4e0e\u5176\u4ed6\u6574\u6570\u7c7b\u578b\u4e0d\u517c\u5bb9\u3002<\/p>\n
\u00b2\u00a0 string\u548cbytes\u662f\u517c\u5bb9\u7684\u2014\u2014\u53ea\u8981bytes\u662f\u6709\u6548\u7684UTF-8\u7f16\u7801\u3002<\/p>\n
\u00b2\u00a0 \u5d4c\u5957\u6d88\u606f\u4e0ebytes\u662f\u517c\u5bb9\u7684\u2014\u2014\u53ea\u8981bytes\u5305\u542b\u8be5\u6d88\u606f\u7684\u4e00\u4e2a\u7f16\u7801\u8fc7\u7684\u7248\u672c\u3002<\/p>\n
\u00b2\u00a0 fixed32\u4e0esfixed32\u662f\u517c\u5bb9\u7684\uff0cfixed64\u4e0esfixed64\u662f\u517c\u5bb9\u7684\u3002<\/p>\n
\u6269\u5c55<\/h2>\n
\u901a\u8fc7\u6269\u5c55\uff0c\u53ef\u4ee5\u5c06\u4e00\u4e2a\u8303\u56f4\u5185\u7684\u5b57\u6bb5\u6807\u8bc6\u53f7\u58f0\u660e\u4e3a\u53ef\u88ab\u7b2c\u4e09\u65b9\u6269\u5c55\u6240\u7528\u3002\u7136\u540e\uff0c\u5176\u4ed6\u4eba\u5c31\u53ef\u4ee5\u5728\u4ed6\u4eec\u81ea\u5df1\u7684.proto\u6587\u4ef6\u4e2d\u4e3a\u8be5\u6d88\u606f\u7c7b\u578b\u58f0\u660e\u65b0\u7684\u5b57\u6bb5\uff0c\u800c\u4e0d\u5fc5\u53bb\u7f16\u8f91\u539f\u59cb\u6587\u4ef6\u4e86\u3002\u770b\u4e2a\u5177\u4f53\u4f8b\u5b50\uff1a<\/p>\n
message Foo {\r\n  \/\/ \u2026\r\n  extensions 100 to 199;\r\n}<\/pre>\n
\u8fd9\u4e2a\u4f8b\u5b50\u8868\u660e\uff1a\u5728\u6d88\u606fFoo\u4e2d\uff0c\u8303\u56f4[100,199]\u4e4b\u5185\u7684\u5b57\u6bb5\u6807\u8bc6\u53f7\u88ab\u4fdd\u7559\u4e3a\u6269\u5c55\u7528\u3002\u73b0\u5728\uff0c\u5176\u4ed6\u4eba\u5c31\u53ef\u4ee5\u5728\u4ed6\u4eec\u81ea\u5df1\u7684.proto\u6587\u4ef6\u4e2d\u6dfb\u52a0\u65b0\u5b57\u6bb5\u5230Foo\u91cc\u4e86\uff0c\u4f46\u662f\u6dfb\u52a0\u7684\u5b57\u6bb5\u6807\u8bc6\u53f7\u8981\u5728\u6307\u5b9a\u7684\u8303\u56f4\u5185\u2014\u2014\u4f8b\u5982\uff1a<\/p>\n
extend Foo {\r\n  optional int32 bar = 126;\r\n}<\/pre>\n
\u8fd9\u4e2a\u4f8b\u5b50\u8868\u660e\uff1a\u6d88\u606fFoo\u73b0\u5728\u6709\u4e00\u4e2a\u540d\u4e3abar\u7684optional\u00a0int32\u5b57\u6bb5\u3002<\/p>\n
\u5f53\u7528\u6237\u7684Foo\u6d88\u606f\u88ab\u7f16\u7801\u7684\u65f6\u5019\uff0c\u6570\u636e\u7684\u4f20\u8f93\u683c\u5f0f\u4e0e\u7528\u6237\u5728Foo\u91cc\u5b9a\u4e49\u65b0\u5b57\u6bb5\u7684\u6548\u679c\u662f\u5b8c\u5168\u4e00\u6837\u7684\u3002<\/p>\n
\u7136\u800c\uff0c\u8981\u5728\u7a0b\u5e8f\u4ee3\u7801\u4e2d\u8bbf\u95ee\u6269\u5c55\u5b57\u6bb5\u7684\u65b9\u6cd5\u4e0e\u8bbf\u95ee\u666e\u901a\u7684\u5b57\u6bb5\u7a0d\u6709\u4e0d\u540c\u2014\u2014\u751f\u6210\u7684\u6570\u636e\u8bbf\u95ee\u4ee3\u7801\u4e3a\u6269\u5c55\u51c6\u5907\u4e86\u7279\u6b8a\u7684\u8bbf\u95ee\u51fd\u6570\u6765\u8bbf\u95ee\u5b83\u3002\u4f8b\u5982\uff0c\u4e0b\u9762\u662f\u5982\u4f55\u5728C++\u4e2d\u8bbe\u7f6ebar\u7684\u503c\uff1a<\/p>\n
Foo foo;\r\nfoo.SetExtension(bar, 15);<\/pre>\n
\u7c7b\u4f3c\u5730\uff0cFoo\u7c7b\u4e5f\u5b9a\u4e49\u4e86\u6a21\u677f\u51fd\u6570 HasExtension()\uff0cClearExtension()\uff0cGetExtension()\uff0cMutableExtension()\uff0c\u4ee5\u53ca AddExtension()\u3002\u8fd9\u4e9b\u51fd\u6570\u7684\u8bed\u4e49\u90fd\u4e0e\u5bf9\u5e94\u7684\u666e\u901a\u5b57\u6bb5\u7684\u8bbf\u95ee\u51fd\u6570\u76f8\u7b26\u3002\u8981\u67e5\u770b\u66f4\u591a\u4f7f\u7528\u6269\u5c55\u7684\u4fe1\u606f\uff0c\u8bf7\u53c2\u8003\u76f8\u5e94\u8bed\u8a00\u7684\u4ee3\u7801\u751f\u6210\u6307\u5357\u3002\u6ce8\uff1a\u6269\u5c55\u53ef \u4ee5\u662f\u4efb\u4f55\u5b57\u6bb5\u7c7b\u578b\uff0c\u5305\u62ec\u6d88\u606f\u7c7b\u578b\u3002<\/p>\n
\u5d4c\u5957\u7684\u6269\u5c55<\/h2>\n
\u53ef\u4ee5\u5728\u53e6\u4e00\u4e2a\u7c7b\u578b\u7684\u8303\u56f4\u5185\u58f0\u660e\u6269\u5c55\uff0c\u5982\uff1a<\/p>\n
message Baz {\r\n  extend Foo {\r\n    optional int32 bar = 126;\r\n  }\r\n  \u2026\r\n}<\/pre>\n
\u5728\u6b64\u4f8b\u4e2d\uff0c\u8bbf\u95ee\u6b64\u6269\u5c55\u7684C++\u4ee3\u7801\u5982\u4e0b\uff1a<\/p>\n
Foo foo;\r\nfoo.SetExtension(Baz::bar, 15);<\/pre>\n
\u4e00\u4e2a\u901a\u5e38\u7684\u8bbe\u8ba1\u6a21\u5f0f\u5c31\u662f\uff1a\u5728\u6269\u5c55\u7684\u5b57\u6bb5\u7c7b\u578b\u7684\u8303\u56f4\u5185\u5b9a\u4e49\u8be5\u6269\u5c55\u2014\u2014\u4f8b\u5982\uff0c\u4e0b\u9762\u662f\u4e00\u4e2aFoo\u7684\u6269\u5c55\uff08\u8be5\u6269\u5c55\u662fBaz\u7c7b\u578b\u7684\uff09\uff0c\u5176\u4e2d\uff0c\u6269\u5c55\u88ab\u5b9a\u4e49\u4e3a\u4e86Baz\u7684\u4e00\u90e8\u5206\uff1a<\/p>\n
message Baz {\r\n  extend Foo {\r\n    optional Baz foo_ext = 127;\r\n  }\r\n  \u2026\r\n}<\/pre>\n
\u7136\u800c\uff0c\u5e76\u6ca1\u6709\u5f3a\u5236\u8981\u6c42\u4e00\u4e2a\u6d88\u606f\u7c7b\u578b\u7684\u6269\u5c55\u4e00\u5b9a\u8981\u5b9a\u4e49\u5728\u90a3\u4e2a\u6d88\u606f\u4e2d\u3002\u4e5f\u53ef\u4ee5\u8fd9\u6837\u505a\uff1a<\/p>\n
message Baz {\r\n  \u2026\r\n}\r\nextend Foo {\r\n  optional Baz foo_baz_ext = 127;\r\n}<\/pre>\n
\u4e8b\u5b9e\u4e0a\uff0c\u8fd9\u79cd\u8bed\u6cd5\u683c\u5f0f\u66f4\u80fd\u9632\u6b62\u5f15\u8d77\u6df7\u6dc6\u3002\u6b63\u5982\u4e0a\u9762\u6240\u63d0\u5230\u7684\uff0c\u5d4c\u5957\u7684\u8bed\u6cd5\u901a\u5e38\u88ab\u9519\u8bef\u5730\u8ba4\u4e3a\u6709\u5b50\u7c7b\u5316\u7684\u5173\u7cfb\u2014\u2014\u5c24\u5176\u662f\u5bf9\u90a3\u4e9b\u8fd8\u4e0d\u719f\u6089\u6269\u5c55\u7684\u7528\u6237\u6765\u8bf4\u3002<\/p>\n
\u00d8\u00a0\u00a0\u9009\u62e9\u53ef\u6269\u5c55\u7684\u6807\u7b26\u53f7<\/p>\n
\u5728\u540c\u4e00\u4e2a\u6d88\u606f\u7c7b\u578b\u4e2d\u4e00\u5b9a\u8981\u786e\u4fdd\u4e24\u4e2a\u7528\u6237\u4e0d\u4f1a\u6269\u5c55\u65b0\u589e\u76f8\u540c\u7684\u6807\u8bc6\u53f7\uff0c\u5426\u5219\u53ef\u80fd\u4f1a\u5bfc\u81f4\u6570\u636e\u7684\u4e0d\u4e00\u81f4\u3002\u53ef\u4ee5\u901a\u8fc7\u4e3a\u65b0\u9879\u76ee\u5b9a\u4e49\u4e00\u4e2a\u53ef\u6269\u5c55\u6807\u8bc6\u53f7\u89c4\u5219\u6765\u9632\u6b62\u8be5\u60c5\u51b5\u7684\u53d1\u751f\u3002<\/p>\n
\u5982\u679c\u6807\u8bc6\u53f7\u9700\u8981\u5f88\u5927\u7684\u6570\u91cf\u65f6\uff0c\u53ef\u4ee5\u5c06\u8be5\u53ef\u6269\u5c55\u6807\u7b26\u53f7\u7684\u8303\u56f4\u6269\u5927\u81f3max\uff0c\u5176\u4e2dmax\u662f229\u00a0- 1, \u6216536,870,911\u3002\u5982\u4e0b\u6240\u793a\uff1a<\/p>\n
message Foo {\r\n  extensions 1000 to max;\r\n}<\/pre>\n
\u901a\u5e38\u60c5\u51b5\u4e0b\u5728\u9009\u62e9\u6807\u7b26\u53f7\u65f6\uff0c\u6807\u8bc6\u53f7\u4ea7\u751f\u7684\u89c4\u5219\u4e2d\u5e94\u8be5\u907f\u5f00[19000\uff0d19999]\u4e4b\u95f4\u7684\u6570\u5b57\uff0c\u56e0\u4e3a\u8fd9\u4e9b\u5df2\u7ecf\u88abProtocol Buffers\u5b9e\u73b0\u4e2d\u9884\u7559\u4e86\u3002<\/p>\n
\u5305\uff08Package\uff09<\/h2>\n
\u5f53\u7136\u53ef\u4ee5\u4e3a.proto\u6587\u4ef6\u65b0\u589e\u4e00\u4e2a\u53ef\u9009\u7684package\u58f0\u660e\u7b26\uff0c\u7528\u6765\u9632\u6b62\u4e0d\u540c\u7684\u6d88\u606f\u7c7b\u578b\u6709\u547d\u540d\u51b2\u7a81\u3002\u5982\uff1a<\/p>\n
package foo.bar;\r\nmessage Open { ... }<\/pre>\n
\u5728\u5176\u4ed6\u7684\u6d88\u606f\u683c\u5f0f\u5b9a\u4e49\u4e2d\u53ef\u4ee5\u4f7f\u7528\u5305\u540d+\u6d88\u606f\u540d\u7684\u65b9\u5f0f\u6765\u5b9a\u4e49\u57df\u7684\u7c7b\u578b\uff0c\u5982\uff1a<\/p>\n
message Foo {\r\n  ...\r\n  required foo.bar.Open open = 1;\r\n  ...\r\n}<\/pre>\n
\u5305\u7684\u58f0\u660e\u7b26\u4f1a\u6839\u636e\u4f7f\u7528\u8bed\u8a00\u7684\u4e0d\u540c\u5f71\u54cd\u751f\u6210\u7684\u4ee3\u7801\u3002\u5bf9\u4e8eC++\uff0c\u4ea7\u751f\u7684\u7c7b\u4f1a\u88ab\u5305\u88c5\u5728C++\u7684\u547d\u540d\u7a7a\u95f4\u4e2d\uff0c\u5982\u4e0a\u4f8b\u4e2d\u7684Open\u4f1a\u88ab\u5c01\u88c5\u5728 foo::bar\u7a7a\u95f4\u4e2d\uff1b\u5bf9\u4e8eJava\uff0c\u5305\u58f0\u660e\u7b26\u4f1a\u53d8\u4e3ajava\u7684\u4e00\u4e2a\u5305\uff0c\u9664\u975e\u5728.proto\u6587\u4ef6\u4e2d\u63d0\u4f9b\u4e86\u4e00\u4e2a\u660e\u786e\u6709java_package\uff1b\u5bf9\u4e8e Python\uff0c\u8fd9\u4e2a\u5305\u58f0\u660e\u7b26\u662f\u88ab\u5ffd\u7565\u7684\uff0c\u56e0\u4e3aPython\u6a21\u5757\u662f\u6309\u7167\u5176\u5728\u6587\u4ef6\u7cfb\u7edf\u4e2d\u7684\u4f4d\u7f6e\u8fdb\u884c\u7ec4\u7ec7\u7684\u3002<\/p>\n
\u00d8\u00a0\u00a0\u5305\u53ca\u540d\u79f0\u7684\u89e3\u6790<\/p>\n
Protocol buffer\u8bed\u8a00\u4e2d\u7c7b\u578b\u540d\u79f0\u7684\u89e3\u6790\u4e0eC++\u662f\u4e00\u81f4\u7684\uff1a\u9996\u5148\u4ece\u6700\u5185\u90e8\u5f00\u59cb\u67e5\u627e\uff0c\u4f9d\u6b21\u5411\u5916\u8fdb\u884c\uff0c\u6bcf\u4e2a\u5305\u4f1a\u88ab\u770b\u4f5c\u662f\u5176\u7236\u7c7b\u5305\u7684\u5185\u90e8\u7c7b\u3002\u5f53\u7136\u5bf9\u4e8e \uff08foo.bar.Baz\uff09\u8fd9\u6837\u4ee5\u201c.\u201d\u5206\u9694\u7684\u610f\u5473\u7740\u662f\u4ece\u6700\u5916\u56f4\u5f00\u59cb\u7684\u3002ProtocolBuffer\u7f16\u8bd1\u5668\u4f1a\u89e3\u6790.proto\u6587\u4ef6\u4e2d\u5b9a\u4e49\u7684\u6240\u6709\u7c7b\u578b\u540d\u3002 \u5bf9\u4e8e\u4e0d\u540c\u8bed\u8a00\u7684\u4ee3\u7801\u751f\u6210\u5668\u4f1a\u77e5\u9053\u5982\u4f55\u6765\u6307\u5411\u6bcf\u4e2a\u5177\u4f53\u7684\u7c7b\u578b\uff0c\u5373\u4f7f\u5b83\u4eec\u4f7f\u7528\u4e86\u4e0d\u540c\u7684\u89c4\u5219\u3002<\/p>\n
\u5b9a\u4e49\u670d\u52a1(Service)<\/h2>\n
\u5982\u679c\u60f3\u8981\u5c06\u6d88\u606f\u7c7b\u578b\u7528\u5728RPC(\u8fdc\u7a0b\u65b9\u6cd5\u8c03\u7528)\u7cfb\u7edf\u4e2d\uff0c\u53ef\u4ee5\u5728.proto\u6587\u4ef6\u4e2d\u5b9a\u4e49\u4e00\u4e2aRPC\u670d\u52a1\u63a5\u53e3\uff0cprotocol buffer\u7f16\u8bd1\u5668\u5c06\u4f1a\u6839\u636e\u6240\u9009\u62e9\u7684\u4e0d\u540c\u8bed\u8a00\u751f\u6210\u670d\u52a1\u63a5\u53e3\u4ee3\u7801\u53ca\u5b58\u6839\u3002\u5982\uff0c\u60f3\u8981\u5b9a\u4e49\u4e00\u4e2aRPC\u670d\u52a1\u5e76\u5177\u6709\u4e00\u4e2a\u65b9\u6cd5\uff0c\u8be5\u65b9\u6cd5\u80fd\u591f\u63a5\u6536 SearchRequest\u5e76\u8fd4\u56de\u4e00\u4e2aSearchResponse\uff0c\u6b64\u65f6\u53ef\u4ee5\u5728.proto\u6587\u4ef6\u4e2d\u8fdb\u884c\u5982\u4e0b\u5b9a\u4e49\uff1a<\/p>\n
service SearchService {\r\n  rpc Search (SearchRequest) returns (SearchResponse);\r\n}<\/pre>\n
protocol\u7f16\u8bd1\u5668\u5c06\u4ea7\u751f\u4e00\u4e2a\u62bd\u8c61\u63a5\u53e3SearchService\u4ee5\u53ca\u4e00\u4e2a\u76f8\u5e94\u7684\u5b58\u6839\u5b9e\u73b0\u3002\u5b58\u6839\u5c06\u6240\u6709\u7684\u8c03\u7528\u6307\u5411RpcChannel\uff0c\u5b83\u662f\u4e00 \u4e2a\u62bd\u8c61\u63a5\u53e3\uff0c\u5fc5\u987b\u5728RPC\u7cfb\u7edf\u4e2d\u5bf9\u8be5\u63a5\u53e3\u8fdb\u884c\u5b9e\u73b0\u3002\u5982\uff0c\u53ef\u4ee5\u5b9e\u73b0RpcChannel\u4ee5\u5b8c\u6210\u5e8f\u5217\u5316\u6d88\u606f\u5e76\u901a\u8fc7HTTP\u65b9\u5f0f\u6765\u53d1\u9001\u5230\u4e00\u4e2a\u670d\u52a1\u5668\u3002\u6362\u53e5\u8bdd\u8bf4\uff0c \u4ea7\u751f\u7684\u5b58\u6839\u63d0\u4f9b\u4e86\u4e00\u4e2a\u7c7b\u578b\u5b89\u5168\u7684\u63a5\u53e3\u7528\u6765\u5b8c\u6210\u57fa\u4e8eprotocolbuffer\u7684RPC\u8c03\u7528\uff0c\u800c\u4e0d\u662f\u5c06\u4f60\u9650\u5b9a\u5728\u4e00\u4e2a\u7279\u5b9a\u7684RPC\u7684\u5b9e\u73b0\u4e2d\u3002C++\u4e2d\u7684\u4ee3\u7801 \u5982\u4e0b\u6240\u793a\uff1a<\/p>\n
using google::protobuf;\r\n\r\nprotobuf::RpcChannel* channel;\r\nprotobuf::RpcController* controller;\r\nSearchService* service;\r\nSearchRequest request;\r\nSearchResponse response;\r\n\r\nvoid DoSearch() {\r\n  \/\/ You provide classes MyRpcChannel and MyRpcController, which implement\r\n  \/\/ the abstract interfaces protobuf::RpcChannel and protobuf::RpcController.\r\n  channel = new MyRpcChannel(\"somehost.example.com:1234\");\r\n  controller = new MyRpcController;\r\n  \r\n\r\n\/\/ The protocol compiler generates the SearchService class based on the\r\n  \/\/ definition given above.\r\n \r\n\r\nservice = new SearchService::Stub(channel);\r\n  \/\/ Set up the request.\r\n  request.set_query(\"protocol buffers\");\r\n\r\n  \/\/ Execute the RPC.\r\n  service->Search(controller, request, response, protobuf::NewCallback(&Done));\r\n}\r\n\r\nvoid Done() {\r\n  delete service;\r\n  delete channel;\r\n  delete controller;\r\n}<\/pre>\n
\u6240\u6709service\u7c7b\u90fd\u5fc5\u987b\u5b9e\u73b0Service\u63a5\u53e3\uff0c\u5b83\u63d0\u4f9b\u4e86\u4e00\u79cd\u7528\u6765\u8c03\u7528\u5177\u4f53\u65b9\u6cd5\u7684\u65b9\u5f0f\uff0c\u5373\u5728\u7f16\u8bd1\u671f\u4e0d\u9700\u8981\u77e5\u9053\u65b9\u6cd5\u540d\u53ca\u5b83\u7684\u8f93\u5165\u3001\u8f93\u51fa\u7c7b\u578b\u3002\u5728\u670d\u52a1\u5668\u7aef\uff0c\u901a\u8fc7\u670d\u52a1\u6ce8\u518c\u5b83\u53ef\u4ee5\u88ab\u7528\u6765\u5b9e\u73b0\u4e00\u4e2aRPC Server\u3002<\/p>\n
using google::protobuf;\r\n\r\nclass ExampleSearchService : public SearchService {\r\n public:\r\n  void Search(protobuf::RpcController* controller,\r\n              const SearchRequest* request,\r\n              SearchResponse* response,\r\n              protobuf::Closure* done) {\r\n    if (request->query() == \"google\") {\r\n      response->add_result()->set_url(\"http:\/\/www.google.com\");\r\n    } else if (request->query() == \"protocol buffers\") {\r\n      response->add_result()->set_url(\"http:\/\/protobuf.googlecode.com\");\r\n    }\r\n    done->Run();\r\n  }\r\n};\r\n\r\nint main() {\r\n  \/\/ You provide class MyRpcServer.  It does not have to implement any\r\n  \/\/ particular interface; this is just an example.\r\n  MyRpcServer server;\r\n\r\n  protobuf::Service* service = new ExampleSearchService;\r\n  server.ExportOnPort(1234, service);\r\n  server.Run();\r\n\r\n  delete service;\r\n  return 0;\r\n}<\/pre>\n
\u9009\u9879\uff08Options\uff09<\/h2>\n
\u5728\u5b9a\u4e49.proto\u6587\u4ef6\u65f6\u80fd\u591f\u6807\u6ce8\u4e00\u7cfb\u5217\u7684options\u3002Options\u5e76\u4e0d\u6539\u53d8\u6574\u4e2a\u6587\u4ef6\u58f0\u660e\u7684\u542b\u4e49\uff0c\u4f46\u5374\u80fd\u591f\u5f71\u54cd\u7279\u5b9a\u73af\u5883\u4e0b\u5904\u7406\u65b9\u5f0f\u3002\u5b8c\u6574\u7684\u53ef\u7528\u9009\u9879\u53ef\u4ee5\u5728google\/protobuf\/descriptor.proto<\/code>\u627e\u5230\u3002<\/p>\n
\u4e00\u4e9b\u9009\u9879\u662f\u6587\u4ef6\u7ea7\u522b\u7684\uff0c\u610f\u5473\u7740\u5b83\u53ef\u4ee5\u4f5c\u7528\u4e8e\u6700\u5916\u8303\u56f4\uff0c\u4e0d\u5305\u542b\u5728\u4efb\u4f55\u6d88\u606f\u5185\u90e8\u3001enum\u6216\u670d\u52a1\u5b9a\u4e49\u4e2d\u3002\u4e00\u4e9b\u9009\u9879\u662f\u6d88\u606f\u7ea7\u522b\u7684\uff0c\u610f\u5473\u7740\u5b83\u53ef\u4ee5\u7528\u5728\u6d88\u606f\u5b9a \u4e49\u7684\u5185\u90e8\u3002\u5f53\u7136\u6709\u4e9b\u9009\u9879\u53ef\u4ee5\u4f5c\u7528\u5728\u57df\u3001enum\u7c7b\u578b\u3001enum\u503c\u3001\u670d\u52a1\u7c7b\u578b\u53ca\u670d\u52a1\u65b9\u6cd5\u4e2d\u3002\u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u5e76\u6ca1\u6709\u4e00\u79cd\u6709\u6548\u7684\u9009\u9879\u80fd\u4f5c\u7528\u4e8e\u6240\u6709\u7684\u7c7b\u578b\u3002<\/p>\n
\u5982\u4e0b\u5c31\u662f\u4e00\u4e9b\u5e38\u7528\u7684\u9009\u62e9\uff1a<\/p>\n
\u00b2\u00a0\u00a0java_package<\/code>\u00a0(file option): \u8fd9\u4e2a\u9009\u9879\u8868\u660e\u751f\u6210java\u7c7b\u6240\u5728\u7684\u5305\u3002\u5982\u679c\u5728.proto\u6587\u4ef6\u4e2d\u6ca1\u6709\u660e\u786e\u7684\u58f0\u660ejava_package\uff0c\u5c31\u91c7\u7528\u9ed8\u8ba4\u7684\u5305\u540d\u3002\u5f53\u7136\u4e86\uff0c\u9ed8\u8ba4\u65b9\u5f0f\u4ea7\u751f\u7684 java\u5305\u540d\u5e76\u4e0d\u662f\u6700\u597d\u7684\u65b9\u5f0f\uff0c\u6309\u7167\u5e94\u7528\u540d\u79f0\u5012\u5e8f\u65b9\u5f0f\u8fdb\u884c\u6392\u5e8f\u7684\u3002\u5982\u679c\u4e0d\u9700\u8981\u4ea7\u751fjava\u4ee3\u7801\uff0c\u5219\u8be5\u9009\u9879\u5c06\u4e0d\u8d77\u4efb\u4f55\u4f5c\u7528\u3002\u5982\uff1a<\/p>\n
option java_package = \"com.example.foo\";<\/pre>\n
\u00b2\u00a0\u00a0java_outer_classname<\/code>\u00a0(file option): \u8be5\u9009\u9879\u8868\u660e\u60f3\u8981\u751f\u6210Java\u7c7b\u7684\u540d\u79f0\u3002\u5982\u679c\u5728.proto\u6587\u4ef6\u4e2d\u6ca1\u6709\u660e\u786e\u7684java_outer_classname<\/code>\u5b9a\u4e49\uff0c\u751f\u6210\u7684class\u540d\u79f0\u5c06\u4f1a\u6839\u636e.proto\u6587\u4ef6\u7684\u540d\u79f0\u91c7\u7528\u9a7c\u5cf0\u5f0f\u7684\u547d\u540d\u65b9\u5f0f\u8fdb\u884c\u751f\u6210\u3002\u5982\uff08foo_bar.proto\u751f\u6210\u7684java\u7c7b\u540d\u4e3aFooBar.java\uff09,\u5982\u679c\u4e0d\u751f\u6210java\u4ee3\u7801\uff0c\u5219\u8be5\u9009\u9879\u4e0d\u8d77\u4efb\u4f55\u4f5c\u7528\u3002\u5982\uff1a<\/p>\n
option java_outer_classname = \"Ponycopter\";<\/pre>\n
\u00b2\u00a0 optimize_for\u00a0(fileoption): \u53ef\u4ee5\u88ab\u8bbe\u7f6e\u4e3a\u00a0SPEED,\u00a0CODE_SIZE,or\u00a0LITE_RUNTIME\u3002\u8fd9\u4e9b\u503c\u5c06\u901a\u8fc7\u5982\u4e0b\u7684\u65b9\u5f0f\u5f71\u54cdC++\u53cajava\u4ee3\u7801\u7684\u751f\u6210\uff1a<\/p>\n
\u00b7\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0SPEED\u00a0(default): protocol buffer\u7f16\u8bd1\u5668\u5c06\u901a\u8fc7\u5728\u6d88\u606f\u7c7b\u578b\u4e0a\u6267\u884c\u5e8f\u5217\u5316\u3001\u8bed\u6cd5\u5206\u6790\u53ca\u5176\u4ed6\u901a\u7528\u7684\u64cd\u4f5c\u3002\u8fd9\u79cd\u4ee3\u7801\u662f\u6700\u4f18\u7684\u3002<\/p>\n
\u00b7\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0CODE_SIZE: protocol buffer\u7f16\u8bd1\u5668\u5c06\u4f1a\u4ea7\u751f\u6700\u5c11\u91cf\u7684\u7c7b\uff0c\u901a\u8fc7\u5171\u4eab\u6216\u57fa\u4e8e\u53cd\u5c04\u7684\u4ee3\u7801\u6765\u5b9e\u73b0\u5e8f\u5217\u5316\u3001\u8bed\u6cd5\u5206\u6790\u53ca\u5404\u79cd\u5176\u5b83\u64cd\u4f5c\u3002\u91c7\u7528\u8be5\u65b9\u5f0f\u4ea7\u751f\u7684\u4ee3\u7801\u5c06\u6bd4SPEED\u8981\u5c11\u5f97\u591a\uff0c \u4f46\u662f\u64cd\u4f5c\u8981\u76f8\u5bf9\u6162\u4e9b\u3002\u5f53\u7136\u5b9e\u73b0\u7684\u7c7b\u53ca\u5176\u5bf9\u5916\u7684API\u4e0eSPEED\u6a21\u5f0f\u90fd\u662f\u4e00\u6837\u7684\u3002\u8fd9\u79cd\u65b9\u5f0f\u7ecf\u5e38\u7528\u5728\u4e00\u4e9b\u5305\u542b\u5927\u91cf\u7684.proto\u6587\u4ef6\u800c\u4e14\u5e76\u4e0d\u76f2\u76ee\u8ffd\u6c42\u901f\u5ea6\u7684 \u5e94\u7528\u4e2d\u3002<\/p>\n
\u00b7\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0LITE_RUNTIME: protocol buffer\u7f16\u8bd1\u5668\u4f9d\u8d56\u4e8e\u8fd0\u884c\u65f6\u6838\u5fc3\u7c7b\u5e93\u6765\u751f\u6210\u4ee3\u7801\uff08\u5373\u91c7\u7528libprotobuf-lite\u00a0\u66ff\u4ee3libprotobuf\uff09\u3002\u8fd9\u79cd\u6838\u5fc3\u7c7b\u5e93\u7531\u4e8e\u5ffd\u7565\u4e86\u4e00 \u4e9b\u63cf\u8ff0\u7b26\u53ca\u53cd\u5c04\uff0c\u8981\u6bd4\u5168\u7c7b\u5e93\u5c0f\u5f97\u591a\u3002\u8fd9\u79cd\u6a21\u5f0f\u7ecf\u5e38\u5728\u79fb\u52a8\u624b\u673a\u5e73\u53f0\u5e94\u7528\u591a\u4e00\u4e9b\u3002\u7f16\u8bd1\u5668\u91c7\u7528\u8be5\u6a21\u5f0f\u4ea7\u751f\u7684\u65b9\u6cd5\u5b9e\u73b0\u4e0eSPEED\u6a21\u5f0f\u4e0d\u76f8\u4e0a\u4e0b\uff0c\u4ea7\u751f\u7684\u7c7b\u901a\u8fc7\u5b9e\u73b0 MessageLite\u63a5\u53e3\uff0c\u4f46\u5b83\u4ec5\u4ec5\u662fMessager\u63a5\u53e3\u7684\u4e00\u4e2a\u5b50\u96c6\u3002<\/p>\n
option optimize_for = CODE_SIZE;<\/pre>\n
\u00b2\u00a0\u00a0cc_generic_services<\/code>,\u00a0java_generic_services<\/code>,\u00a0py_generic_services<\/code>\u00a0(file options): \u5728C++\u3001java\u3001python\u4e2dprotocol buffer\u7f16\u8bd1\u5668\u662f\u5426\u5e94\u8be5\u57fa\u4e8e\u670d\u52a1\u5b9a\u4e49\u4ea7\u751f\u62bd\u8c61\u670d\u52a1\u4ee3\u7801\u3002\u7531\u4e8e\u5386\u53f2\u9057\u7559\u95ee\u9898\uff0c\u8be5\u503c\u9ed8\u8ba4\u662ftrue\u3002\u4f46\u662f\u81ea2.3.0\u7248\u672c\u4ee5\u6765\uff0c\u5b83\u88ab\u8ba4\u4e3a\u901a\u8fc7\u63d0\u4f9b\u4ee3\u7801\u751f\u6210 \u5668\u63d2\u4ef6\u6765\u5bf9RPC\u5b9e\u73b0\u66f4\u53ef\u53d6\uff0c\u800c\u4e0d\u662f\u4f9d\u8d56\u4e8e\u201c\u62bd\u8c61\u201d\u670d\u52a1\u3002<\/p>\n
\/\/ This file relies on plugins to generate service code.\r\noption cc_generic_services = false;\r\noption java_generic_services = false;\r\noption py_generic_services = false;<\/pre>\n
\u00b2\u00a0\u00a0message_set_wire_format<\/code>\u00a0(message option):\u5982\u679c\u8be5\u503c\u88ab\u8bbe\u7f6e\u4e3atrue\uff0c\u8be5\u6d88\u606f\u5c06\u4f7f\u7528\u4e00\u79cd\u4e0d\u540c\u7684\u4e8c\u8fdb\u5236\u683c\u5f0f\u6765\u4e0eGoogle\u5185\u90e8\u7684MessageSet\u7684\u8001\u683c\u5f0f\u76f8\u517c\u5bb9\u3002\u5bf9\u4e8eGoogle\u5916\u90e8\u7684\u7528\u6237\u6765\u8bf4\uff0c\u8be5\u9009\u9879\u5c06\u4e0d\u4f1a\u88ab\u7528\u5230\u3002\u5982\u4e0b\u6240\u793a:<\/p>\n
message Foo {\r\n  option message_set_wire_format = true;\r\n  extensions 4 to max;\r\n}<\/pre>\n
\u00b2\u00a0\u00a0packed<\/code>\u00a0(field option): \u5982\u679c\u8be5\u9009\u9879\u5728\u4e00\u4e2a\u6574\u578b\u57fa\u672c\u7c7b\u578b\u4e0a\u88ab\u8bbe\u7f6e\u4e3a\u771f\uff0c\u5219\u91c7\u7528\u66f4\u7d27\u51d1\u7684\u7f16\u7801\u65b9\u5f0f\u3002\u5f53\u7136\u4f7f\u7528\u8be5\u503c\u5e76\u4e0d\u4f1a\u5bf9\u6570\u503c\u9020\u6210\u4efb\u4f55\u635f\u5931\u3002\u57282.3.0\u7248\u672c\u4e4b\u524d\uff0c\u89e3\u6790\u5668\u5c06\u4f1a\u5ffd\u7565\u90a3\u4e9b \u975e\u671f\u671b\u7684\u5305\u88c5\u503c\u3002\u56e0\u6b64\uff0c\u5b83\u4e0d\u53ef\u80fd\u5728\u4e0d\u7834\u574f\u73b0\u6709\u6846\u67b6\u7684\u517c\u5bb9\u6027\u4e0a\u800c\u6539\u53d8\u538b\u7f29\u683c\u5f0f\u3002\u57282.3.0\u4e4b\u540e\uff0c\u8fd9\u79cd\u6539\u53d8\u5c06\u662f\u5b89\u5168\u7684\uff0c\u89e3\u6790\u5668\u80fd\u591f\u63a5\u53d7\u4e0a\u8ff0\u4e24\u79cd\u683c\u5f0f\uff0c\u4f46\u662f\u5728 \u5904\u7406protobuf\u8001\u7248\u672c\u7a0b\u5e8f\u65f6\uff0c\u8fd8\u662f\u8981\u591a\u7559\u610f\u4e00\u4e0b\u3002<\/p>\n
repeated int32 samples = 4 [packed=true];<\/pre>\n
\u00b2\u00a0\u00a0deprecated<\/code>\u00a0(field option): \u5982\u679c\u8be5\u9009\u9879\u88ab\u8bbe\u7f6e\u4e3atrue\uff0c\u8868\u660e\u8be5\u5b57\u6bb5\u5df2\u7ecf\u88ab\u5f03\u7528\u4e86\uff0c\u5728\u65b0\u4ee3\u7801\u4e2d\u4e0d\u5efa\u8bae\u4f7f\u7528\u3002\u5728\u591a\u6570\u8bed\u8a00\u4e2d\uff0c\u8fd9\u5e76\u6ca1\u6709\u5b9e\u9645\u7684\u542b\u4e49\u3002\u5728java\u4e2d\uff0c\u5b83\u5c06\u4f1a\u53d8\u6210\u4e00\u4e2a\u00a0@Deprecated<\/code>\u6ce8\u91ca\u3002\u4e5f\u8bb8\u5728\u5c06\u6765\uff0c\u5176\u5b83\u57fa\u4e8e\u8bed\u8a00\u58f0\u660e\u7684\u4ee3\u7801\u5728\u751f\u6210\u65f6\u4e5f\u4f1a\u5982\u6b64\u4f7f\u7528\uff0c\u5f53\u4f7f\u7528\u8be5\u5b57\u6bb5\u65f6\uff0c\u7f16\u8bd1\u5668\u5c06\u81ea\u52a8\u62a5\u8b66\u3002\u5982\uff1a<\/p>\n
optional int32 old_field = 6 [deprecated=true];<\/pre>\n
\u00d8\u00a0\u81ea\u5b9a\u4e49\u9009\u9879<\/h3>\n
ProtocolBuffers\u5141\u8bb8\u81ea\u5b9a\u4e49\u5e76\u4f7f\u7528\u9009\u9879\u3002\u8be5\u529f\u80fd\u5e94\u8be5\u5c5e\u4e8e\u4e00\u4e2a\u9ad8\u7ea7\u7279\u6027\uff0c\u5bf9\u4e8e\u5927\u90e8\u5206\u4eba\u662f\u7528\u4e0d\u5230\u7684\u3002\u7531\u4e8eoptions\u662f\u5b9a\u5728\u00a0google\/protobuf\/descriptor.proto\u4e2d\u7684\uff0c\u56e0\u6b64\u4f60\u53ef\u4ee5\u5728\u8be5\u6587\u4ef6\u4e2d\u8fdb\u884c\u6269\u5c55\uff0c\u5b9a\u4e49\u81ea\u5df1\u7684\u9009\u9879\u3002\u5982\uff1a<\/p>\n
import \"google\/protobuf\/descriptor.proto\";\r\nextend google.protobuf.MessageOptions {\r\n  optional string my_option = 51234;\r\n}\r\nmessage MyMessage {\r\n  option (my_option) = \"Hello world!\";\r\n}<\/pre>\n
\u5728\u4e0a\u8ff0\u4ee3\u7801\u4e2d\uff0c\u901a\u8fc7\u5bf9MessageOptions\u8fdb\u884c\u6269\u5c55\u5b9a\u4e49\u4e86\u4e00\u4e2a\u65b0\u7684\u6d88\u606f\u7ea7\u522b\u7684\u9009\u9879\u3002\u5f53\u4f7f\u7528\u8be5\u9009\u9879\u65f6\uff0c\u9009\u9879\u7684\u540d\u79f0\u9700\u8981\u4f7f\u7528\uff08\uff09\u5305\u88f9\u8d77\u6765\uff0c\u4ee5\u8868\u660e\u5b83\u662f\u4e00\u4e2a\u6269\u5c55\u3002\u5728C++\u4ee3\u7801\u4e2d\u53ef\u4ee5\u770b\u51famy_option\u662f\u4ee5\u5982\u4e0b\u65b9\u5f0f\u88ab\u8bfb\u53d6\u7684\u3002<\/p>\n
string value = MyMessage::descriptor()->options().GetExtension(my_option);<\/pre>\n
\u5728Java\u4ee3\u7801\u4e2d\u7684\u8bfb\u53d6\u65b9\u5f0f\u5982\u4e0b\uff1a<\/p>\n
String value = MyProtoFile.MyMessage.getDescriptor().getOptions().getExtension(MyProtoFile.myOption);<\/pre>\n
\u6b63\u5982\u4e0a\u9762\u7684\u8bfb\u53d6\u65b9\u5f0f\uff0c\u5b9a\u5236\u9009\u9879\u5bf9\u4e8ePython\u5e76\u4e0d\u652f\u6301\u3002\u5b9a\u5236\u9009\u9879\u5728protocol buffer\u8bed\u8a00\u4e2d\u53ef\u7528\u4e8e\u4efb\u4f55\u7ed3\u6784\u3002\u4e0b\u9762\u5c31\u662f\u4e00\u4e9b\u5177\u4f53\u7684\u4f8b\u5b50\uff1a<\/p>\n
import \"google\/protobuf\/descriptor.proto\";\r\nextend google.protobuf.FileOptions {\r\n  optional string my_file_option = 50000;\r\n}\r\nextend google.protobuf.MessageOptions {\r\n  optional int32 my_message_option = 50001;\r\n}\r\nextend google.protobuf.FieldOptions {\r\n  optional float my_field_option = 50002;\r\n}\r\nextend google.protobuf.EnumOptions {\r\n  optional bool my_enum_option = 50003;\r\n}\r\nextend google.protobuf.EnumValueOptions {\r\n  optional uint32 my_enum_value_option = 50004;\r\n}\r\nextend google.protobuf.ServiceOptions {\r\n  optional MyEnum my_service_option = 50005;\r\n}\r\nextend google.protobuf.MethodOptions {\r\n  optional MyMessage my_method_option = 50006;\r\n}\r\noption (my_file_option) = \"Hello world!\"; \r\n\r\nmessage MyMessage {\r\n  option (my_message_option) = 1234;\r\n  optional int32 foo = 1 [(my_field_option) = 4.5];\r\n  optional string bar = 2;\r\n}\r\n\r\nenum MyEnum {\r\n  option (my_enum_option) = true;\r\n  FOO = 1 [(my_enum_value_option) = 321];\r\n  BAR = 2;\r\n} \r\n\r\nmessage RequestType {}\r\n\r\nmessage ResponseType {}\r\n\r\nservice MyService {\r\n  option (my_service_option) = FOO;\r\n  rpc MyMethod(RequestType) returns(ResponseType) {\r\n    \/\/ Note:  my_method_option has type MyMessage.  We can set each field\r\n    \/\/   within it using a separate \"option\" line.\r\n    option (my_method_option).foo = 567;\r\n    option (my_method_option).bar = \"Some string\";\r\n  }\r\n}<\/pre>\n
\u6ce8\uff1a\u5982\u679c\u8981\u5728\u8be5\u9009\u9879\u5b9a\u4e49\u4e4b\u5916\u4f7f\u7528\u4e00\u4e2a\u81ea\u5b9a\u4e49\u7684\u9009\u9879\uff0c\u5fc5\u987b\u8981\u7531\u5305\u540d + \u9009\u9879\u540d\u6765\u5b9a\u4e49\u8be5\u9009\u9879\u3002\u5982\uff1a<\/p>\n
\/\/ foo.proto\r\nimport \"google\/protobuf\/descriptor.proto\";\r\npackage foo;\r\nextend google.protobuf.MessageOptions {\r\n  optional string my_option = 51234;\r\n}\r\n\/\/ bar.proto\r\nimport \"foo.proto\";\r\npackage bar;\r\nmessage MyMessage {\r\n  option (foo.my_option) = \"Hello world!\";\r\n}<\/pre>\n
\u6700\u540e\u4e00\u4ef6\u4e8b\u60c5\u9700\u8981\u6ce8\u610f\uff1a\u56e0\u4e3a\u81ea\u5b9a\u4e49\u9009\u9879\u662f\u53ef\u6269\u5c55\u7684\uff0c\u5b83\u5fc5\u987b\u8c61\u5176\u5b83\u7684\u57df\u6216\u6269\u5c55\u4e00\u6837\u6765\u5b9a\u4e49\u6807\u8bc6\u53f7\u3002\u6b63\u5982\u4e0a\u8ff0\u793a\u4f8b\uff0c[50000\uff0d99999]\u5df2\u7ecf\u88ab\u5360 \u7528\uff0c\u8be5\u8303\u56f4\u5185\u7684\u503c\u5df2\u7ecf\u88ab\u5185\u90e8\u6240\u4f7f\u7528\uff0c\u5f53\u7136\u4e86\u4f60\u53ef\u4ee5\u5728\u5185\u90e8\u5e94\u7528\u4e2d\u968f\u610f\u4f7f\u7528\u3002\u5982\u679c\u4f60\u60f3\u5728\u4e00\u4e9b\u516c\u5171\u5e94\u7528\u4e2d\u8fdb\u884c\u81ea\u5b9a\u4e49\u9009\u9879\uff0c\u4f60\u5fc5\u987b\u786e\u4fdd\u5b83\u662f\u5168\u5c40\u552f\u4e00\u7684\u3002\u53ef\u4ee5\u901a\u8fc7protobuf-global-extension-registry@google.com<\/a>\u6765\u83b7\u53d6\u5168\u5c40\u552f\u4e00\u6807\u8bc6\u53f7\u3002<\/p>\n
\u751f\u6210\u8bbf\u95ee\u7c7b<\/h2>\n
\u53ef\u4ee5\u901a\u8fc7\u5b9a\u4e49\u597d\u7684.proto\u6587\u4ef6\u6765\u751f\u6210Java\u3001Python\u3001C++\u4ee3\u7801\uff0c\u9700\u8981\u57fa\u4e8e.proto\u6587\u4ef6\u8fd0\u884cprotocol buffer\u7f16\u8bd1\u5668protoc\u3002\u8fd0\u884c\u7684\u547d\u4ee4\u5982\u4e0b\u6240\u793a\uff1a<\/p>\n
protoc --proto_path=IMPORT_PATH --cpp_out=DST_DIR --java_out=DST_DIR --python_out=DST_DIR path\/to\/file.proto<\/pre>\n
\u00b7\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0IMPORT_PATH\u58f0\u660e\u4e86\u4e00\u4e2a.proto\u6587\u4ef6\u6240\u5728\u7684\u5177\u4f53\u76ee\u5f55\u3002\u5982\u679c\u5ffd\u7565\u8be5\u503c\uff0c\u5219\u4f7f\u7528\u5f53\u524d\u76ee\u5f55\u3002\u5982\u679c\u6709\u591a\u4e2a\u76ee\u5f55\u5219\u53ef\u4ee5\u00a0\u5bf9--proto_path\u00a0\u5199\u591a\u6b21\uff0c\u5b83\u4eec\u5c06\u4f1a\u987a\u5e8f\u7684\u88ab\u8bbf\u95ee\u5e76\u6267\u884c\u5bfc\u5165\u3002-I=IMPORT_PATH\u662f\u5b83\u7684\u7b80\u5316\u5f62\u5f0f\u3002<\/p>\n
\u00b7\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u5f53\u7136\u4e5f\u53ef\u4ee5\u63d0\u4f9b\u4e00\u4e2a\u6216\u591a\u4e2a\u8f93\u51fa\u8def\u5f84\uff1a<\/p>\n
o\u00a0\u00a0\u00a0--cpp_out\u00a0\u5728\u76ee\u6807\u76ee\u5f55DST_DIR\u4e2d\u4ea7\u751fC++\u4ee3\u7801\uff0c\u53ef\u4ee5\u5728 http:\/\/code.google.com\/intl\/zh-CN\/apis\/protocolbuffers\/docs\/reference \/cpp-generated.html\u4e2d\u67e5\u770b\u66f4\u591a\u3002<\/p>\n
o\u00a0\u00a0\u00a0--java_out\u00a0\u5728\u76ee\u6807\u76ee\u5f55DST_DIR\u4e2d\u4ea7\u751fJava\u4ee3\u7801\uff0c\u53ef\u4ee5\u5728 http:\/\/code.google.com\/intl\/zh-CN\/apis\/protocolbuffers\/docs\/reference \/java-generated.html\u4e2d\u67e5\u770b\u66f4\u591a\u3002<\/p>\n
o\u00a0\u00a0\u00a0--python_out\u00a0\u5728\u76ee\u6807\u76ee\u5f55\u00a0DST_DIR \u4e2d\u4ea7\u751fPython\u4ee3\u7801\uff0c\u53ef\u4ee5\u5728http:\/\/code.google.com\/intl\/zh-CN\/apis\/protocolbuffers \/docs\/reference\/python-generated.html\u4e2d\u67e5\u770b\u66f4\u591a\u3002<\/p>\n
\u00a0\u00a0\u00a0\u00a0 \u4f5c\u4e3a\u4e00\u79cd\u989d\u5916\u7684\u4f7f\u5f97\uff0c\u5982\u679cDST_DIR\u00a0\u662f\u4ee5.zip\u6216.jar\u7ed3\u5c3e\u7684\uff0c\u7f16\u8bd1\u5668\u5c06\u8f93\u51fa\u7ed3\u679c\u6253\u5305\u6210\u4e00\u4e2azip\u683c\u5f0f\u7684\u5f52\u6863\u6587\u4ef6\u3002.jar\u5c06\u4f1a\u8f93\u51fa\u4e00\u4e2a Java JAR\u58f0\u660e\u5fc5\u987b\u7684manifest\u6587\u4ef6\u3002\u6ce8\uff1a\u5982\u679c\u8be5\u8f93\u51fa\u5f52\u6863\u6587\u4ef6\u5df2\u7ecf\u5b58\u5728\uff0c\u5b83\u5c06\u4f1a\u88ab\u91cd\u5199\uff0c\u7f16\u8bd1\u5668\u5e76\u6ca1\u6709\u505a\u5230\u8db3\u591f\u7684\u667a\u80fd\u6765\u4e3a\u5df2\u7ecf\u5b58\u5728\u7684\u5f52\u6863\u6587\u4ef6\u6dfb\u52a0\u65b0\u7684\u6587 \u4ef6\u3002<\/p>\n
\u00b7\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u4f60\u5fc5\u987b\u63d0\u4f9b\u4e00\u4e2a\u6216\u591a\u4e2a.proto\u6587\u4ef6\u4f5c\u4e3a\u8f93\u5165\u3002\u591a\u4e2a.proto\u6587\u4ef6\u80fd\u591f\u4e00\u6b21\u5168\u90e8\u58f0\u660e\u3002\u867d\u7136\u8fd9\u4e9b\u6587\u4ef6\u662f\u76f8\u5bf9\u4e8e\u5f53\u524d\u76ee\u5f55\u6765\u547d\u540d\u7684\uff0c\u6bcf\u4e2a\u6587\u4ef6\u5fc5\u987b\u5728\u4e00\u4e2aIMPORT_PATH\u4e2d\uff0c\u53ea\u6709\u5982\u6b64\u7f16\u8bd1\u5668\u624d\u53ef\u4ee5\u51b3\u5b9a\u5b83\u7684\u6807\u51c6\u540d\u79f0\u3002<\/p>\n
=========================================================<\/p>\n
ProtoBuf\u5f00\u53d1\u8005\u6307\u5357\uff1ahttp:\/\/gashero.yeax.com\/?p=108<\/p>\n
\u5b98\u65b9\u4e3b\u9875\uff1ahttp:\/\/code.google.com\/p\/protobuf\/<\/a><\/p>\n
\u8bed\u8a00\u6307\u5357\uff1ahttp:\/\/code.google.com\/intl\/zh-CN\/apis\/protocolbuffers\/docs\/proto.html
\n\u98ce\u683c\uff1ahttp:\/\/code.google.com\/intl\/zh-CN\/apis\/protocolbuffers\/docs\/style.html<\/p>\n
Google-ProtoBuf\u6570\u636e\u7f16\u7801\uff1ahttp:\/\/blog.csdn.net\/luxiaoyu_sdc\/article\/details\/9737537<\/p>\n","protected":false},"excerpt":{"rendered":"
\u8f6c\u8f7d\uff1ahttp:\/\/www.open-open.com\/home\/space.p … \u7ee7\u7eed\u9605\u8bfb →<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[326],"tags":[330],"_links":{"self":[{"href":"http:\/\/www.u3d8.com\/index.php?rest_route=\/wp\/v2\/posts\/1526"}],"collection":[{"href":"http:\/\/www.u3d8.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/www.u3d8.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/www.u3d8.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/www.u3d8.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=1526"}],"version-history":[{"count":1,"href":"http:\/\/www.u3d8.com\/index.php?rest_route=\/wp\/v2\/posts\/1526\/revisions"}],"predecessor-version":[{"id":1527,"href":"http:\/\/www.u3d8.com\/index.php?rest_route=\/wp\/v2\/posts\/1526\/revisions\/1527"}],"wp:attachment":[{"href":"http:\/\/www.u3d8.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=1526"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/www.u3d8.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=1526"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/www.u3d8.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=1526"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}