Like Share Discussion Bookmark Smile

J.J. Huang   2020-04-29   Java 阿里Java開發手冊   瀏覽次數:次   DMCA.com Protection Status

《阿里Java開發手冊》 | 編程規約 - 常數定義

【強制】不允許任何魔法值(即未經預先定義的常數)直接出現在程式碼中。
反例:

1
2
3
//本例中同學 A 定義了緩存的 key,然後緩存提取的同學 B 使用了 Id#taobao 來提取,少了底線,導致故障。
String key = "Id#taobao_" + tradeId;
cache.put(key, value);

【強制】在long或者Long賦值時,數值後使用大寫的L,不能是小寫的l,小寫容易跟數字1混淆,造成誤解。
說明:Long a = 2l; 寫的是數字的 21,還是 Long 型的 2。


【推薦】不要使用一個常數類維護所有常數,要按常數功能進行歸類,分開維護。
說明:大而全的常數類,雜亂無章,使用查找功能才能定位到修改的常數,不利於理解和維護。
正例:緩存相關常數放在類 CacheConsts 下;系統配置相關常數放在類 ConfigConsts 下。


【推薦】常數的複用層次有五層:跨應用共享常數、應用內共享常數、子工程內共享常數、 包內共享常數、類內共享常數。

  • 1.跨應用共享常數:放置在二方庫中,通常是 client.jar 中的 constant 目錄下。
  • 2.應用內共享常數:放置在一方庫中,通常是子模組中的 constant 目錄下。
    • 反例:易懂變數也要統一定義成應用內共享常數,兩位工程師在兩個類中分別定義了“YES”的變數:
      類A 中:public static final String YES = “yes”;
      類B 中:public static final String YES = “y”;
      A.YES.equals(B.YES),預期是true,但實際返回為false,導致線上問題。
  • 3.子工程內部共享常數:即在當前子工程的 constant 目錄下。
  • 4.包內共享常數:即在當前包下單獨的 constant 目錄下。
  • 5.類內共享常數:直接在類內部 private static final 定義。

【推薦】如果變數值僅在一個固定範圍內變化用enum類型來定義。
說明:如果存在名稱之外的延伸屬性應使用 enum 類型,下面正例中的數字就是延伸訊息,表示一年中的
第幾個季節。
正例:

1
2
3
4
5
6
7
8
9
10
public enum SeasonEnum {
 SPRING(1), SUMMER(2), AUTUMN(3), WINTER(4);
 private int seq;
 SeasonEnum(int seq) {
  this.seq = seq;
 }
 public int getSeq() {
  return seq;
 }
}

心得

看完這篇「常數定義」後,發現多數專案在整理常數的時候,並沒有考慮到是否為共用、分類和放在哪一層。造成在維護上的困難,或是之間的判斷造成錯誤。

所以常數的定義,需要宏觀的了解整個業務、架構後,並且針對其設計初期就要考慮進去。

結語

文章越看越多,技術越學越多,就會發現自己的不足;技術學到後面都會想要將基礎再重新在打得更加扎實。

以前在開發覺得理所當然的事情,例如:命名規則、命名規範,照著別人怎麼說就怎麼做的想法,並沒有好好去想為什麼要這樣設計和規範。
於是乎同事們推薦《阿里巴巴Java開發手冊》來做閱讀,書中提到種種規範《正確範例》、《錯誤範例》還有解釋定義說明;我相信在閱讀完這一系列後,一定會更加扎實且實在。

如對此書有興趣,建議去購買官方認證的書籍,給予官方支持。

註:如有侵權,通知即刪。


註:以上參考了
Alibaba-Java-Coding-Guidelines Github
Alibaba-Java-Coding-Guidelines English Version