3.代码整洁之道之函数的规范性
1.函数要短小
函数我们也称之为方法,如果一个方法体的内容相当庞大的话,当别人看你的代码时候,要花费非常长的时间才能理解你所要表达的意思。
2.函数要尽量只做一件事情
一个函数,要尽量只专注于一件事。例如,德玛对战提莫,当德玛对提莫发起攻击时,将整个攻击过程转化为一个函数,攻击中的细节由另一个函数调用。如下:
/**
* 德玛对提莫发起了攻击
*/
public void attack(){
attackDetail();
}
/**
* 发起攻击的细节
*/
public void attackDetail(){
//释放R技能...
}
3.避免用标识符进行传参
要避免用标识符进行参数的传递,如传递一个参数true 或者 false,这就说明了该函数肯定要做多件事。(避免的方法还未找到对应的代码,有待研究,常常使用到)。
4.函数的形参个数
函数的形参个数为一个最佳,因为我们常常需要判断传过来的参数是否是合法的,当有两个或三个以上的参数时,我们往往应当先考虑是否可以转化成对象进行传参。
5.try/catch中尽量将try中的代码块进行抽离
书中讲到,try/catch代码块往往会弄乱代码原本的结构,将try中的代码块进行抽离的话,我们只需要看抽离出来的方法所表达的是什么,就可以将原本的try/catch忽略,完美的分离了两个部分。如下例:
protected ResultSetType resolveResultSetType(String alias) {
if (alias == null) {
return null;
} else {
try {
return ResultSetType.valueOf(alias);
} catch (IllegalArgumentException var3) {
throw new BuilderException("Error resolving ResultSetType. Cause: " + var3, var3);
}
}
}