阿里妹導讀：DonRoberts提出的一條重構準則：第一次做某件事時只管去做；第二次做類似的事時會產生反感，但無論如何還是可以去做；第三次再做類似的事時，你就應該重構。
編碼也是如此，當多次編寫類似的代碼時，我們需要考慮是否有一種***能夠提高編碼速度，讓編碼速度“起飛”？高德地圖技術專家陳昌毅（常意）多年來致力于敏捷開發，總結了一套編碼的***論，有助于程序員"快速、優質、高效"地進行編碼。
***1：手工編寫代碼大多數剛學習Java的程序員，都會懷著一種崇敬的儀式感，一字一句地在開發工具上敲出以下代碼：
publicclassTest{publicstaticvoidmain(String[]args){System.out.println("Helloworld!");}}沒錯，這就是經典的"Helloworld"，這也是大多數人手工編寫的第一個程序。
手工編寫代碼，更能體現一個程序員的基本素質。有很多公司，都把上機編程考試作為面試的重要手段之一。面試者需要根據題目的要求，挑選一款熟悉的編程工具（比如Eclipse），手工編寫代碼并調試運行通過。在整個過程中，不能通過網絡搜索答案，不能查看聯機幫助文檔，要求面試者必須手工編寫代碼，主要是考察面試者手工編寫代碼的能力——語法、函數、邏輯、思維、算法以及動手能力。
手工編寫代碼，是一個優秀程序員必須具備的基礎能力。手工編寫代碼正如提筆寫文章，語法就是遣詞造句的***、函數就是組成文章的詞句、類庫就是據經引典的掌故、架構就是行文表述的體裁、功能就是寫作文章的主旨、算法就是組織語言的邏輯……所以，只要掌握一門程序語言的語法、學習一堆基礎類庫的函數、引用一些所需的第三方類庫、選擇一款成熟穩定的架構、明確一下產品需求的功能、挑選一種實現邏輯的算法……手工編寫代碼就會像寫文章一樣手到擒來。
***2：復制粘貼代碼常言道："熟讀唐詩三百首，不會作詩也會吟。"編碼也是同樣的道理，編碼的第一步就是模仿，簡單地說就是"抄代碼"——復制粘貼代碼。復制粘貼代碼是一門藝術，用好了編碼會事半功倍。但是，沒有檢驗過的東西，終究是不可全信的。當看到需要的代碼時，在復制粘貼前，我們都需要仔細研讀、認真思考、詳細甄別……很多東西，都是仁者見仁、智者見智的東西，適合別的場景但不一定適合你的場景。作為一名合格的程序員，切不可一味地"拿來主義"。
1.為什么要復制粘貼代碼
復制粘貼現有代碼，可以節省開發時間；復制粘貼穩定代碼，可以降低系統故障風險；復制粘貼網絡代碼，可以把別人的成果化為己用。2.復制粘貼代碼帶來問題
你對復制的代碼理解程度是多少？實現邏輯是否合理？能不能穩定運行？存在多少潛在的Bug?這個代碼在項目中已經復制粘貼了多少次？根據“三則重構”原則，你是否需要對這些相同代碼進行重構？代碼被復制粘貼次數越多，帶來的代碼維護問題越多。多個代碼版本的更改和修正，要保持這些代碼的同步，就必須需要在每一處進行同樣的修改，增加了維護的成本和風險。總之，復制粘貼代碼，跟其它編碼***一樣，沒有優劣對錯之分。它只是一種***，你可以善用，也可以濫用。如果我們用到了復制粘貼，我們就必須為結果負責。
***3：用文本替換生成代碼1.生成代碼樣例
已經編寫好的用戶查詢相關代碼：
/**查詢用戶服務函數*/publicPageData<UserVO>queryUser(QueryUserParameterVOparameter){LongtotalCount=userDAO.countByParameter(parameter);List<UserVO>userList=null;if(Objects.nonNull(totalCount)&&totalCount.compareTo(0L)>0){userList=userDAO.queryByParameter(parameter);}returnnewPageData<>(totalCount,userList);}/**查詢用戶控制器函數*/@RequestMapping(path="/queryUser",method=RequestMethod.POST)publicResult<PageData<UserVO>>queryUser(@Valid@RequestBodyQueryUserParameterVOparameter){PageData<UserVO>pageData=userService.queryUser(parameter);returnResult.success(pageData);}如果我們要編寫公司查詢相關代碼，其代碼形式與用戶查詢類似，整理出替換關系如下：
把"用戶"替換為"公司";把"User"替換為"Company";把"user"替換為"company"。利用Notepad、EditPlus等文本編輯器，選擇區分大小寫，進行普通文本替換，最終得到結果如下：
/**查詢公司服務函數*/publicPageData<CompanyVO>queryCompany(QueryCompanyParameterVOparameter){LongtotalCount=companyDAO.countByParameter(parameter);List<CompanyVO>companyList=null;if(Objects.nonNull(totalCount)&&totalCount.compareTo(0L)>0){companyList=companyDAO.queryByParameter(parameter);}returnnewPageData<>(totalCount,companyList);}/**查詢公司控制器函數*/@RequestMapping(path="/queryCompany",method=RequestMethod.POST)publicResult<PageData<CompanyVO>>queryCompany(@Valid@RequestBodyQueryCompanyParameterVOparameter){PageData<CompanyVO>pageData=companyService.queryCompany(parameter);returnResult.success(pageData);}利用文本替換生成代碼，整段代碼生成時間不會超過1分鐘。
2.主要優缺點
主要優點：
生成代碼速度較快。主要缺點：
必須編寫樣例代碼；只適用于文本替換的情景。***4：用Excel公式生成代碼Excel的公式非常強悍，可以用于編寫一些公式化的代碼。
1.利用Excel公式生成模型類
從WIKI上拷貝接口模型定義到Excel里，樣例數據內容如下：
編寫Excel公式如下：
="/**"&D6&IF(ISBLANK(F6),"","("&F6&")")&"*/"&IF(E6="否",IF(C6="String","@NotBlank","@NotNull"),"")&"private"&C6&""&B6&";"利用公式生成代碼如下：
/**用戶標識*/@NotNullprivateLongid;/**用戶名稱*/@NotBlankprivateStringname;/**用戶性別(0:未知;1:男;2:女)*/@NotNullprivateIntegersex;/**用戶描述*/privateStringdescription;創建模型類，整理代碼如下：
/**用戶DO類*/publicclassUserDO{/**用戶標識*/@NotNullprivateLongid;/**用戶名稱*/@NotBlankprivateStringname;/**用戶性別(0:未知;1:男;2:女)*/@NotNullprivateIntegersex;/**用戶描述*/privateStringdescription;......}2.利用Excel公式生成枚舉類
從WIKI上拷貝枚舉定義到Excel里，樣例數據內容如下：
編寫Excel公式如下：
="/**"&D2&"("&B2&")*/"&C2&"("&B2&","""&D2&"""),"利用公式生成代碼如下：
/**空(0)*/NONE(0,"空"),/**男(1)*/MAN(1,"男"),/**女(2)*/WOMAN(2,"女"),創建枚舉類，整理代碼如下：
/**用戶性別枚舉*/publicenumUserSex{/**枚舉定義*//**空(0)*/NONE(0,"空"),/**男(1)*/MAN(1,"男"),/**女(2)*/WOMAN(2,"女");......}3.利用Excel公式生成數據庫語句
用Excel整理的公司列表如下，需要整理成SQL語句直接插入數據庫：
編寫Excel公式如下：
="('"&B2&"','"&C2&"','"&D2&"','"&E2&"'),"利用公式生成SQL如下：
('高德','首開大廈','(010)11111111','gaode@xxx.com'),('阿里云','綠地中心','(010)22222222','aliyun@xxx.com'),('菜鳥','阿里中心','(010)33333333','cainiao@xxx.com'),添加into語句頭，整理SQL如下：
insertintot_company(name,address,phone,email)values('高德','首開大廈','(010)11111111','gaode@xxx.com'),('阿里云','綠地中心','(010)22222222','aliyun@xxx.com'),('菜鳥','阿里中心','(010)33333333','cainiao@xxx.com');4.主要優缺點
主要優點：
適用于表格化數據的代碼生成；寫好公式后，拖拽生成代碼，生成速度較快。主要缺點：
不適用于復雜功能的代碼生成。***5：用工具生成代碼用工具生成代碼，顧名思義就是借用已有的工具生成代碼。很多開發工具都提供一些工具生成代碼，比如：生成構造函數，重載基類/接口函數，生成Getter/Setter函數，生成toString函數……能夠避免很多手敲代碼。還有一些生成代碼插件，也可以生成滿足某些應用場景的代碼。
這里以mybatis-generator插件生成代碼為例，介紹如何利用工具生成代碼。
1.安裝運行插件
具體***這里不再累述，自行上網搜索文檔了解。
2.生成代碼樣例
|2.1.生成模型類代碼
文件User.java內容：
......publicclassUser{privateLongid;privateStringuser;privateStringpassword;privateIntegerage;......}|2.2.生成映射接口代碼
文件UserMapper.java內容：
......publicinterfaceUserMapper{UserselectByPrimaryKey(Longid);......}|2.3.生成映射XML代碼
文件UserMapper.xml內容：
......<mappernamespace="com.test.dao.UserMapper"><resultMapid="BaseResultMap"type="com.test.pojo.User"><idcolumn="id"property="id"jdbcType="BIGINT"/><resultcolumn="user"property="user"jdbcType="VARCHAR"/><resultcolumn="password"property="password"jdbcType="VARCHAR"/><resultcolumn="age"property="age"jdbcType="INTEGER"/></resultMap><sqlid="Base_Column_List">id,user,password,age</sql><selectid="selectByPrimaryKey"resultMap="BaseResultMap"parameterType="java.lang.Long">select<includerefid="Base_Column_List"/>fromtest_userwhereid=#{id,jdbcType=BIGINT}</select>......</mapper>3.主要優缺點
主要優點：
利用生成代碼插件，生成代碼速度較快；利用插件配置文件，控制生成想要的功能代碼。主要缺點：
需要時間研究和熟悉生成代碼插件的使用；生成的代碼不一定滿足代碼規范，每次生成后需進行代碼合規；重新生成代碼后，容易覆蓋自定義代碼（建議維護單獨的生成代碼庫，通過DIFF工具比較代碼差異，然后再賦值粘貼差異代碼）。***6：用代碼生成代碼用代碼生成代碼，就是自己編寫代碼，按照自己的格式生成代碼。下面，以生成基于MyBatis的數據庫訪問代碼為例說明。
1.查詢表格信息
首先，我們要從數據庫中拿到我們生成代碼所需要的表和列相關信息。
|1.1.查詢表信息
查詢表信息語句：
selectt.table_nameas'表名稱',t.table_commentas'表備注'frominformation_schema.tablestwheret.table_schema=?andt.table_type='BASETABLE'andt.table_name=?;其中，第1個問號賦值數據庫名稱，第2個問號賦值表名稱。
查詢表信息結果：
|1.2.查詢列信息
查詢列信息語句：
selectc.column_nameas'列名稱',c.column_commentas'列備注',c.data_typeas'數據類型',c.character_maximum_lengthas'字符長度',c.numeric_precisionas'數字精度',c.numeric_scaleas'數字范圍',c.column_defaultas'',c.is_nullableas'是否可空',c.column_keyas'列鍵名'frominformation_schema.columnscwherec.table_schema=?andc.table_name=?orderbyc.ordinal_position;其中，第1個問號賦值數據庫名稱，第2個問號賦值表名稱。
查詢列信息結果：
2.編寫生成代碼
|2.1.編寫生成模型類代碼
/**生成模型類文件函數*/privatevoidgenerateModelClassFile(Filedir,Tabletable,List<Column>columnList)throwsException{try(PrintWriterwriter=newPrintWriter(newFile(dir,className+"DO.java"))){StringclassName=getClassName(table.getTableName());StringclassComments=getClassComment(table.getTableComment());writer.println("package"+groupName+"."+systemName+".database;");......writer.println("/**"+classComments+"DO類*/");writer.println("@Getter");writer.println("@Setter");writer.println("@ToString");writer.println("publicclass"+className+"DO{");for(Columncolumn:columnList){StringfieldType=getFieldType(column);StringfieldName=getFieldName(column.getColumnName());StringfieldComment=getFieldComment(column);writer.println(" /**"+fieldComment+"*/");writer.println(" private"+fieldType+""+fieldName+";");}writer.println("}");}}|2.2.編寫生成DAO接口代碼
/**生成DAO接口文件函數*/privatevoidgenerateDaoInterfaceFile(Filedir,Tabletable,List<Column>columnList,List<Column>pkColumnList)throwsException{try(PrintWriterwriter=newPrintWriter(newFile(dir,className+"DAO.java"))){StringclassName=getClassName(table.getTableName());StringclassComments=getClassComment(table.getTableComment());writer.println("package"+groupName+"."+systemName+".database;");......writer.println("/**"+classComments+"DAO接口*/");writer.println("publicinterface"+className+"DAO{");writer.println(" /**獲取"+classComments+"函數*/");writer.print(" public"+className+"DOget(");booleanisFirst=true;for(ColumnpkColumn:pkColumnList){if(!isFirst){writer.print(",");}else{isFirst=false;}StringfieldType=getFieldType(pkColumn);StringfieldName=getFieldName(pkColumn.getColumnName());writer.print("@Param(""+fieldName+"")"+fieldType+""+fieldName);}writer.println(");");......writer.println("}");}}|2.3.編寫生成DAO映射代碼
/**生成DAO映射文件函數*/privatevoidgenerateDaoMapperFile(Filedir,Tabletable,List<Column>columnList,List<Column>pkColumnList)throwsException{try(PrintWriterwriter=newPrintWriter(newFile(dir,className+"DAO.xml"))){StringclassName=getClassName(table.getTableName());StringclassComments=getClassComment(table.getTableComment());writer.println("<?xmlversion="1.0"encoding="UTF-8"?>");......writer.println("<!--"+classComments+"映射-->");writer.println("<mappernamespace=""+groupName+"."+systemName+".database."+className+"DAO">");writer.println(" <!--所有字段語句-->");writer.println(" <sqlid="fields">");if(CollectionUtils.isNotEmpty(columnList)){booleanisFirst=true;StringcolumnName=getColumnName(pkColumn.getColumnName());for(Columncolumn:columnList){if(isFirst){isFirst=false;writer.println(" "+columnName);}else{writer.println(" ,"+columnName);}}}writer.println(" </sql>");writer.println(" <!--獲取"+classComments+"函數語句-->");writer.println(" <selectid="get"resultType=""+groupName+"."+systemName+".database."+className+"DO">");writer.println(" select");writer.println(" <includerefid="fields"/>");writer.println(" from"+table.getTableName());booleanisFirst=true;for(ColumnpkColumn:pkColumnList){StringcolumnName=getColumnName(pkColumn.getColumnName());StringfieldName=getFieldName(pkColumn.getColumnName());writer.print(" ");if(isFirst){writer.print("where");isFirst=false;}else{writer.print("and");}writer.println(""+columnName+"=#{"+fieldName+"}");}writer.println(" </select>");writer.println("</mapper>");}}3.生成相關代碼
|3.1.生成的模型類代碼
/**組織公司DO類*/@Getter@Setter@ToStringpublicclassOrgCompanyDO{/**公司標識*/privateLongid;/**公司名稱*/privateStringname;/**聯系地址*/privateStringaddress;/**公司描述*/privateStringdescription;}|3.2.生成的DAO接口代碼
/**組織公司DAO接口*/publicinterfaceOrgCompanyDAO{/**獲取組織公司函數*/publicOrgCompanyDOget(@Param("id")Longid);}|3.3.生成的DAO映射代碼
<!--組織公司映射--><mappernamespace="xxx.database.OrgCompanyDAO"><!--所有字段語句--><sqlid="fields">id,name,address,description</sql><!--獲取組織公司函數語句--><selectid="get"resultType="xxx.database.OrgCompanyDO">select<includerefid="fields"/>fromorg_companywhereid=#{id}</select></mapper>3.主要優缺點
主要優點：
代碼格式可以定制，保證生成代碼合規；代碼功能可以定制，只生成需要的代碼；經過前期代碼沉淀后，后期能夠直接使用。主要缺點：
需要研究數據來源，保證能獲取到生成代碼所需的數據；需要建立數據模型、編寫生成代碼，耗費時間比較長。終極***：無招勝有招編碼的終極***，是不是直接對著電腦說需求，然后電腦就自動生成代碼了？未來科技發展到一定水平后，這種情況或許會變成現實。但是，目前這種情況是不現實的。現實中，想要做到"大口一張、代碼就來"，除非你是老板、產品經理或者技術管理者。
編碼的終極***是“無招勝有招”，"無招"并不是不講究"招式"，而是不拘泥于某一"招式"，信手拈來合適的"招式"為宜。本文中列舉的各種編碼***，沒有高低優劣之分，只有合不合適之說。所以，靈活地運用各種編碼***，就是編碼的終極***。
代碼規范化在上面的各種編碼***中，很多***都需要手工編寫樣例代碼。如果你的代碼不遵循代碼規范，就很難發現代碼之間的共性，并抽象出能夠作為標準的樣例代碼；如果作為標準的樣例代碼不滿足代碼規范，必然導致生成的代碼也不滿足代碼規范，于是把這些不規范放大了十倍、百倍甚至千倍。所以，代碼規范化是編碼的重中之重。
作者：陳昌毅
