离愁

悲莫悲兮生别离

代码整洁之道 函数

学习代码整洁之道,尽量提高代码的可读性。

对于函数的要求:

1、20行以内,缩进小于3层。

2、只做一件事情。

3、涉及的事情,要保持在一个抽象层级。

4、switch语句,要考虑是否可以用多态代替,对修改关闭,对扩展开放。

5、函数名使用描述性的名称,不要用简写,现在的编译器支持很长的字符串,用好动词与关键字。

经常出现的情况是:

1、函数很长,影响阅读。

2、处理多个事情,逻辑复杂,违反“单一权责”。

3、违反“开闭原则”。

4、函数名简写,意思不明确。


关于函数输入参数:(从简单到复杂的情况)

1、一元参数

2、二元参数

3、三元参数

参数越多,情况就越复杂,可以想象单元测试所需要的样本量与参数个数的关系。

标示参数:即输入参数为布尔型,光明正大的告诉别人,这个函数不只处理一个事情。

不要将输入参数,用作输出用途,譬如byte[],会引起理解上的混乱。


关于错误处理:

1、使用异常替代返回错误码,代码会变得简洁。

2、错误处理就是一件事。

3、对于新异常,可使用异常类派生的方法实现。


不要重复自己,即不要存在两份相同的代码片段。


完美的代码不是一开始就写成的,开始的代码都冗长而复杂,通过以下步骤:

1、分解函数。

2、修改名称。

3、消除重复。

这其中涉及缩短和重新安置方法,拆散类。在多次循环后,代码更趋向于完美。








阅读更多
版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/cluse/article/details/49914149
个人分类: 构架师
上一篇软件构架师12项修炼 3
下一篇代码整洁之道 注释与格式
想对作者说点什么? 我来说一句

[精品]代码整洁之道.epub

2018年01月02日 4.55MB 下载

没有更多推荐了,返回首页

关闭
关闭