国产日韩成人精品,欧美伊久线香蕉线新在线,在线日韩av片

命名

# 命名

摘自：[警惕軟件復(fù)雜度困局][1]

軟件中的API、方法、變量的命名，對(duì)于理解代碼的邏輯、范圍非常重要，也是設(shè)計(jì)者清晰傳達(dá)意圖的關(guān)鍵。
然而，在很多的項(xiàng)目里我們沒(méi)有給Naming /命名足夠的重視。

我們的代碼一般會(huì)和一些項(xiàng)目關(guān)聯(lián)，但是需要注意的是項(xiàng)目是抽象的，而代碼是具體的。
項(xiàng)目或者產(chǎn)品可以隨意一些命名，如阿里云喜歡用中國(guó)古代神話（飛天、伏羲、女媧）命名系統(tǒng)，
K8s也是來(lái)自于希臘神話，這些都沒(méi)有問(wèn)題。
而代碼中的API、變量、方法不能這樣命名。

一個(gè)不好的例子是前一段我們的Cluster API 被命名為Trident API（三叉戟），
設(shè)想一下代碼中的對(duì)象叫Trident時(shí)，我們?nèi)绾卫斫庠谶@個(gè)對(duì)象應(yīng)該具備的行為？
再對(duì)比一下K8s中的資源：Pod, ReplicaSet, Service, ClusterIP，
我們會(huì)注意到都是清晰、簡(jiǎn)單、直接符合其對(duì)象特征的命名。名實(shí)相符可以很大程度上降低理解該對(duì)象的成本。

有人說(shuō)“Naming is the most difficult part of software engineering”，
或許也不完全是個(gè)玩笑話：Naming的難度在于對(duì)于模型的深入思考和抽象，而這往往確實(shí)是很難的。

需要注意的是：

（a）Intention vs what it is

需要避免用“是什么”來(lái)命名，要用“for what / intention”。“是什么”來(lái)命名是會(huì)很容易將實(shí)現(xiàn)細(xì)節(jié)。
比如我們用 LeakedBarrel做rate limiting，這個(gè)類最好叫 RateLimiter，而不是LeakedBarrel：
前者定義了意圖（做什么的），后者描述了具體實(shí)現(xiàn)，而具體實(shí)現(xiàn)可能會(huì)變化。
再比如 Cache vs FixedSizeHashMap，前者也是更好的命名。

（b）命名需要符合當(dāng)前抽象的層級(jí)

首先我們軟件需要始終有清晰的抽象和分層。
事實(shí)上我們Naming時(shí)遇到困難，很多就是因?yàn)檐浖呀?jīng)缺乏明確的抽象和分層帶來(lái)的表象而已。

[1]https://mp.weixin.qq.com/s?__biz=MzIzOTU0NTQ0MA==&mid=2247498895&idx=1&sn=35b1d00e367c18c3d4ed7d4b15b38996&chksm=e92ac180de5d4896fd5d789ffbe8c963986717b634f2dac09821c2b3ab2270a42f4a1c006ff5&scene=21#wechat_redirect

posted on 2020-12-31 09:45 金慶閱讀(358) 評(píng)論(0) 編輯收藏引用所屬分類: 5. 軟工與管理

只有注冊(cè)用戶登錄后才能發(fā)表評(píng)論。


相關(guān)文章: TortoiseGit is OK but GitExtensions fails 命名 SVN重命名時(shí)不要更改內(nèi)容刪除隱性的git submodule 用docker stack開啟redis集群 Lua區(qū)分公有私有接口 Lua53 premake ejabberd開發(fā)和部署 Windows運(yùn)行GitStats CMake搜索Boost1.57失敗及解決

網(wǎng)站導(dǎo)航: 博客園 IT新聞 BlogJava 博問(wèn) Chat2DB 管理

青青草原综合久久大伊人导航_色综合久久天天综合_日日噜噜夜夜狠狠久久丁香五月_热久久这里只有精品

金慶的專欄

公告

留言簿(12)

隨筆分類(502)

隨筆檔案(423)

相冊(cè)

搜索

積分與排名

最新評(píng)論

閱讀排行榜

評(píng)論排行榜