程序员离不开这 7 大编程方法

作者 | 陈昌毅

责编 | 伍杏玲

Don Roberts 提出的一条重构准则：

第一次做某件事时只管去做；第二次做类似的事时会产生反感，但无论如何还是可以去做；第三次再做类似的事时，你就应该重构。

编码也是如此，当多次编写类似的代码时，我们需要考虑是否有一种方法能够提高编码速度。作者多年来致力于敏捷开发，总结了一套编码的方法论，有助于程序员"快速、优质、高效"地进行编码。

手工编写代码

大多数刚学习 Java 的程序员，都会怀着一种崇敬的仪式感，一字一句地在开发工具上敲出以下代码：

public class Test {public static void main(String[] args) {System.out.println("Hello world!");}}

没错，这就是经典的"Hello world"，这也是大多数人手工编写的第一个程序。

手工编写代码，更能体现一个程序员的基本素质。有很多公司，都把上机编程考试作为面试的重要手段之一。面试者需要根据题目的要求，挑选一款熟悉的编程工具（比如Eclipse），手工编写代码并调试运行通过。在整个过程中，不能通过网络搜索答案，不能查看联机帮助文档，要求面试者必须手工编写代码，主要是考察面试者手工编写代码的能力——语法、函数、逻辑、思维、算法以及动手能力。

手工编写代码，是一个优秀程序员必须具备的基础能力。手工编写代码正如提笔写文章，语法就是遣词造句的方法、函数就是组成文章的词句、类库就是据经引典的掌故、架构就是行文表述的体裁、功能就是写作文章的主旨、算法就是组织语言的逻辑……所以，只要掌握一门程序语言的语法、学习一堆基础类库的函数、引用一些所需的第三方类库、选择一款成熟稳定的架构、明确一下产品需求的功能、挑选一种实现逻辑的算法……手工编写代码就会像写文章一样手到擒来。

复制粘贴代码

常言道："熟读唐诗三百首，不会作诗也会吟。"编码也是同样的道理，编码的第一步就是模仿，简单地说就是"抄代码"——复制粘贴代码。复制粘贴代码是一门艺术，用好了编码会事半功倍。但是，没有检验过的东西，终究是不可全信的。当看到需要的代码时，在复制粘贴前，我们都需要仔细研读、认真思考、详细甄别……很多东西，都是仁者见仁、智者见智的东西，适合别的场景但不一定适合你的场景。作为一名合格的程序员，切不可一味地"拿来主义"。

1.为什么要复制粘贴代码

  • 复制粘贴现有代码，可以节省开发时间；
  • 复制粘贴稳定代码，可以降低系统故障风险；
  • 复制粘贴网络代码，可以把别人的成果化为己用。

2.复制粘贴代码带来问题

  • 你对复制的代码理解程度是多少？实现逻辑是否合理？能不能稳定运行？存在多少潜在的 Bug?
  • 这个代码在项目中已经复制粘贴了多少次？根据“三则重构”原则，你是否需要对这些相同代码进行重构？
  • 代码被复制粘贴次数越多，带来的代码维护问题越多。多个代码版本的更改和修正，要保持这些代码的同步，就必须需要在每一处进行同样的修改，增加了维护的成本和风险。

总之，复制粘贴代码，跟其它编码方法一样，没有优劣对错之分。它只是一种方法，你可以善用，也可以滥用。如果我们用到了复制粘贴，我们就必须为结果负责。

用文本替换生成代码

1.生成代码样例

已经编写好的用户查询相关代码：

/** 查询用户服务函数 */public PageData<UserVO> queryUser(QueryUserParameterVO parameter) {Long totalCount = userDAO.countByParameter(parameter);List<UserVO> userList = ;if (Objects.non(totalCount) && totalCount.compareTo(0L) > 0) {userList = userDAO.queryByParameter(parameter);}return new PageData<>(totalCount, userList);}

