Effective Java Item56 - 遵守普遍接受的命名慣例

栏目: Java · 发布时间: 6年前

内容简介:Effective Java Item56 - 遵守普遍接受的命名慣例

這篇是Effective Java - Adhere to generally accepted naming conventions章節的讀書筆記 本篇的程式碼來自於原書內容

Item56: 遵守普遍接受的命名慣例

Java平台有許多命名的慣例 其中分為兩大類 字面的(typographical)和語法的(grammatical)

字面類

package的命名要是層次狀 用句號分隔每部分 每部份只包含英文字母和數字 任何將在你組織之外使用的package 要以你的組織開頭 比如edu.cmu或com.sun

用戶創建的package不能以 java 或javax開頭 這些是留給標準類庫的

package名稱除了組織之外 剩下就是包的組成部分 且組成部分通常比較簡單 不超過8個字母 比如使用util而不是utililities 也可以只取第一個字母的縮寫 比如awt 句號跟句號之間的部分通常都是單詞或是縮寫組成

類和接口

當一個類或接口名稱超過一個單詞 則每個單詞的第一個字母大寫 且盡量避免縮寫

比如HttpUrl, TimeTask

方法和變數名稱

第一個字母應該小寫 其他單詞第一個字母大寫 比如ensureCapacity fetchHttpContent

常數

都用大寫字母加上底線 比如NEGATIVE_INFINITY

局部變量

跟變數名稱差不多 只是允許變量更不模糊一點 因為還可以參考上下文 比如i, xref, houseNumber

類型參數

在泛型的時候會用到 單個字母 偶爾字母加數字

T: 任意類型, 不同類型也可以用T1, T2, T3

E:表示集合的元素

K,V: map的key跟value

語法類

語法的命名比較多爭議 以下列出比較被接受的命名

類別用名詞 比如說 Timer, BufferedWriter

接口命名用名詞或是 -able 比如說Comparable或Runnable, Iterable

執行某個動作的方法就用動詞開頭 比如appendImage或drawImage

如果方法回傳一個物件的非boolean屬性 則直接用屬性命名 或是get屬性 比如size或getSize

回傳boolean的 就可以用is或has開頭 比如isDigit, isEmpty

易讀程式之美學

關於命名 推薦大家可以看這本書 易讀程式之美學


以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持 码农网

查看所有标签

猜你喜欢:

本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们

数据结构与算法

数据结构与算法

许卓群、杨冬青、唐世渭、张铭 / 高等教育出版社 / 2004-1 / 29.50元

《数据结构与算法》把数据结构的原理和算法分析技术有机地结合在一起,系统地介绍了各种类型的数据结构和排序、检索的各种算法,还引入了一些比较高级的数据结构及相关的算法分析技术。.《数据结构与算法》分为基本数据结构、排序和检索、高级数据结构三部分。借助抽象数据类型,从逻辑结构的角度系统地介绍了线性表、字符串、二叉树、树和图等各种基本数据结构;从算法的角度讨论排序、检索和索引算法;从应用的角度介绍了一些复......一起来看看 《数据结构与算法》 这本书的介绍吧!

SHA 加密
SHA 加密

SHA 加密工具

正则表达式在线测试
正则表达式在线测试

正则表达式在线测试

HSV CMYK 转换工具
HSV CMYK 转换工具

HSV CMYK互换工具