Tars網(wǎng)絡(luò)通信協(xié)議

Tars協(xié)議到底是指啥湃交?

從Tars的這兩篇文檔的命名很具有迷惑性,看了半天不知道Tars和Tup啥關(guān)系昏名?
其實(shí)就是tars賦予的內(nèi)容太多了導(dǎo)致的蝎土。

  • 以.tars結(jié)尾的接口文件视哑,里面的內(nèi)容用tars語言或語法來定義接口;
  • 基于這個接口語言可以進(jìn)行tars編碼誊涯;
  • 網(wǎng)絡(luò)通信可以采用基于Tars協(xié)議的RPC通信挡毅。
做個類比就比較清楚了
  • tars語言,定義了一些語法暴构,類似于json跪呈,當(dāng)然和json不太一樣的是段磨,tars語言既可以定義對象又可以定義方法。
  • tars編碼耗绿,其實(shí)是對象序列化的方法苹支,類似于fastjson對json文件進(jìn)行序列化。
  • tars協(xié)議误阻,類似于http協(xié)議债蜜,也是Request/Response(請求響應(yīng))模型,定義了Request和Response消息的格式究反。

Tars協(xié)議和Tup協(xié)議又有什么區(qū)別寻定?

tars通信協(xié)議有幾個版本,v1叫作tars精耐,v3叫作tup狼速,v2應(yīng)該廢棄不用了。
v1(tars協(xié)議)卦停,主要是用于服務(wù)間的接口調(diào)用向胡,也就是rpc的主要協(xié)議。
v3(Tup協(xié)議)沫浆,是用于其他客戶端訪問Tars服務(wù)

Response網(wǎng)絡(luò)包結(jié)構(gòu)

class TarsServantResponse1 {
    0 int dataLength;  // 整個數(shù)據(jù)包的長度捷枯,包含該字段 [4 Bytes]
    1 short version;   // 協(xié)議版本號  tag = 1  [2 Bytes]
    2 byte packetType; // 包類型 tag = 2   [1 Bytes]
    ///////////////////////////////////////////////////
    // version == 1滚秩,普通的Tars RPC調(diào)用
    3 int requestId;   // 請求id专执,未使用
    4 int messageType; // 消息類型
    5 int ret;         // 返回值
    6 byte[] result;   // 結(jié)果值, Tars序列化后的byte數(shù)組,按照返回參數(shù)順序郁油,組成對象本股。
    7 Map<String, String> status;
    8 String remark;   // 若ret=0 成功才會填寫該字段

    // version == 2 or version == 3, WupProxy調(diào)用
    3 int messageType; // 消息類型
    4 int ticketNum;
    5 String servantName;  // 服務(wù)名稱
    6 String functionName; // 函數(shù)名稱
    7 byte[] wupResult; // 結(jié)果值桐腌,Tars序列化后的byte數(shù)組
    8 int timeout;      // 超時時間
    9 Map<String, String> context;
    10 Map<String, String> status;
}
// 定義協(xié)議的版本號

    const short TARSVERSION  = 0x01; // tars協(xié)議
    const short TARSVERSION  = 0x01; // 老的tup協(xié)議拄显,應(yīng)該已經(jīng)不用了
    const short TUPVERSION  = 0x03;  // tup協(xié)議

Version 1的輸出參數(shù)結(jié)構(gòu)

/**
 * 若functionName="tars_ping",該結(jié)果字段為空
 * 老的tup協(xié)議案站,應(yīng)該已經(jīng)不用了
 * 直接對參數(shù)進(jìn)行tars編碼躬审,不包含參數(shù)的名稱和類型
 */
class TarsServantResponseResult {
    0 Object paramter1;
    1 Object paramter1;
}

Version 2的輸出參數(shù)結(jié)構(gòu)

/**
 * TUPVERSION  = 0x03; // tup協(xié)議
 * 既包含類型名稱,也包含參數(shù)命名
 * <ClassName, <ParameterName, ParameterValue>>
 * 返回值作為一個參數(shù)加入進(jìn)來蟆盐,key 為 ""
 */
class TarsServantResponseWupResult {
    0 HashMap<String, HashMap<String, byte[]>> _data;
}

Version 3的輸出參數(shù)結(jié)構(gòu)

/**
 * TUPVERSION  = 0x03; // tup協(xié)議
 * 只包含參數(shù)名
 * <ParameterName, ParameterValue>
 * 返回值作為一個參數(shù)加入進(jìn)來承边,key 為 ""
 */
