From 4e60434935e21e572fd839ad0bbe6b155f36cc1b Mon Sep 17 00:00:00 2001 From: Spacebody <510662916@qq.com> Date: Tue, 18 Dec 2018 02:36:18 +0800 Subject: [PATCH] change the coding of docs/tars_protobuf_cpp.md from GB2312 to utf8 --- docs/tars_protobuf_cpp.md | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/tars_protobuf_cpp.md b/docs/tars_protobuf_cpp.md index a475526..38e238d 100644 --- a/docs/tars_protobuf_cpp.md +++ b/docs/tars_protobuf_cpp.md @@ -1,17 +1,17 @@ -# tars支持protobuf service描述文件 +# tars鏀寔protobuf service鎻忚堪鏂囦欢 -如果当你了解到tars的时候,你已经有不少已有业务采用了protobuf协议;如果想要把这些业务迁移到tars,你还需要手动把proto文件翻译成tars文件,非常麻烦而且容易出错。 -现在tars使用protoc的插件机制,提供了对proto文件的直接支持,能够生成tars rpc相关代码,使得迁移平滑省心。 +濡傛灉褰撲綘浜嗚В鍒皌ars鐨勬椂鍊欙紝浣犲凡缁忔湁涓嶅皯宸叉湁涓氬姟閲囩敤浜唒rotobuf鍗忚锛涘鏋滄兂瑕佹妸杩欎簺涓氬姟杩佺Щ鍒皌ars锛屼綘杩橀渶瑕佹墜鍔ㄦ妸proto鏂囦欢缈昏瘧鎴恡ars鏂囦欢,闈炲父楹荤儲鑰屼笖瀹规槗鍑洪敊銆 +鐜板湪tars浣跨敤protoc鐨勬彃浠舵満鍒讹紝鎻愪緵浜嗗proto鏂囦欢鐨勭洿鎺ユ敮鎸侊紝鑳藉鐢熸垚tars rpc鐩稿叧浠g爜锛屼娇寰楄縼绉诲钩婊戠渷蹇冦 -## 使用方法 +## 浣跨敤鏂规硶 -### 1. 准备proto文件 -proto文件的语法是不限制的,你可以使用proto2或proto3; -但注意,一定加上**option cc_generic_services=false;** -因为我们的目标就是不使用protoc生成的pb rpc接口,而是要用tars插件接管,生成符合tars框架的rpc接口. -一个proto文件的示例如下: +### 1. 鍑嗗proto鏂囦欢 +proto鏂囦欢鐨勮娉曟槸涓嶉檺鍒剁殑锛屼綘鍙互浣跨敤proto2鎴杙roto3锛 +浣嗘敞鎰忥紝涓瀹氬姞涓**option cc_generic_services=false;** +鍥犱负鎴戜滑鐨勭洰鏍囧氨鏄笉浣跨敤protoc鐢熸垚鐨刾b rpc鎺ュ彛锛岃屾槸瑕佺敤tars鎻掍欢鎺ョ锛岀敓鎴愮鍚坱ars妗嗘灦鐨剅pc鎺ュ彛. +涓涓猵roto鏂囦欢鐨勭ず渚嬪涓: ```cpp @@ -37,8 +37,8 @@ service Hello { ``` -### 2. 直接执行make即可 -因为调用tars pb插件的语句,已经内置在框架makefile.tars文件中。 -由于protoc默认生成的文件名带有.pb.h后缀,tars插件也遵循这个命名规则,生成的文件后缀是.tars.h +### 2. 鐩存帴鎵цmake鍗冲彲 +鍥犱负璋冪敤tars pb鎻掍欢鐨勮鍙ワ紝宸茬粡鍐呯疆鍦ㄦ鏋秏akefile.tars鏂囦欢涓 +鐢变簬protoc榛樿鐢熸垚鐨勬枃浠跺悕甯︽湁.pb.h鍚庣紑,tars鎻掍欢涔熼伒寰繖涓懡鍚嶈鍒欙紝鐢熸垚鐨勬枃浠跺悗缂鏄.tars.h