資訊專欄INFORMATION COLUMN
摘要：熟悉和遵守阿里巴巴開發手冊的編程風格，那只是標，而代碼可讀性的本可以追溯到軟件設計階段。何為條設計規約是根據阿里巴巴實際項目架構經驗提煉而成，共條。本次新增的不單是條新的設計規約，還是千萬阿里人的技術之心。
摘要：2018年6月，《阿里巴巴Java開發手冊》再次刷新代碼規范認知，我們新增了16條設計規約！現免費開放下載，不可錯過！
《阿里巴巴Java開發手冊》是阿里內部Java工程師所遵循的開發規范，涵蓋編程規約、單元測試規約、異常日志規約、MySQL規約、工程規約、安全規約等，這是近萬名阿里Java技術精英的經驗總結，并經歷了多次大規模一線實戰檢驗及完善。這是阿里回饋給Java社區的一份禮物，希望能夠幫助企業開發團隊在Java開發上更高效、容錯、有協作性，提高代碼質量，降低項目維護成本。
2018年6月5日，《阿里巴巴Java開發手冊》再次刷新代碼規范認知，我們新增了16條設計規約！
點此免費下載《阿里巴巴Java開發手冊》（詳盡版）！
為何要新增設計規約？
膾炙人口的唐詩“兩個黃鸝鳴翠柳，一行白鷺上青天”，清爽直接，簡明易懂。可讀性好的代碼也是讓人陶醉的，那么如何寫出可讀性的代碼？
代碼的可讀性是指代碼讓人容易閱讀、理解、調試、可預料的程度。提高代碼的可讀性可以為代碼閱讀者節約時間和精力，提升團隊協作效率。熟悉和遵守《阿里巴巴JAVA開發手冊》的編程風格，那只是“標”，而代碼可讀性的“本”可以追溯到軟件設計階段。試想一下如果發型師沒有設計好，不用指望能剪出一個“可讀性”比較好的你。
設計是一種夢想和追求，誰都喜歡有氣質的女神，誰都會欣賞有設計感的代碼。你可能會問，什么是設計感？就像燒飯這件事，村姑和御廚都會燒，都能吃飽，但是菜品的美感、口感，有本質的區別。代碼到藝術層面上，能夠體現出來非常好的擴展性、解耦性。代碼就象積木一樣，換一個搭法，也是OK的，結構清晰，不用擔心拔出蘿卜帶出泥。
何為16條？
設計規約是根據阿里巴巴實際項目架構經驗提煉而成，共16條。設計規約主要從UML圖和架構設計原則來規定比較基礎的軟件設計理念，并且明確了超過什么樣的閾值需要以什么樣的方式來呈現設計思維。根據阿里巴巴內部的反饋聲音來看，對于數據底層結構、狀態圖、以及敏捷開發相關的三條，共鳴感最強，那么詳細點評一下：
數據底層結構
底層數據結構屬于大廈的地基工程，如果地基不穩，那么上層去修正難度是相當大的，甚至是無法修正。所以設計規約提倡，存儲方案和底層數據結構的設計獲得評審一致通過，并沉淀成為文檔。有缺陷的底層數據結構容易導致系統風險高，可擴展性差，重構成本因歷史數據遷移、系統平滑過渡也會陡然增加，所以，存儲方案和數據結構需要認真地進行設計和評審，生產環境提交執行后，需要進行double check。評審內容包括存儲介質選型、表結構設計能否滿足技術方案、存取性能和存儲空間能否滿足業務發展、表或字段之間的辯證關系、字段名稱、字段類型、索引等；數據結構變更（如在原有表中新增字段）也需要進行評審通過后上線。
狀態圖
業務對象狀態相關的編碼錯誤是引起線上故障的一個重要導火索。多一個狀態，少一個狀態，如果沒有歷史設計文檔沉淀，那么都是災難性的。如果某個業務對象的狀態超過3個，使用狀態圖來表達并且明確狀態變化的各個觸發條件。狀態圖的核心是對象狀態，首先明確對象有多少種狀態，然后明確兩兩狀態之間是否存在直接轉換關系，再明確觸發狀態轉換的條件是什么。淘寶訂單狀態有已下單、待付款、已付款、待發貨、已發貨、已收貨等。比如已下單與已收貨這兩種狀態之間是不可能有直接轉換關系的。
敏捷開發
敏捷開發是當下流行的一種開發模式，相比傳統軟件生產流程，更加快速地交付。但是，敏捷開發適合于信任度好、理解力強、技術水平相對一致的創業型團隊。但是在很多公司敏捷成為一個抓進度的拔苗助長式的借口。所以避免如下誤解：敏捷開發 = 講故事 + 編碼 + 發布。敏捷開發是快速交付迭代可用的系統，省略多余的設計方案，摒棄傳統的審批流程，但核心關鍵點上的必要設計和文檔沉淀是需要的。
寫在最后
我們相信技術之心生生不息，也相信好的規約值得被傳播和應用。
本次新增的不單是16條新的設計規約，還是千萬阿里人的技術之心。
我們也期待大家的意見，持續完善，
那么說說大家眼里的軟件設計中遇到的坑吧。
本文作者：孤盡
原文鏈接
文章版權歸作者所有，未經允許請勿轉載,若此文章存在違規行為，您可以聯系管理員刪除。
轉載請注明本文地址：http://specialneedsforspecialkids.com/yun/69685.html
摘要：年月底，阿里巴巴集團發布了阿里巴巴開發手冊終極版，年月日，在杭州云棲大會上，代碼規約插件全球首發，插件支持以上版本和以上版本。阿里巴巴代碼規約插件安裝阿里代碼規約插件有插件和插件。 2017年9月底，阿里巴巴集團發布了《阿里巴巴Java開發手冊》PDF終極版，2017年10月14日，在2017杭州云棲大會上，Java代碼規約插件全球首發，p3c-pmd插件支持Eclipse4.2以上版...
摘要：強制存儲方案和底層數據結構的設計獲得評審一致通過，并沉淀成為文檔。正例淘寶訂單狀態有已下單待付款已付款待發貨已發貨已收貨等。確定指導后續設計與演化的原則。 showImg(https://segmentfault.com/img/remote/1460000016159838?w=1215&h=642); 1、【強制】存儲方案和底層數據結構的設計獲得評審一致通過，并沉淀成為文檔。 說...
摘要：說明這篇文章是我第一次認真閱讀阿里巴巴開發手冊終極版的筆記。說明本手冊明確防止是調用者的責任。一年半載后，那么單元測試幾乎處于廢棄狀態。好的單元測試能夠最大限度地規避線上故障。 說明 這篇文章是我第一次（認真）閱讀《阿里巴巴 Java 開發手冊(終極版)》的筆記。手冊本身對規范的講解已經非常詳細了，如果你已經有一定的開發經驗并且有良好的編碼習慣和意識，會發現大部分規范是符合常識的。所以...
摘要：的類型均為類型，前者現在時表示主動創建，后者過去分詞表示被動更新。推薦單表行數超過萬行或者單表容量超過，才推薦進行分庫分表。超過三個表禁止。防止因字段類型不同造成的隱式轉換，導致索引失效。說明會統計值為的行，而列名不會統計此列為值的行。 一.編程規約 (一)命名風格 1.目錄使用小寫+下劃線 home,view,model,admin_view 2.類 UpperCamelCa...
閱讀 1605·2021-11-04 16:11
閱讀 3316·2021-09-09 11:33
閱讀 1566·2019-08-30 15:54
閱讀 623·2019-08-30 15:44
閱讀 3180·2019-08-30 15:43
閱讀 2561·2019-08-30 13:06
閱讀 1701·2019-08-29 17:00
閱讀 903·2019-08-29 15:33
