Java程序员必备奇淫巧技篇（上）

前言

前面我们讲了Java编程过程中的命名和注释、代码风格，今天我们来讲一些比较实用的Java编程技巧，帮你切实地提高代码可读性。这部分技巧比较琐碎，也很难罗列全面，我仅仅总结了一些我认为比较关键的，更多的技巧需要你在实践中自己慢慢总结、积累。

1. 把代码分割成更小的单元块

大部分人阅读代码的习惯都是，先看整体再看细节。所以，我们要有模块化和抽象思维，善于将大块的复杂逻辑提炼成类或者函数，屏蔽掉细节，让阅读代码的人不至于迷失在细节中，这样能极大地提高代码的可读性。不过，只有代码逻辑比较复杂的时候，我们其实才建议提炼类或者函数。毕竟如果提炼出的函数只包含两三行代码，在阅读代码的时候，还得跳过去看一下，这样反倒增加了阅读成本。

这里我举一个例子来进一步解释一下。代码具体如下所示。重构前，在 invest () 函数中，最开始的那段关于时间处理的代码，是不是很难看懂？重构之后，我们将这部分逻辑抽象成一个函数，并且命名为 isLastDayOfMonth，从名字就能清晰地了解它的功能，判断今天是不是当月的最后一天。这里，我们就是通过将复杂的逻辑代码提炼成函数，大大提高了代码的可读性。

// 重构前的代码public void invest(long userId, long financialProductId) {Calendar calendar = Calendar.getInstance();calendar.setTime(date);calendar.set(Calendar.DATE, (calendar.get(Calendar.DATE) + 1));if (calendar.get(Calendar.DAY_OF_MONTH) == 1) {    return;}//...}// 重构后的代码：提炼函数之后逻辑更加清晰public void invest(long userId, long financialProductId) {if (isLastDayOfMonth(new Date())) {    return;}//...}public boolean isLastDayOfMonth(Date date) {Calendar calendar = Calendar.getInstance();calendar.setTime(date);calendar.set(Calendar.DATE, (calendar.get(Calendar.DATE) + 1));if (calendar.get(Calendar.DAY_OF_MONTH) == 1) {return true;}return false;}

2. 避免函数参数过多

我个人觉得，函数包含 3、4 个参数的时候还是能接受的，大于等于 5 个的时候，我们就觉得参数有点过多了，会影响到代码的可读性，使用起来也不方便。针对参数过多的情况，一般有 2 种处理方法。

考虑函数是否职责单一，是否能通过拆分成多个函数的方式来减少参数。示例代码如下所示：

public void getUser(String username, String telephone, String email);// 拆分成多个函数public void getUserByUsername(String username);public void getUserByTelephone(String telephone);public void getUserByEmail(String email);

将函数的参数封装成对象。示例代码如下所示：


// 将参数封装成对象public class Blog {title: 33-改善代码质量的20条编程规范private String summary;private String keywords;private Strint content;private String category;private long authorId;}public void postBlog(Blog blog);

除此之外，如果函数是对外暴露的远程接口，将参数封装成对象，还可以提高接口的兼容性。在往接口中添加新的参数的时候，老的远程接口调用者有可能就不需要修改代码来兼容新的接口了。

3. 勿用函数参数来控制逻辑

不要在函数中使用布尔类型的标识参数来控制内部逻辑，true 的时候走这块逻辑，false 的时候走另一块逻辑。这明显违背了单一职责原则和接口隔离原则。我建议将其拆成两个函数，可读性上也要更好。我举个例子来说明一下。

public void buyCourse(long userId, long courseId, boolean isVip);// 将其拆分成两个函数public void buyCourse(long userId, long courseId);public void buyCourseForVip(long userId, long courseId);不过，如果函数是 private 私有函数，影响范围有限，或者拆分之后的两个函数经常同时被调用，我们可以酌情考虑保留标识参数。示例代码如下所示：// 拆分成两个函数的调用方式boolean isVip = false;//... 省略其他逻辑...if (isVip) {buyCourseForVip(userId, courseId);} else {buyCourse(userId, courseId);}// 保留标识参数的调用方式更加简洁boolean isVip = false;//... 省略其他逻辑...buyCourse(userId, courseId, isVip);

除了布尔类型作为标识参数来控制逻辑的情况外，还有一种 “根据参数是否为 null” 来控制逻辑的情况。针对这种情况，我们也应该将其拆分成多个函数。拆分之后的函数职责更明确，不容易用错。具体代码示例如下所示：

public List<Transaction> selectTransactions(Long userId, Date startDate, Date endDate) {if (startDate != null && endDate != null) {    // 查询两个时间区间的 transactions}if (startDate != null && endDate == null) {    // 查询 startDate 之后的所有 transactions}if (startDate == null && endDate != null) {    // 查询 endDate 之前的所有 transactions}if (startDate == null && endDate == null) {    // 查询所有的 transactions}}// 拆分成多个 public 函数，更加清晰、易用public List<Transaction> selectTransactionsBetween(Long userId, Date startDate, Date endDate) {return selectTransactions(userId, startDate, endDate);}public List<Transaction> selectTransactionsStartWith(Long userId, Date startDate) {return selectTransactions(userId, startDate, null);}public List<Transaction> selectTransactionsEndWith(Long userId, Date endDate) {return selectTransactions(userId, null, endDate);}public List<Transaction> selectAllTransactions(Long userId) {return selectTransactions(userId, null, null);}private List<Transaction> selectTransactions(Long userId, Date startDate, Date endDate) {// ...}

更多原创阅读：https://javawu.com