/** 查询用户控制器函数 */@RequestMapping(path = "/queryUser", method = RequestMethod.POST)public Result<PageData<UserVO>> queryUser(@Valid @RequestBody QueryUserParameterVO parameter) {PageData<UserVO> pageData = userService.queryUser(parameter);return Result.success(pageData);}

如果我们要编写公司查询相关代码，其代码形式与用户查询类似，整理出替换关系如下：

  • 把"用户"替换为"公司";
  • 把"User"替换为"Company";
  • 把"user"替换为"company"。

利用 Notepad、EditPlus 等文本编辑器，选择区分大小写，进行普通文本替换，最终得到结果如下：

/** 查询公司服务函数 */public PageData<CompanyVO> queryCompany(QueryCompanyParameterVO parameter) {Long totalCount = companyDAO.countByParameter(parameter);List<CompanyVO> companyList = ;if (Objects.non(totalCount) && totalCount.compareTo(0L) > 0) {companyList = companyDAO.queryByParameter(parameter);}return new PageData<>(totalCount, companyList);}

/** 查询公司控制器函数 */@RequestMapping(path = "/queryCompany", method = RequestMethod.POST)public Result<PageData<CompanyVO>> queryCompany(@Valid @RequestBody QueryCompanyParameterVO parameter) {PageData<CompanyVO> pageData = companyService.queryCompany(parameter);return Result.success(pageData);}

利用文本替换生成代码，整段代码生成时间不会超过1分钟。

2.主要优缺点

主要优点：

  • 生成代码速度较快。

主要缺点：

  • 必须编写样例代码；
  • 只适用于文本替换的情景。

用Excel公式生成代码

Excel 的公式非常强悍，可以用于编写一些公式化的代码。

1.利用 Excel 公式生成模型类

从 Wiki 上拷贝接口模型定义到 Excel 里，样例数据内容如下：

编写 Excel 公式如下：

= "/** "&D6&IF(ISBLANK(F6), "", "("&F6&")")&" */ "&IF(E6 = "否", IF(C6 = "String", "@NotBlank", "@Not"), "")&" private "&C6&" "&B6&";"

利用公式生成代码如下：

/** 用户标识 */ @Not private Long id;/** 用户名称 */ @NotBlank private String name;/** 用户性别(0:未知;1:男;2:女) */ @Not private Integer sex;/** 用户描述 */ private String description;

创建模型类，整理代码如下：

/** 用户DO类 */public class UserDO {/** 用户标识 */@Notprivate Long id;/** 用户名称 */@NotBlankprivate String name;/** 用户性别(0:未知;1:男;2:女) */@Notprivate Integer sex;/** 用户描述 */private String description;......}

2.利用 Excel 公式生成枚举类

从 WIKI 上拷贝枚举定义到 Excel 里，样例数据内容如下：

编写 Excel 公式如下：

