- Taipei, Taiwan
-
《阿里Java開發手冊》 | 異常日誌 - 日誌規約
【強制】 應用中不可直接使用日誌系統(Log4j、Logback)中的 API ,而應依賴使用日誌框架(SLF4J、JCL–Jakarta Commons Logging)中的 API ,使用門面模式的日誌框架,有利於維護和各個類的日誌處理方式統一。 說明: 日誌框架(SLF4J、JC...
-
《阿里Java開發手冊》 | 異常日誌 - 異常處理
【強制】 Java 類庫中定義的可以通過預檢查方式規避的 RuntimeException 異常不應該通過 catch 的方式來處理,比如:NullPointerException,IndexOutOfBoundsException 等等。 說明: 無法通過預檢查的異常除外,比如,在解...
-
《阿里Java開發手冊》 | 異常日誌 - 錯誤碼
【強制】 錯誤碼的製定原則:快速溯源、簡單易記、溝通標準化。 說明: 錯誤碼想得過於完美和復雜,就像康熙字典中的生僻字一樣,用詞似乎精準,但是字典不容易隨身攜帶並且簡單易懂。 正例: 錯誤碼回答的問題是誰的錯?錯在哪? 錯誤碼必須能夠快速知曉錯誤來源,可快速判斷是誰的問題。...
-
《阿里Java開發手冊》 | 編程規約 - 其他
【強制】 在使用正則表達式時,利用好其預編譯功能,可以有效加快正則匹配速度。 說明: 不要在方法體內定義:Pattern pattern = Pattern.compile(“規則”); 【強制】 避免用 ApacheBeanutils 進行屬性的 copy。 說明...
-
《阿里Java開發手冊》 | 編程規約 - 註解規約
【強制】 類、類屬性、類方法的註解必須使用 Javadoc 規範,使用/**內容*/格式,不得使用 // xxx 方式。 說明: 在 IDE 編輯窗口中,Javadoc 方式會提示相關註解,生成 Javadoc 可以正確輸出相應註解;在 IDE 中,工程調用方法時,不進入方法即可懸浮提...
-
《阿里Java開發手冊》 | 編程規約 - 控制語句
【強制】 在一個 switch 塊內,每個 case 要麼通過 continue/break/return 等來終止,要麼註解說明程序將繼續執行到哪一個 case 為止;在一個 switch 塊內,都必須包含一個 default 語句並且放在最後,即使它什麼程式碼也沒有。 說明: 注意...
-
《阿里Java開發手冊》 | 編程規約 - 並發處理
【強制】 獲取單例對象需要保證執行緒(thread)安全,其中的方法也要保證執行緒(thread)安全。 說明: 資源驅動類、工具類、單例工廠類都需要注意。 【強制】 建立執行緒(thread)或執行緒池(thread pool)時請指定有意義的執行緒(thread)名稱...
-
《阿里Java開發手冊》 | 編程規約 - 集合處理
【強制】 關於hashCode和equals的處理,遵循如下規則: 只要重寫 equals,就必須重寫 hashCode。 因為 Set 存儲的是不重複的對象,依據 hashCode 和 equals 進行判斷,所以 Set 存儲的對象必須重寫 這兩個方法。 如果自定義對...
-
《阿里Java開發手冊》 | 編程規約 - 日期時間
【強制】 日期格式化時,傳入 pattern 中表示年份統一使用小寫的 y。 說明: 日期格式化時,yyyy 表示當天所在的年,而大寫的 YYYY 代表是 week in which year(JDK7 之後引入的概念),意思是當天所在的週屬於的年份,一周從周日開始,週六結束,只要本週...
-
《阿里Java開發手冊》 | 編程規約 - OOP規約
【強制】 避免通過一個類的對象引用訪問此類的靜態變數或靜態方法,無謂增加編譯器解析成本,直接用 類名 來訪問即可。 【強制】 所有的覆寫方法,必須加@Override註解。 說明: getObject()與 get0bject()的問題。一個是字母的 O,一個是數字的...