Java開發(fā) 命名風(fēng)格

2021-01-12 11:53 更新

\1. 【強(qiáng)制】代碼中的命名均不能以下劃線或美元符號(hào)開始,也不能以下劃線或美元符號(hào)結(jié)束。

反例:_name / __name / $name / name_ / name$ / name__

\2. 【強(qiáng)制】所有編程相關(guān)的命名嚴(yán)禁使用拼音與英文混合的方式,更不允許直接使用中文的方式。

說(shuō)明:正確的英文拼寫和語(yǔ)法可以讓閱讀者易于理解,避免歧義。注意,純拼音命名方式更要避免采用。


正例:ali / alibaba / taobao / cainiao/ aliyun/ youku / hangzhou 等國(guó)際通用的名稱,可視同英文。


反例:DaZhePromotion [打折] / getPingfenByName() [評(píng)分] / String fw[福娃] / int 某變量 = 3

\3. 【強(qiáng)制】代碼和注釋中都要避免使用任何語(yǔ)言的種族歧視性詞語(yǔ)。

正例:日本人 / 印度人 / blockList / allowList / secondary

    
反例:RIBENGUIZI / Asan / blackList / whiteList / slave

\4. 【強(qiáng)制】類名使用 UpperCamelCase 風(fēng)格,但以下情形例外:DO / BO / DTO / VO / AO / PO / UID 等。

正例:ForceCode / UserDO / HtmlDTO / XmlService / TcpUdpDeal / TaPromotion


反例:forcecode / UserDo / HTMLDto / XMLService / TCPUDPDeal / TAPromotion

\5. 【強(qiáng)制】方法名、參數(shù)名、成員變量、局部變量都統(tǒng)一使用 lowerCamelCase 風(fēng)格。

正例: localValue / getHttpMessage() / inputUserId

\6. 【強(qiáng)制】常量命名全部大寫,單詞間用下劃線隔開,力求語(yǔ)義表達(dá)完整清楚,不要嫌名字長(zhǎng)。

正例:MAX_STOCK_COUNT / CACHE_EXPIRED_TIME


反例:MAX_COUNT / EXPIRED_TIME

\7. 【強(qiáng)制】抽象類命名使用 Abstract 或 Base 開頭;異常類命名使用 Exception 結(jié)尾;測(cè)試類命名以它要測(cè)試的類的名稱開始,以 Test 結(jié)尾。

\8. 【強(qiáng)制】類型與中括號(hào)緊挨相連來(lái)表示數(shù)組。

正例:定義整形數(shù)組 int[] arrayDemo。


反例:在 main 參數(shù)中,使用 String args[]來(lái)定義。

\9. 【強(qiáng)制】POJO 類中的任何布爾類型的變量,都不要加 is 前綴,否則部分框架解析會(huì)引起序列化錯(cuò)誤。

說(shuō)明:在本文 MySQL 規(guī)約中的建表約定第一條,表達(dá)是與否的變量采用 is_xxx 的命名方式,所以,需要在<resultMap>設(shè)置從 is_xxx 到 xxx 的映射關(guān)系。


反例:定義為基本數(shù)據(jù)類型 Boolean isDeleted 的屬性,它的方法也是 isDeleted(),框架在反向解析的時(shí)候,“誤以為”對(duì)應(yīng)的屬性名稱是 deleted,導(dǎo)致屬性獲取不到,進(jìn)而拋出異常。

\10.【強(qiáng)制】包名統(tǒng)一使用小寫,點(diǎn)分隔符之間有且僅有一個(gè)自然語(yǔ)義的英語(yǔ)單詞。包名統(tǒng)一使用單數(shù)形式,但是類名如果有復(fù)數(shù)含義,類名可以使用復(fù)數(shù)形式。

正例:應(yīng)用工具類包名為 com.alibaba.ei.kunlun.aap.util、類名為 MessageUtils(此規(guī)則參考 spring 的框架結(jié)構(gòu))

\11.【強(qiáng)制】避免在子父類的成員變量之間、或者不同代碼塊的局部變量之間采用完全相同的命名,使可理解性降低。

說(shuō)明:子類、父類成員變量名相同,即使是 public 類型的變量也能夠通過(guò)編譯,另外,局部變量在同一方法內(nèi)的不同代碼塊中同名也是合法的,這些情況都要避免。對(duì)于非 setter/getter 的參數(shù)名稱也要避免與成員變量名稱相同。

    
反例:


public class ConfusingName {
    public int stock;

    
    // 非 setter/getter 的參數(shù)名稱,不允許與本類成員變量同名
    public void get(String alibaba) {
        if (condition) {
            final int money = 666;
            // ...
        }


        for (int i = 0; i < 10; i++) {
            // 在同一方法體中,不允許與其它代碼塊中的 money 命名相同
            final int money = 15978;
            // ...
        }
    } 
}


