1. 多走半里路
很多事情并不难,只是缺乏多走半里路的习惯!
反例:
public boolean isInValid(String str) {
if (str == null || str.trim().length() == 0) {
return true;
}
return false;
}
多走一步,海阔天空。
public boolean isInValid(String str) {
return (str == null) || (str.trim().length() == 0);
}
<typo id="typo-290" data-origin="是个" ignoretag="true">是个</typo>程序员都知道哪个更好!
还有一种见过很多次的代码:
public boolean isEmptyName() {
return StringUtils.isEmpty(name)? true: false;
}
难道不感觉到多余吗?
再走半步,山清水秀。
public boolean isEmptyName() {
return StringUtils.isEmpty(name);
}
2. 空对象
NullPointException,让我们防不胜防;尤其是使用第三方 API,如果抛出这个异常,会让人有骂街的冲动。所以:若不想踩坑,请先别给别人挖坑。
理想要求:我们生产的所有 public 带返回值的方法体中,不应该出现“return null”字样。空对象就是这一思想的落地实现。
案例:查询并返回一个名字为 steven 的老师或者学生。
public static SearchFilter name(String name) {
return human -> human.getName().equalsIgnoreCase(name);
}
public Human find(SearchFilter filter) {
for (Human human : humans) {
if (filter.isMatched(human)) {
return human;
}
}
return new NullHuman(); //如果你返回NULL,总有一天你会挨骂!
}
//Test
assertFalse(edu.find(name("steven")).isNull());
3. 单实例情结
谈起设计模式,很多人会觉得高大上,于是当学会了其中一个时,便会不加节制地使用。
单例,GOF 中最简单的一个设计模式,很好用,也非常方便,但说实话很多人在滥用。我们的系统中随处可见,但用前请叩问自己该类真的是在系统当中有并且只能有一个实例吗?
否则请拒绝单实例。太多的单实例会给你的自动化测试带来无穷的烦恼。
4. 充分使用枚举
枚举有一些比较强大的特性容易被忽视,比如枚举对象本身也可以携带变量。这一特性让枚举在更多的场合发挥不可替代的功用。
举例:不同武器具有不同的杀伤力,杀伤力变量可以携带到武器的枚举值中。
public enum EquipmentEnum {
Staff(20), Hammer(10);
double playerRisedAbility;
EquipmentEnum(double playerRiseAbility) {
this.playerRisedAbility = playerRiseAbility;
}
public double getRaiseAbility(double originalAbility) {
return Double.sum(originalAbility, playerRisedAbility);
}
}
5. 提高注释质量
30% 的代码注释比的时代已经成为过去,最好的注释的就是无需注释,程序员应该致力于通过命名让注释消失。
大量的实践证明,随着重构频率越来越高,重构过程中随着代码的变更同步更新注释的可能性几乎为零。久而久之,注释与代码就是南辕北辙。
6. 面向客户的命名
好的命名能够愉悦读者的心情,让人有想一睹作者真面目的冲动!
案例:
一个房地产开发商一个新的楼盘开盘,原价 80 万每套,有如下优惠策略,但优惠政策可能随着楼盘存量情况会不一样,为开发商写一个房款计算程序:
老客户买二套房可优惠 4%,可累加;
一次性全款客户可优惠 3%,可累加。
public class Customer {
Benefiter benefit = new NullBenefiter();
public void is(Benefiter benefits) { //原本的set方法,重命名会带来意想不到的效果。
this.benefit = benefits;
}
public double shouldPay(double srcPrice) {
return srcPrice - benefit.benefit(srcPrice);
}
}
@FunctionalInterface
public interface Benefiter {
abstract double benefit(double srcPrice);
default Benefiter and(final Benefiter otherPolicy) {
return srcPrice -> (benefit(srcPrice) + otherPolicy.benefit(srcPrice));
}
}
受益于良好命名,客户代码语义跃然纸上:customer.is(oldCustomer().and(fullPay()));
7. 使用多维数组
数组是任何一门相对高级的机器语言的必备数据结构,但是对面向对象开发人员而言,似乎对它有所忽略。
在一些特定的场景下,它能起到意想不到的效果。
案例:美元、法郎、人民币三币种间换算。其中美元:法郎=1:2;美元:人民币=1:8。
public class ExchangeRate {
public static final int DOLLAR = 0;
public static final int FRANC = 1;
public static final int YMB = 2;
private static final double[][] rates = { //二维数组定义币种之间的汇率,简单高效
{1.0d, 2.0d, 8.0d},
{0.5d, 1.0d, 4.0d},
{0.125d, 0.25d, 1.0d}
};
public static double getRateOf(Currency src, Currency tgt) {
return rates[src.ID][tgt.ID];
}
}
public class Cash {
private double value;
private Currency unit;
public Cash(double value, Currency unit) {
this.value = value;
this.unit = unit;
}
@Override
public boolean equals(Object obj) {
if (obj instanceof Cash) {
Cash other = (Cash) obj;
return value == other.value * getRateOf(other.unit, unit);
}
return false;
}
}
如果汇率的二维数组使用配置文件定义并初始化,那还可以将设计提升一个新的高度——易于扩展,甚至不需修改任何 Java 代码即可完成币种的扩展。
8. 规约函数入参
当我们调用外部 API 时,最理想的就是零入参,即便有入参也希望是类型明确且范围可枚举的,这样会让我们使用这个 API 时更具安全感!心同此理,当你把一个函数声明为 public 时,请谨慎地定义它的入参。
如果<typo id="typo-3735" data-origin="把" ignoretag="true">把</typo>上述案例中获取两种币种之间的汇率函数:
public static double getRateOf(Currency src, Currency tgt) {
return rates[src.ID][tgt.ID];
}
定义为:
public static double getRateOf(int src, int tgt) {
return rates[src][tgt];
}
虽然函数实现简单了一些,但可想而知,这个 API 会让使用者很忌惮!数组越界异常肯定是经常发生。
相反通过枚举规约了入参的类型和范围,给用户一些固定选项,使用者少了很多顾虑,而我们的程序也更加安全。
所以:我们对外提供的 API 入参类型尽量少用 String、Int 这种基本类型,给使用者发挥的空间越大,犯错的可能越大,因为你把风险暴露在不受控的用户手里。
9. 经常进行封装去重
你是否为反复地编写类似“if (tasks != null && tasks.size() > 0)”或者“if (name != null && (!name.isEmpty()))”的代码而心浮气躁,其实你完全可以解救自己。
封装一下:
public class CollectionUtil {
public static boolean isEmpty(Collection collection) {
return collection == null || collection.isEmpty();
}
}
以及:
public class StringUtil {
public static boolean isEmpty(String context) {
return context == null || context.isEmpty();
}
}
一切变得非常简单,心情好了,效率也就高了!
10. 化解 if/else 的毒素
我们的系统充斥着 if/else 的逻辑,因为它逻辑“简单”、易用!但随着时间推移、需求的扩展,有一天你会发现自己都看不懂自己写的 if/else。
所以一开始就要学会拒绝这种逻辑的嵌套,又或者是当你看嵌套的复杂逻辑,大胆地对它进行重构。
案例:输入一个 1-1000 的数值 N,如果 N 是 3 或者 3 的倍数时,返回“FIZZ”;如果 N 是 5 或者 5 的倍数时, 返回“BUZZ”;既是 3 的倍数又是 5 的倍数时, 返回“FIZZBUZZ”;其他的则输出 N。
原实现:披着对象外壳的面向过程代码。
public String say(int input) throws Exception {
if ( input < 1 || input > 1000){
throw new Exception("Invalid input");
}
if (input % 15 == 0) {
return "FIZZBUZZ";
}
if (input % 5 == 0) {
return "BUZZ";
}
if (input % 3 == 0) {
return "FIZZ";
}
return String.valueOf(input);
}
嗅一嗅其中的<typo id="typo-5231" data-origin="坏" ignoretag="true">坏</typo>味道,如果将来需求扩展,比如引进 7 的倍数。照此逻辑,继续添加 if,问题是解决了,但总有一天你会怀疑人生!
改进一:引入责任链和模板方法模式。
public String say(int input) throws Exception {
if (input < 1 || input > 1000) {
throw new Exception("Invalid input");
}
DefaultParser defaultParser = new DefaultParser(null);
MultiOfThreeParser multiOfThreeParser = new MultiOfThreeParser(defaultParser);
MultiOfFiveParser multiFiveParser = new MultiOfFiveParser(multiOfThreeParser);
MultiOfFifteenParser fifteenPaser = new MultiOfFifteenParser(multiFiveParser);
return fifteenPaser.parse(input);
}
public abstract class Parser {
abstract boolean isFixedResponsibility(int inputContext);
abstract String response(int inputContext) throws Exception;
public String parse(int inputContext) throws Exception {
if (isFixedResponsibility(inputContext)) {
return response(inputContext);
}
if (nextParser != null) {
return nextParser.parse(inputContext);
}
return NULL;
}
}
public class MultiOfFifteenParser extends Parser {
public MultiOfFifteenParser(Parser nextParser) {
super(nextParser);
}
@Override
public String response(int inputContext) throws Exception {
return FLAG_FOR_MULIT_OF_FIFTEEN;
}
@Override
boolean isFixedResponsibility(int inputContext) {
return inputContext % 15 == 0;
}
}
看起来好多了,但感觉好像还有哪儿不太对劲!
改进二:彻底穿上对象的外袍。
敏锐的读者可能还会发现上述改进还存在细微的小问题,那就是 say 方法里面的异常分支处理。怎么还存在一个 if,对于一个完美主义强迫症患者而言,它的存在就是一个灾难。继续改进一下
public String say(int input) throws Exception {
DefaultParser defaultParser = new DefaultParser(null);
MultiOfThreeParser multiOfThreeParser = new MultiOfThreeParser(defaultParser);
MultiOfFiveParser multiOfFiveParser = new MultiOfFiveParser(multiOfThreeParser);
MultiOfFifteenParser FifteenPaser = new MultiOfFifteenParser(multiOfFiveParser);
InvalidNumberParser invalidNumberPaser = new InvalidNumberParser(FifteenPaser);
return invalidNumberPaser.parse(input);
}
public class InvalidNumberParser extends Parser {
public InvalidNumberParser(Parser nextParser) {
super(nextParser);
}
@Override
String response(int inputContext) throws Exception {
throw new Exception("Invalid input");
}
@Override
boolean isFixedResponsibility(int inputContext){
return (inputContext < L_THRESHOLD) || (inputContext > H_THRESHOLD);
}
}
OK, Perfect!