Protobuf編碼規(guī)范和注意點

(1)定義package 屬性的時候桑逝,同時也要定義java_package屬性

雖然說不定義java_package屬性也行棘劣,因為不定義java_package屬性默認(rèn)會根據(jù)package定義的屬性放置包,但是一般不建議這么做楞遏,因為在protobuf中茬暇,package定義的是在protobuf跨語言級別的命名空間,也就是說它可以避免與非java語言命名的沖突寡喝。

(2)分配的標(biāo)號糙俗,一般使用1~15來標(biāo)號常用或者重復(fù)的元素,用16以上的標(biāo)號不常用元素预鬓。1~15的標(biāo)號占一個字節(jié)巧骚,16以上的標(biāo)號占更多字節(jié)(具體如下圖)。重復(fù)的字段需要重新分配標(biāo)號格二,所以重復(fù)字段是這種優(yōu)化的候選者劈彪。

(3)buider和message(詳細(xì)的后面會說),提供一些公有方法:

toString:提供一種更友好的展現(xiàn)消息內(nèi)容

mergeFrom(builder提供):可以和合并其他消息蟋定,singular標(biāo)注的簡單類型字段會覆蓋粉臊,復(fù)合類型會被合并,repeated字段會連接起來驶兜。

強制性:

1.必須在第一行定義protobuf的版本扼仲,如:syntax="proto3"

2.使用java_outer_classname定義的類名必須不能跟message所聲明的名字一樣(不一樣不會報錯,但是不生成代碼)

3.分配的標(biāo)號不能重復(fù)抄淑,刪除字段的標(biāo)號不要重新使用

一般遵循一下原則:

(1)不改變現(xiàn)有字段的tag分配

(2)添加新字段從未使用的tag中屠凶,不包括那些刪除的tag

4.刪除字段的方式

(1)刪除字段

(2)使用reserved關(guān)鍵字回收字段標(biāo)號

eg:reserved 2,15? 或者? reserved "字段名1","字段名2"

5.對于枚舉值有幾個地方要說明的

(1)不要在輕易砸枚舉值中聲明allow_alias=true肆资,一般用作兼容舊代碼

枚舉allow_alias

這種在同一個枚舉值使用allow_alias=true為兩個不同名枚舉值聲明相同標(biāo)號矗愧,一般是兼用前端老代碼的。

(2)不能在相同命名空間中,兩個不同的枚舉類型聲明相同名字的枚舉唉韭。

同一命名空間下夜涕,不同枚舉類型使用相同名字標(biāo)識




最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市属愤,隨后出現(xiàn)的幾起案子女器,更是在濱河造成了極大的恐慌,老刑警劉巖住诸,帶你破解...
    沈念sama閱讀 217,907評論 6 506
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件驾胆,死亡現(xiàn)場離奇詭異,居然都是意外死亡贱呐,警方通過查閱死者的電腦和手機丧诺,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,987評論 3 395
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來奄薇,“玉大人驳阎,你說我怎么就攤上這事√柩蓿” “怎么了搞隐?”我有些...
    開封第一講書人閱讀 164,298評論 0 354
  • 文/不壞的土叔 我叫張陵,是天一觀的道長远搪。 經(jīng)常有香客問我劣纲,道長,這世上最難降的妖魔是什么谁鳍? 我笑而不...
    開封第一講書人閱讀 58,586評論 1 293
  • 正文 為了忘掉前任癞季,我火速辦了婚禮,結(jié)果婚禮上倘潜,老公的妹妹穿的比我還像新娘绷柒。我一直安慰自己,他們只是感情好涮因,可當(dāng)我...
    茶點故事閱讀 67,633評論 6 392
  • 文/花漫 我一把揭開白布废睦。 她就那樣靜靜地躺著,像睡著了一般养泡。 火紅的嫁衣襯著肌膚如雪嗜湃。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,488評論 1 302
  • 那天澜掩,我揣著相機與錄音购披,去河邊找鬼。 笑死肩榕,一個胖子當(dāng)著我的面吹牛刚陡,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 40,275評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼筐乳,長吁一口氣:“原來是場噩夢啊……” “哼歌殃!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起哥童,我...
    開封第一講書人閱讀 39,176評論 0 276
  • 序言:老撾萬榮一對情侶失蹤挺份,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后贮懈,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 45,619評論 1 314
  • 正文 獨居荒郊野嶺守林人離奇死亡优训,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,819評論 3 336
  • 正文 我和宋清朗相戀三年朵你,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片揣非。...
    茶點故事閱讀 39,932評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡抡医,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出早敬,到底是詐尸還是另有隱情忌傻,我是刑警寧澤,帶...
    沈念sama閱讀 35,655評論 5 346
  • 正文 年R本政府宣布搞监,位于F島的核電站水孩,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏琐驴。R本人自食惡果不足惜俘种,卻給世界環(huán)境...
    茶點故事閱讀 41,265評論 3 329
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望绝淡。 院中可真熱鬧宙刘,春花似錦、人聲如沸牢酵。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,871評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽馍乙。三九已至布近,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間潘拨,已是汗流浹背吊输。 一陣腳步聲響...
    開封第一講書人閱讀 32,994評論 1 269
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留铁追,地道東北人季蚂。 一個月前我還...
    沈念sama閱讀 48,095評論 3 370
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親扭屁。 傳聞我的和親對象是個殘疾皇子算谈,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 44,884評論 2 354

推薦閱讀更多精彩內(nèi)容

  • 1. Java基礎(chǔ)部分 基礎(chǔ)部分的順序:基本語法,類相關(guān)的語法料滥,內(nèi)部類的語法然眼,繼承相關(guān)的語法,異常的語法葵腹,線程的語...
    子非魚_t_閱讀 31,631評論 18 399
  • Spring Cloud為開發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見模式的工具(例如配置管理高每,服務(wù)發(fā)現(xiàn),斷路器践宴,智...
    卡卡羅2017閱讀 134,656評論 18 139
  • 一. Java基礎(chǔ)部分.................................................
    wy_sure閱讀 3,811評論 0 11
  • 由于工程項目中擬采用一種簡便高效的數(shù)據(jù)交換格式鲸匿,百度了一下發(fā)現(xiàn)除了采用 xml、JSON 還有 ProtoBuf(...
    黃海佳閱讀 48,639評論 1 23