class TarsServantResponseWupResult {
    0 HashMap<String, byte[]> _newData
}

Request網(wǎng)絡(luò)包結(jié)構(gòu)

class TarsServantRequest1 {
    int dataLength;  // 整個數(shù)據(jù)包的長度,包含該字段 [4 Bytes]
    1 short version;   // 協(xié)議版本號  tag = 1  [2 Bytes]
    2 byte packetType; // 包類型 tag = 2   [1 Bytes]

    3 int messageType; // 消息類型
    4 int ticketNum;
    5 String servantName;  // 服務(wù)名稱
    6 String functionName; // 函數(shù)名稱
    7 byte[] requestParams; // 請求參數(shù)的二進(jìn)制編碼石挂,Tars序列化后的byte數(shù)組
    8 int timeout;      // 超時時間
    9 Map<String, String> context;
    10 Map<String, String> status;
}

同樣當(dāng)version不同博助,參數(shù)序列化結(jié)構(gòu)不同,和Response類似

總結(jié)

從上面Tars和Tup的組包來看痹愚,最主要的區(qū)別是請求和返回參數(shù)的組包方式富岳。Tars完全采用順序來區(qū)分參數(shù)蛔糯,而Tup是通過參數(shù)名稱來區(qū)分參數(shù)的。

參考文檔

基礎(chǔ)通信協(xié)議 Tars
統(tǒng)一通信協(xié)議 TarsTup

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末窖式,一起剝皮案震驚了整個濱河市蚁飒,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌萝喘,老刑警劉巖飒箭,帶你破解...
    沈念sama閱讀 219,490評論 6 508
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異蜒灰,居然都是意外死亡弦蹂,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,581評論 3 395
  • 文/潘曉璐 我一進(jìn)店門强窖,熙熙樓的掌柜王于貴愁眉苦臉地迎上來凸椿,“玉大人,你說我怎么就攤上這事翅溺∧月” “怎么了?”我有些...
    開封第一講書人閱讀 165,830評論 0 356
  • 文/不壞的土叔 我叫張陵咙崎,是天一觀的道長优幸。 經(jīng)常有香客問我,道長褪猛,這世上最難降的妖魔是什么网杆? 我笑而不...
    開封第一講書人閱讀 58,957評論 1 295
  • 正文 為了忘掉前任,我火速辦了婚禮伊滋,結(jié)果婚禮上碳却,老公的妹妹穿的比我還像新娘。我一直安慰自己笑旺,他們只是感情好昼浦,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,974評論 6 393
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著筒主,像睡著了一般关噪。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上乌妙,一...
    開封第一講書人閱讀 51,754評論 1 307
  • 那天使兔,我揣著相機(jī)與錄音,去河邊找鬼冠胯。 笑死火诸,一個胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的荠察。 我是一名探鬼主播置蜀,決...
    沈念sama閱讀 40,464評論 3 420
  • 文/蒼蘭香墨 我猛地睜開眼奈搜,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了盯荤?” 一聲冷哼從身側(cè)響起馋吗,我...
    開封第一講書人閱讀 39,357評論 0 276
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎秋秤,沒想到半個月后宏粤,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 45,847評論 1 317
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡灼卢,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,995評論 3 338
  • 正文 我和宋清朗相戀三年绍哎,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片鞋真。...
    茶點(diǎn)故事閱讀 40,137評論 1 351
  • 序言:一個原本活蹦亂跳的男人離奇死亡崇堰,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出涩咖,到底是詐尸還是另有隱情海诲,我是刑警寧澤,帶...
    沈念sama閱讀 35,819評論 5 346
  • 正文 年R本政府宣布檩互,位于F島的核電站特幔,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏闸昨。R本人自食惡果不足惜蚯斯,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,482評論 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望零院。 院中可真熱鬧溉跃,春花似錦村刨、人聲如沸告抄。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,023評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽打洼。三九已至,卻和暖如春逆粹,著一層夾襖步出監(jiān)牢的瞬間募疮,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 33,149評論 1 272
  • 我被黑心中介騙來泰國打工僻弹, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留阿浓,地道東北人。 一個月前我還...
    沈念sama閱讀 48,409評論 3 373
  • 正文 我出身青樓蹋绽,卻偏偏與公主長得像芭毙,于是被迫代替她去往敵國和親筋蓖。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,086評論 2 355