[翻譯] ProtoBuf 官方文檔(四)- 規(guī)范指引

翻譯查閱外網(wǎng)資料過(guò)程中遇到的比較優(yōu)秀的文章和資料缺亮,一是作為技術(shù)參考以便日后查閱,二是訓(xùn)練英文能力晚吞。

此文翻譯自 Protocol Buffers 官方文檔 Style Guide 部分

翻譯為意譯延旧,不會(huì)照本宣科的字字對(duì)照翻譯
以下為原文內(nèi)容翻譯

規(guī)范指引

本文為編寫(xiě) .proto 文件提供了一份規(guī)范指引。通過(guò)遵守這些規(guī)范約定载矿,你可以使你的 message 定義以及相關(guān)的類(lèi)保持一致性垄潮,同時(shí)也將更易于閱讀。

Message 和 字段命名

使用駝峰命名法(首字母大寫(xiě))命名 message闷盔,例子:SongServerRequest
使用下劃線命名字段弯洗,栗子:song_name

message SongServerRequest {
  required string song_name = 1;
}

使用上述這種字段的命名約定,生成的訪問(wèn)器將類(lèi)似于如下代碼:

C++:
  const string& song_name() { ... }
  void set_song_name(const string& x) { ... }

Java:
  public String getSongName() { ... }
  public Builder setSongName(String v) { ... }

枚舉 Enums

使用駝峰命名法(首字母大寫(xiě))命名枚舉類(lèi)型逢勾,使用 “大寫(xiě)_下劃線_大寫(xiě)” 的方式命名枚舉值:

enum Foo {
  FIRST_VALUE = 0;
  SECOND_VALUE = 1;
}

每一個(gè)枚舉值以分號(hào)結(jié)尾牡整,而非逗號(hào)。

服務(wù) Services

如果你在 .proto 文件中定義 RPC 服務(wù)溺拱,你應(yīng)該使用駝峰命名法(首字母大寫(xiě))命名 RPC 服務(wù)以及其中的 RPC 方法:

service FooService {
  rpc GetSomething(FooRequest) returns (FooResponse);
}

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末逃贝,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子迫摔,更是在濱河造成了極大的恐慌沐扳,老刑警劉巖,帶你破解...
    沈念sama閱讀 206,839評(píng)論 6 482
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件句占,死亡現(xiàn)場(chǎng)離奇詭異沪摄,居然都是意外死亡,警方通過(guò)查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,543評(píng)論 2 382
  • 文/潘曉璐 我一進(jìn)店門(mén)杨拐,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)祈餐,“玉大人,你說(shuō)我怎么就攤上這事哄陶》簦” “怎么了?”我有些...
    開(kāi)封第一講書(shū)人閱讀 153,116評(píng)論 0 344
  • 文/不壞的土叔 我叫張陵屋吨,是天一觀的道長(zhǎng)蜒谤。 經(jīng)常有香客問(wèn)我,道長(zhǎng)离赫,這世上最難降的妖魔是什么芭逝? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 55,371評(píng)論 1 279
  • 正文 為了忘掉前任塌碌,我火速辦了婚禮渊胸,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘台妆。我一直安慰自己翎猛,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 64,384評(píng)論 5 374
  • 文/花漫 我一把揭開(kāi)白布接剩。 她就那樣靜靜地躺著切厘,像睡著了一般。 火紅的嫁衣襯著肌膚如雪懊缺。 梳的紋絲不亂的頭發(fā)上疫稿,一...
    開(kāi)封第一講書(shū)人閱讀 49,111評(píng)論 1 285
  • 那天,我揣著相機(jī)與錄音鹃两,去河邊找鬼遗座。 笑死,一個(gè)胖子當(dāng)著我的面吹牛俊扳,可吹牛的內(nèi)容都是我干的途蒋。 我是一名探鬼主播,決...
    沈念sama閱讀 38,416評(píng)論 3 400
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼馋记,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼号坡!你這毒婦竟也來(lái)了?” 一聲冷哼從身側(cè)響起梯醒,我...
    開(kāi)封第一講書(shū)人閱讀 37,053評(píng)論 0 259
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤宽堆,失蹤者是張志新(化名)和其女友劉穎,沒(méi)想到半個(gè)月后茸习,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體畜隶,經(jīng)...
    沈念sama閱讀 43,558評(píng)論 1 300
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,007評(píng)論 2 325
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了代箭。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片墩划。...
    茶點(diǎn)故事閱讀 38,117評(píng)論 1 334
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖嗡综,靈堂內(nèi)的尸體忽然破棺而出乙帮,到底是詐尸還是另有隱情,我是刑警寧澤极景,帶...
    沈念sama閱讀 33,756評(píng)論 4 324
  • 正文 年R本政府宣布察净,位于F島的核電站,受9級(jí)特大地震影響盼樟,放射性物質(zhì)發(fā)生泄漏氢卡。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,324評(píng)論 3 307
  • 文/蒙蒙 一晨缴、第九天 我趴在偏房一處隱蔽的房頂上張望译秦。 院中可真熱鬧,春花似錦击碗、人聲如沸筑悴。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 30,315評(píng)論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)阁吝。三九已至,卻和暖如春械拍,著一層夾襖步出監(jiān)牢的瞬間突勇,已是汗流浹背。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 31,539評(píng)論 1 262
  • 我被黑心中介騙來(lái)泰國(guó)打工坷虑, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留甲馋,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 45,578評(píng)論 2 355
  • 正文 我出身青樓猖吴,卻偏偏與公主長(zhǎng)得像摔刁,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子海蔽,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 42,877評(píng)論 2 345

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

  • 由于工程項(xiàng)目中擬采用一種簡(jiǎn)便高效的數(shù)據(jù)交換格式共屈,百度了一下發(fā)現(xiàn)除了采用 xml、JSON 還有 ProtoBuf(...
    黃海佳閱讀 48,533評(píng)論 1 23
  • 去年有段時(shí)間得空党窜,就把谷歌GAE的API權(quán)威指南看了一遍拗引,收獲頗豐,特別是在自己幾乎獨(dú)立開(kāi)發(fā)了公司的云數(shù)據(jù)中心之后...
    騎單車(chē)的勛爵閱讀 20,440評(píng)論 0 41
  • 文章內(nèi)容源自Google官方文檔翻譯,詳見(jiàn)原文Language Guide幌衣。部分內(nèi)容可能重復(fù)矾削,望多見(jiàn)諒壤玫。 假設(shè)你想...
    Jancd閱讀 2,123評(píng)論 0 0
  • Spring Cloud為開(kāi)發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見(jiàn)模式的工具(例如配置管理,服務(wù)發(fā)現(xiàn)哼凯,斷路器欲间,智...
    卡卡羅2017閱讀 134,600評(píng)論 18 139
  • 現(xiàn)在這個(gè)社會(huì),信息時(shí)代断部,圍繞在城市人周邊的信息太多了猎贴。 手機(jī)里各種各樣的app,每個(gè)app里各種各樣的內(nèi)容蝴光,文字她渴,...
    xll2068閱讀 236評(píng)論 2 1