="/** "&D2&"("&B2&") */"&C2&"("&B2&", """&D2&"""),"

利用公式生成代码如下：

/** 空(0) */NONE(0, "空"),/** 男(1) */MAN(1, "男"),/** 女(2) */WOMAN(2, "女"),

创建枚举类，整理代码如下：

/** 用户性别枚举 */public enum UserSex {/** 枚举定义 *//** 空(0) */NONE(0, "空"),/** 男(1) */MAN(1, "男"),/** 女(2) */WOMAN(2, "女");......}

3.利用 Excel 公式生成数据库语句

用 Excel 整理的公司列表如下，需要整理成 SQL 语句直接插入数据库：

编写 Excel 公式如下：

= "(‘"&B2&"‘, ‘"&C2&"‘, ‘"&D2&"‘, ‘"&E2&"‘),"

利用公式生成 SQL 如下：

(‘高德‘, ‘首开大厦‘, ‘(010)11111111‘, ‘[email protected].com‘),(‘阿里云‘, ‘绿地中心‘, ‘(010)22222222‘, ‘[email protected].com‘),(‘菜鸟‘, ‘阿里中心‘, ‘(010)33333333‘, ‘[email protected].com‘),

添加 into 语句头，整理 SQL 如下：

insert into t_company(name, address, phone, email) values(‘高德‘, ‘首开大厦‘, ‘(010)11111111‘, ‘[email protected].com‘),(‘阿里云‘, ‘绿地中心‘, ‘(010)22222222‘, ‘[email protected].com‘),(‘菜鸟‘, ‘阿里中心‘, ‘(010)33333333‘, ‘[email protected].com‘);

4.主要优缺点

主要优点：

  • 适用于表格化数据的代码生成；
  • 写好公式后，拖拽生成代码，生成速度较快。

主要缺点：

  • 不适用于复杂功能的代码生成。

用工具生成代码

用工具生成代码，顾名思义就是借用已有的工具生成代码。很多开发工具都提供一些工具生成代码，比如：生成构造函数，重载基类/接口函数，生成 Getter/Setter 函数，生成 toString 函数……能够避免很多手敲代码。还有一些生成代码插件，也可以生成满足某些应用场景的代码。

这里以 mybatis-generator 插件生成代码为例，介绍如何利用工具生成代码。

1.安装运行插件

具体方法这里不再累述，自行上网搜索文档了解。

2.生成代码样例

2.1.生成模型类代码

文件 User.java 内容：

......public class User {private Long id;private String user;private String password;private Integer age;......}

2.2.生成映射接口代码

文件 UserMapper.java 内容：

......public interface UserMapper {User selectByPrimaryKey(Long id);......}

2.3.生成映射XML代码

文件 UserMapper.xml 内容：

......<mapper namespace="com.test.dao.UserMapper" ><resultMap id="BaseResultMap" type="com.test.pojo.User" ><id column="id" property="id" jdbcType="BIGINT" /><result column="user" property="user" jdbcType="VARCHAR" /><result column="password" property="password" jdbcType="VARCHAR" /><result column="age" property="age" jdbcType="INTEGER" /></resultMap><sql id="Base_Column_List" >id, user, password, age</sql><select id="selectByPrimaryKey" resultMap="BaseResultMap" parameterType="java.lang.Long" >select<include refid="Base_Column_List" />from test_userwhere id = #{id,jdbcType=BIGINT}</select>......</mapper>

3.主要优缺点

主要优点：

  • 利用生成代码插件，生成代码速度较快；
  • 利用插件配置文件，控制生成想要的功能代码。

主要缺点：

  • 需要时间研究和熟悉生成代码插件的使用；
  • 生成的代码不一定满足代码规范，每次生成后需进行代码合规；
  • 重新生成代码后，容易覆盖自定义代码（建议维护单独的生成代码库，通过DIFF 工具比较代码差异，然后再赋值粘贴差异代码）。

用代码生成代码

用代码生成代码，就是自己编写代码，按照自己的格式生成代码。下面，以生成基于 MyBatis 的数据库访问代码为例说明。

1.查询表格信息

首先，我们要从数据库中拿到我们生成代码所需要的表和列相关信息。

1.1.查询表信息

查询表信息语句：

select t.table_name as ‘表名称‘, t.table_comment as ‘表备注‘from information_schema.tables twhere t.table_schema = ?and t.table_type = ‘BASE TABLE‘and t.table_name = ?;

其中，第1个问号赋值数据库名称，第2个问号赋值表名称。

查询表信息结果：

1.2.查询列信息

查询列信息语句：

select c.column_name as ‘列名称‘, c.column_comment as ‘列备注‘, c.data_type as ‘数据类型‘, c.character_maximum_length as ‘字符长度‘, c.numeric_precision as ‘数字精度‘, c.numeric_scale as ‘数字范围‘, c.column_default as ‘‘, c.is_able as ‘是否可空‘, c.column_key as ‘列键名‘from information_schema.columns cwhere c.table_schema = ?and c.table_name = ?order by c.ordinal_position;

其中，第1个问号赋值数据库名称，第2个问号赋值表名称。

查询列信息结果：

2.编写生成代码

2.1.编写生成模型类代码

/** 生成模型类文件函数 */private void generateModelClassFile(File dir, Table table, List<Column> columnList) throws Exception {try (PrintWriter writer = new PrintWriter(new File(dir, className + "DO.java"))) {String className = getClassName(table.getTableName);String classComments = getClassComment(table.getTableComment);writer.println("package " + groupName + "." + systemName + ".database;");......writer.println("/** " + classComments + "DO类 */");writer.println("@Getter");writer.println("@Setter");writer.println("@ToString");writer.println("public class " + className + "DO {");for (Column column : columnList) {String fieldType = getFieldType(column);String fieldName = getFieldName(column.getColumnName);String fieldComment = getFieldComment(column);writer.println("\t/** " + fieldComment + " */");writer.println("\tprivate " + fieldType + " " + fieldName + ";");}writer.println("}");}}

2.2.编写生成 DAO 接口代码

/** 生成DAO接口文件函数 */private void generateDaoInterfaceFile(File dir, Table table, List<Column> columnList, List<Column> pkColumnList) throws Exception {try (PrintWriter writer = new PrintWriter(new File(dir, className + "DAO.java"))) {String className = getClassName(table.getTableName);String classComments = getClassComment(table.getTableComment);writer.println("package " + groupName + "." + systemName + ".database;");......writer.println("/** " + classComments + "DAO接口 */");writer.println("public interface " + className + "DAO {");writer.println("\t/** 获取" + classComments + "函数 */");writer.print("\tpublic " + className + "DO get(");boolean isFirst = true;for (Column pkColumn : pkColumnList) {if (!isFirst) {writer.print(", ");} else {isFirst = false;}String fieldType = getFieldType(pkColumn);String fieldName = getFieldName(pkColumn.getColumnName);writer.print("@Param(\"" + fieldName + "\") " + fieldType + " " + fieldName);}writer.println(");");......writer.println("}");}}

2.3.编写生成 DAO 映射代码

/** 生成DAO映射文件函数 */private void generateDaoMapperFile(File dir, Table table, List<Column> columnList, List<Column> pkColumnList) throws Exception {try (PrintWriter writer = new PrintWriter(new File(dir, className + "DAO.xml"))) {String className = getClassName(table.getTableName);String classComments = getClassComment(table.getTableComment);writer.println("<?xml version=\"1.0\" encoding=\"UTF-8\"?>");......writer.println("<!-- " + classComments + "映射 -->");writer.println("<mapper namespace=\"" + groupName + "." + systemName + ".database." + className + "DAO\">");writer.println("\t<!-- 所有字段语句 -->");writer.println("\t<sql id=\"fields\">");if (CollectionUtils.isNotEmpty(columnList)) {boolean isFirst = true;String columnName = getColumnName(pkColumn.getColumnName);for (Column column : columnList) {if (isFirst) {isFirst = false;writer.println("\t\t" + columnName);} else {writer.println("\t\t, " + columnName);}}}writer.println("\t</sql>");writer.println("\t<!-- 获取" + classComments + "函数语句 -->");writer.println("\t<select id=\"get\" resultType=\"" + groupName + "." + systemName + ".database." + className + "DO\">");writer.println("\t\tselect");writer.println("\t\t<include refid=\"fields\"/>");writer.println("\t\tfrom " + table.getTableName);boolean isFirst = true;for (Column pkColumn : pkColumnList) {String columnName = getColumnName(pkColumn.getColumnName);String fieldName = getFieldName(pkColumn.getColumnName);writer.print("\t\t");if (isFirst) {writer.print("where");isFirst = false;} else {writer.print("and");}writer.println(" " + columnName + " = #{" + fieldName + "}");}writer.println("\t</select>");writer.println("</mapper>");}}

3.生成相关代码

3.1.生成的模型类代码

/** 组织公司DO类 */@Getter@Setter@ToStringpublic class OrgCompanyDO {/** 公司标识 */private Long id;/** 公司名称 */private String name;/** 联系地址 */private String address;/** 公司描述 */private String description;}

3.2.生成的 DAO 接口代码

/** 组织公司DAO接口 */public interface OrgCompanyDAO {/** 获取组织公司函数 */public OrgCompanyDO get(@Param("id") Long id);}

3.3.生成的 DAO 映射代码

<!-- 组织公司映射 --><mapper namespace="xxx.database.OrgCompanyDAO"><!-- 所有字段语句 --><sql id="fields">id, name, address, description</sql><!-- 获取组织公司函数语句 --><select id="get" resultType="xxx.database.OrgCompanyDO">select<include refid="fields"/>from org_companywhere id = #{id}</select></mapper>

3.主要优缺点

主要优点：

  • 代码格式可以定制，保证生成代码合规；
  • 代码功能可以定制，只生成需要的代码；
  • 经过前期代码沉淀后，后期能够直接使用。

主要缺点：

  • 需要研究数据来源，保证能获取到生成代码所需的数据；
  • 需要建立数据模型、编写生成代码，耗费时间比较长。

终极方法：无招胜有招

编码的终极方法，是不是直接对着电脑说需求，然后电脑就自动生成代码了？未来科技发展到一定水平后，这种情况或许会变成现实。但是，目前这种情况是不现实的。现实中，想要做到"大口一张、代码就来"，除非你是老板、产品经理或者技术管理者。

编码的终极方法是“无招胜有招”，"无招"并不是不讲究"招式"，而是不拘泥于某一"招式"，信手拈来合适的"招式"为宜。本文中列举的各种编码方法，没有高低优劣之分，只有合不合适之说。所以，灵活地运用各种编码方法，就是编码的终极方法。

代码规范化

在上面的各种编码方法中，很多方法都需要手工编写样例代码。如果你的代码不遵循代码规范，就很难发现代码之间的共性，并抽象出能够作为标准的样例代码；如果作为标准的样例代码不满足代码规范，必然导致生成的代码也不满足代码规范，于是把这些不规范放大了十倍、百倍甚至千倍。所以，代码规范化是编码的重中之重。

作者简介：陈昌毅，花名常意，高德地图技术专家，2018年加入阿里巴巴，一直从事地图数据采集的相关工作。

来源：http://www.news520.top/

原文地址：https://www.cnblogs.com/1994july/p/12301770.html

时间： 2024-08-13 12:22:53

程序员离不开这 7 大编程方法的相关文章

每个程序员都该知道的10大编程格言

每个程序员都该知道的10大编程格言 编程格言1:无风不起浪 (There is no smoke without fire) 编程格言2:预防为主,治疗为辅(An ounce of prevention is worth a pound of cure:) 编程格言3:不要把鸡蛋都放在一个篮子(Don't put all your eggs in one basket) 编程格言4:种瓜得瓜,种豆得豆(As you sow,so shoul you reap) 编程格言5:欲速则不达(Great

最牛程序员最爱逛的10大编程网站，你知道几个？-卓帆网

今天我给大家推荐10个高级程序员经常逛的网站,你又去过几个呢?来跟着小编一起看看都有哪些牛逼的网站吧. 0.https://github.com/trending 全球最大的开源仓库网站,不过现在嫁给微软了. ) 1.http://stackoverflow.com/ 踩过坑的都不会不知道她,解救程序员于危难之间啊 2.https://segmentfault.com/ 感觉和楼上是两个×××妹啊 3.https://blog.csdn.net/mcuhome 中国x大程序员交友网站 4.htt

程序员怎么学习C++？3大方法让你快速入门！

C++是一门系统级语言,有些程序员小伙伴学了很久才明白明白栈与堆.内存管理等的含义. 新手程序员学习C++很容易陷入误区,就是不停地啃书本,结果把自己搞的晕头转向的. 一个类的成员函数包含了重载.覆盖.虚函数.纯虚函数等,不得不说复杂. 程序员怎么学习C++?3大方法让你快速入门!最后,如果大家如果在自学遇到困难,想找一个C++的学习环境,可以加入我们的C++学习圈,点击我加入吧,会节约很多时间,减少很多在学习中遇到的难题. 那么,如何学习C++比较靠谱呢?w3cschool分享3种方法: 0.

程序员生存定律--升华成高手的可能方法

程序员生存定律这系列的目录在这里:程序员生存定律--目录 喜欢从头瞄的,可以移步. ------------------------------------------------------------------------------ 一旦度过了初始阶段,做过了前面说的那些事情,那么一个人算是基本入行了,接下来的目标就非常简单,要在选定方向上成为高手.高手意味着专业,而在分工无限细化的年代里,专业则是生存.发展好最为重要的一个前提. 1 高手的定义和养成关键 我估计如果问100个人“什么样

黑马程序员_学习IOS之字典常用的方法

字典是无序的 数组是有序的.字典分为:可变字典和不可变字典  不可变字典对象 NSDictionary * dict = [[NSDictionary alloc]initWithObjectsAndKeys:@"one",@"1",@"two",@"2",@"three",@"3",@"four",@"4", nil]; //value = ke

只有程序员可以看懂的笑话 大全集（2）

1.程序猿最烦两件事,第一件事是别人要他给自己的代码写文档,第二件呢?是别人的程序没有留下文档. 2.程序猿的读书历程:x 语言入门 -> x 语言应用实践 -> x 语言高阶编程 -> x 语言的科学与艺术 -> 编程之美 -> 编程之道 -> 编程之禅-> 颈椎病康复指南. 3.还没上大学的时候,高三暑假,跑到家那边的图书城想买传说中的C++的书,然后看到一本C#,我一看,嘿,这个++还写得挺艺术的,重叠起来了,于是把C#买了回来-- 4.问:程序猿最讨厌康熙

只有程序员可以看懂的笑话 大全集（1）

宪法顶个球!中国的法律都是.txt文件,不是.exe文件. 程序员:三年前,当我写下这个的时候,只有上帝和我能够看懂. 现在,只有 上帝能看懂了. 同事说,他在写i++的时候总觉的自己写的是 我艹.........有木有同感??? ? 程序员,年二十有二,始从文,连考而不中. 遂习武,练武场上发一矢,中鼓 吏,逐之出. 改学IT,自撰一函数,用之,堆栈溢出. <桃花庵--程序员版>写字楼里写字间,写字间中程序员: 程序人员写程序, 又将程序换酒钱: 酒醒只在屏前坐,酒醉还来屏下眠: 酒醉酒醒日

提高程序员职场价值的10大技巧

如果你已经是个很牛叉的程序员,但是依然觉得觉得还不够的话,欢迎阅读此文.本文旨在帮助各位更上一层楼. 你是不是觉得自己已经掌握了所有的编程技巧?别太自以为是了! 会写代码的确很重要,但是要拿到更好薪水,则更依赖于别人是否知道你的才能.换言之,你需要推销自己.下面是如何成功推销的秘诀. 开发技巧No. 1:博客 建立自己的博客,每月至少发布一篇文章.做点研究,因为只有自己亲身经历过,才能言之有物,不会听上去像吹牛皮.学会如何写文章,像以前你的老师教的那样:列大纲,描述情节,最后检查语法和错别字.然

看似简单!解读C#程序员最易犯的7大错误

编程时犯错是必然的,即使是一个很小的错误也可能会导致昂贵的代价,聪明的人善于从错误中汲取教训,尽量不再重复犯错,在这篇文章中,我将重点介绍C#开发人员最容易犯的7个错误. 格式化字符串 在C#编程中,字符串类型是最容易处理出错的地方,其代价往往也很昂贵,在.NET Framework中,字符串是一个不可变的类型,当一个字符串被修改后,总是创建一个新的副本,不会改变源字符串,大多数开发人员总是喜欢使用下面这样的方法格式化字符串: string updateQueryText = "UPDATE E