<s id="6lfy6"><big id="6lfy6"></big></s>
<i id="6lfy6"></i>
<acronym id="6lfy6"><u id="6lfy6"></u></acronym>
      <i id="6lfy6"></i>

    1. <mark id="6lfy6"><table id="6lfy6"></table></mark>

    2. <i id="6lfy6"><div id="6lfy6"></div></i>

      <li id="6lfy6"><button id="6lfy6"></button></li>
        1. <legend id="6lfy6"><font id="6lfy6"></font></legend>

              <video id="6lfy6"><rp id="6lfy6"></rp></video>

                <strong id="6lfy6"></strong>
                <ol id="6lfy6"><blockquote id="6lfy6"><rp id="6lfy6"></rp></blockquote></ol>
                <legend id="6lfy6"><table id="6lfy6"><button id="6lfy6"></button></table></legend>
                1. <em id="6lfy6"><strike id="6lfy6"></strike></em>
                2. <dd id="6lfy6"></dd>
                3. 懷化熱線

                  懷化熱線 > 美食

                  為什么阿里工程師代碼寫的好?看看他的代碼規范就知道了

                  2020-04-04 11:45:43 來源: 閱讀:-

                  摘要

                  本文主要講解阿里JAVA開發手冊中比較重要的設計規范,這些重要的設計規范有助于我們改進自己的代碼,提升系統的系統的性能。


                  曾經與一位從阿里出來的Java工程師一起工作過一段時間,他的技術說不上非常厲害,但是,他的代碼寫的的非常好,凡是他做的功能很少出現Bug。我就很好奇,于是經常向他請教一些代碼設計的原則,然后他告訴了我阿里Java手冊。并且,他將這個手冊進行了修改,也成為了我司Java程序員的開發手冊。這篇文章就讓我們看一看這個手冊中比較重要的原則。


                  為什么阿里工程師代碼寫的好?看看他的代碼規范就知道了




                  【強制】代碼中的命名均不能以下劃線或美元符號開始,也不能以下劃線或美元符號結束。

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


                  【強制】類型與中括號緊挨相連來表示數組。

                  正例:定義整形數組 int[] arrayDemo; 反例:在 main 參數中,使用 String args[]來定義。


                  【強制】POJO 類中布爾類型變量都不要加 is 前綴,否則部分框架解析會引起序列化錯誤。

                  說明:表達是與否的值采用 is_xxx 的命名方式,所以,需要在 設置從 is_xxx 到 xxx 的映射關系。

                  反例:定義為基本數據類型 Boolean isDeleted 的屬性,它的方法也是 isDeleted(),RPC 框架在反向解 析的時候,“誤以為”對應的屬性名稱是 deleted,導致屬性獲取不到,進而拋出異常。


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

                  正例:startTime / workQueue / nameList / TERMINATED_THREAD_COUNT
                  反例:startedAt / QueueOfWork / listName / COUNT_TERMINATED_THREAD


                  為什么阿里工程師代碼寫的好?看看他的代碼規范就知道了


                  【推薦】接口類中的方法和屬性不要加任何修飾符號(public 也不要加),保持代碼的簡潔 性,并加上有效的 Javadoc 注釋。盡量不要在接口里定義變量,如果一定要定義變量,肯定 是與接口方法相關,并且是整個應用的基礎常量。

                  正例:接口方法簽名 void commit();

                  接口基礎常量 String COMPANY = "alibaba";

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

                  說明:JDK8 中接口允許有默認實現,那么這個 default 方法,是對所有實現類都有價值的默認實現。


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

                  說明:枚舉其實就是特殊的類,域成員均為常量,且構造方法被默認強制是私有。

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


                  【參考】各層命名規約:

                  • A) Service/DAO 層方法命名規約

                  1) 獲取單個對象的方法用 get 做前綴。

                  2) 獲取多個對象的方法用 list 做前綴,復數形式結尾如:listObjects。 3) 獲取統計值的方法用 count 做前綴。

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

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

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

                  • B) 領域模型命名規約

                  1) 數據對象:xxxDO,xxx 即為數據表名。

                  2) 數據傳輸對象:xxxDTO,xxx 為業務領域相關的名稱。

                  3) 展示對象:xxxVO,xxx 一般為網頁名稱。

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


                  為什么阿里工程師代碼寫的好?看看他的代碼規范就知道了


                  【強制】不允許任何魔法值(即未經預先定義的常量)直接出現在代碼中。

                   反例:String key = "Id#taobao_" + tradeId;
                  cache.put(key, value);
                  cache.put(key, value);

                  緩存 get 時,由于在代碼復制時,漏掉下劃線,導致緩存擊穿而出現問題


                  【強制】避免通過一個類的對象引用訪問此類的靜態變量或靜態方法,無謂增加編譯器解析 成本,直接用類名來訪問即可。


                  【強制】相同參數類型,相同業務含義,才可以使用Java的可變參數,避免使用Object。

                  說明:可變參數必須放置在參數列表的最后。(提倡同學們盡量不用可變參數編程)

                  正例:public List listUsers(String type, Long... ids) {...}


                  【強制】所有整型包裝類對象之間值的比較,全部使用equals方法比較。

                  說明:對于 Integer var = ? 在-128 至 127 范圍內的賦值,Integer 對象是在 IntegerCache.cache 產 生,會復用已有對象,這個區間內的 Integer 值可以直接使用==進行判斷,但是這個區間之外的所有數 據,都會在堆上產生,并不會復用已有對象,這是一個大坑,推薦使用 equals 方法進行判斷。


                  關于基本數據類型與包裝數據類型的使用標準如下:

                  • 1) 【強制】所有的 POJO 類屬性必須使用包裝數據類型。
                  • 2) 【強制】RPC 方法的返回值和參數必須使用包裝數據類型。 3) 【推薦】所有的局部變量使用基本數據類型。

                  說明:POJO 類屬性沒有初值是提醒使用者在需要使用時,必須自己顯式地進行賦值,任何 NPE 問題,或 者入庫檢查,都由使用者來保證。

                  正例:數據庫的查詢結果可能是 null,因為自動拆箱,用基本數據類型接收有 NPE 風險。

                  反例:比如顯示成交總額漲跌情況,即正負 x%,x 為基本數據類型,調用的 RPC 服務,調用不成功時, 返回的是默認值,頁面顯示為 0%,這是不合理的,應該顯示成中劃線。所以包裝數據類型的 null 值,能 夠表示額外的信息,如:遠程調用失敗,異常退出。


                  為什么阿里工程師代碼寫的好?看看他的代碼規范就知道了


                  【強制】POJO 類必須寫 toString 方法。

                  使用 IDE 中的工具:source> generate toString 時,如果繼承了另一個 POJO 類,注意在前面加一下 super.toString。

                  說明:在方法執行拋出異常時,可以直接調用 POJO 的 toString()方法打印其屬性值,便于排查問題。


                  【強制】關于hashCode和equals的處理,遵循如下規則:

                  • 1) 只要覆寫 equals,就必須覆寫 hashCode。
                  • 2) 因為 Set 存儲的是不重復的對象,依據 hashCode 和 equals 進行判斷,所以 Set 存儲的對象必須覆 寫這兩個方法。
                  • 3) 如果自定義對象作為 Map 的鍵,那么必須覆寫 hashCode 和 equals。

                  說明:String 已覆寫 hashCode 和 equals 方法,所以我們可以愉快地使用 String 對象作為 key 來使用。


                  【強制】線程資源必須通過線程池提供,不允許在應用中自行顯式創建線程。

                  說明:線程池的好處是減少在創建和銷毀線程上所消耗的時間以及系統資源的開銷,解決資源不足的問 題。如果不使用線程池,有可能造成系統創建大量同類線程而導致消耗完內存或者“過度切換”的問題。


                  【強制】線程池不允許使用Executors去創建,而是通過ThreadPoolExecutor的方式,這樣的處理方式讓寫的同學更加明確線程池的運行規則,規避資源耗盡的風險。


                  為什么阿里工程師代碼寫的好?看看他的代碼規范就知道了


                  總結

                  以上規范在設計代碼中,是比較重要的原則。如果編寫代碼的過程中,可以依照以上原則,那代碼的可讀性和可維護性將大大提升

                  推薦閱讀:科技資訊

                  相關閱讀

                  懷化熱線版權與免責聲明:

                  一、凡本站中注明“來源:懷化熱線”的所有文字、圖片和音視頻,版權均屬懷化熱線所有,轉載時必須注明“來源:懷化熱線”,并附上原文鏈接。

                  二、凡來源非懷化熱線的(作品)只代表本網傳播該消息,并不代表贊同其觀點。

                  如因作品內容、版權和其它問題需要同本網聯系的,請在見網后30日內進行聯系。

                  亚洲中文字幕无码AV在线_久久免费看少妇高潮A片特黄网站_55大东北熟女啪啪嗷嗷叫_99久久免费国产精品2021 特黄少妇60分钟在线观看播放_欧美大肥婆BBBWW_亚洲一区二区三区 无码_chinapissing偷窥女wc 亚洲欧洲动漫无码_久热最新最近亚洲国产精品_最精品中文字幕亚洲日本_在线观看精品国产福利片... 他的舌头弄得我欲仙欲死_亚洲人成人网站在线观看_亚洲国产成人精品无码区5566_肥大BBWBBW高潮毛毛 国产精品r级最新在线观看_第一次处破女18分钟网站_天天躁日日躁狠狠躁一区_中文乱码人妻系列一区 大地影院日本韩国免费播放_国产麻豆一精品一AV一免费_超薄丝袜足J好爽在线_久久亚洲精品无码AⅤ电影