class Son extends ConfusingName {
    // 不允許與父類的成員變量名稱相同
    public int stock; 
}

\12.【強(qiáng)制】杜絕完全不規(guī)范的縮寫,避免望文不知義。

反例:AbstractClass“縮寫”成 AbsClass;condition“縮寫”成 condi;Function 縮寫”成 Fu,此類隨意縮寫嚴(yán)重降低了代碼的可閱讀性。

\13.【推薦】為了達(dá)到代碼自解釋的目標(biāo),任何自定義編程元素在命名時(shí),使用盡量完整的單詞組合來(lái)表達(dá)。

正例:對(duì)某個(gè)對(duì)象引用的 volatile 字段進(jìn)行原子更新的類名為 AtomicReferenceFieldUpdater。


反例:常見的方法內(nèi)變量為 int a;的定義方式。

\14.【推薦】在常量與變量的命名時(shí),表示類型的名詞放在詞尾,以提升辨識(shí)度。

正例:startTime / workQueue / nameList / TERMINATED_THREAD_COUNT


反例:startedAt / QueueOfWork / listName / COUNT_TERMINATED_THREAD

\15.【推薦】如果模塊、接口、類、方法使用了設(shè)計(jì)模式,在命名時(shí)需體現(xiàn)出具體模式。

說(shuō)明:將設(shè)計(jì)模式體現(xiàn)在名字中,有利于閱讀者快速理解架構(gòu)設(shè)計(jì)理念。


正例:
public class OrderFactory;
public class LoginProxy;
public class ResourceObserver;

\16.【推薦】接口類中的方法和屬性不要加任何修飾符號(hào)(public 也不要加),保持代碼的簡(jiǎn)潔性,并加上有效的 Javadoc 注釋。盡量不要在接口里定義變量,如果一定要定義變量,確定與接口方法相關(guān),并且是整個(gè)應(yīng)用的基礎(chǔ)常量。

正例:


    接口方法簽名 void commit();


    接口基礎(chǔ)常量 String COMPANY = "alibaba";


反例:接口方法定義 public abstract void f();


說(shuō)明:JDK8 中接口允許有默認(rèn)實(shí)現(xiàn),那么這個(gè) default 方法,是對(duì)所有實(shí)現(xiàn)類都有價(jià)值的默認(rèn)實(shí)現(xiàn)。

\17.接口和實(shí)現(xiàn)類的命名有兩套規(guī)則:

? 1)【強(qiáng)制】對(duì)于 Service 和 DAO 類,基于 SOA 的理念,暴露出來(lái)的服務(wù)一定是接口,內(nèi)部的實(shí)現(xiàn)類用Impl 的后綴與接口區(qū)別。

正例:CacheServiceImpl 實(shí)現(xiàn) CacheService 接口。

? 2)【推薦】如果是形容能力的接口名稱,取對(duì)應(yīng)的形容詞為接口名(通常是–able 的形容詞)。

正例:AbstractTranslator 實(shí)現(xiàn) Translatable 接口。

\18.【參考】枚舉類名帶上 Enum 后綴,枚舉成員名稱需要全大寫,單詞間用下劃線隔開。

說(shuō)明:枚舉其實(shí)就是特殊的常量類,且構(gòu)造方法被默認(rèn)強(qiáng)制是私有。


正例:枚舉名字為 ProcessStatusEnum 的成員名稱:SUCCESS / UNKNOWN_REASON。

\19.【參考】各層命名規(guī)約:

A) Service/DAO 層方法命名規(guī)約

? 1) 獲取單個(gè)對(duì)象的方法用 get 做前綴。

? 2) 獲取多個(gè)對(duì)象的方法用 list 做前綴,復(fù)數(shù)結(jié)尾,如:listObjects。

? 3) 獲取統(tǒng)計(jì)值的方法用 count 做前綴。

? 4) 插入的方法用 save/insert 做前綴。

? 5) 刪除的方法用 remove/delete 做前綴。

? 6) 修改的方法用 update 做前綴。

B) 領(lǐng)域模型命名規(guī)約

? 1) 數(shù)據(jù)對(duì)象:xxxDO,xxx 即為數(shù)據(jù)表名。

? 2) 數(shù)據(jù)傳輸對(duì)象:xxxDTO,xxx 為業(yè)務(wù)領(lǐng)域相關(guān)的名稱。

? 3) 展示對(duì)象:xxxVO,xxx 一般為網(wǎng)頁(yè)名稱。

? 4) POJO 是 DO/DTO/BO/VO 的統(tǒng)稱,禁止命名成 xxxPOJO。

以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)