《Clean Code》函数

短小

短小是函数的第一规则,20行封顶最佳。
每个函数最好只做一件事情,一目了然最佳!

代码块

if语句,else语句,while语句等等,其中代码块最好只有一行。
这一行最好就是函数调用语句。保持函数短小,调用的函数具有说明性的名称,能增加文档上的价值。

只做一件事

编写函数是为了把大一些的概念拆分成为另一抽象层上的一系列步骤。

一个函数一个抽象层次

抽象层次越高,具体信息越少,但是概括能力越强;反之,具体信息越丰富,结果越确定,但相应的概括能力越弱。

所以代码需要有层次感。

switch语句的麻烦

在抽象层次比较低的时候,很难避免使用switch语句。
public Money calculatePay(Employee e) throw InvalidEmployeeType{
    switch (e.type){
        case COMMITSSIONED:
            return calculateCommissionedPay(e);
        case HOURLY:
            return calculateHourlyPay(e);
        case SALARIED;
            return calculateSalariedPay(e);
        default:
            throw new InvalidEmployeeType(e.type)
    }
}
//判断雇员种类,分别进入不同的方法。
问题:
1.代码长了
2.出现新的雇员时还要增加代码。
3.违反单一权责原则。
4.违反开放闭合原则。
5.也许还有其他根据不同雇员执行的方法,这会造成代码重复。

修改:将switch隐藏到抽象工厂下

public abstract class Employee{
    public abstract boolean isPayday();
    public abstract Money calculatePay();
    public abstract void deliverPay(Money pay);
}
----------------------------------------------------
public interface EmployeeFactory{
    public Employee makeEmployee(EmployeeRecord r) throw InvalidEmployeeType;
}
----------------------------------------------------
public class EmployeeFactoryImpl implements EmployeeFactory{
    public Employee makeEmployee(EmployeeRecord r) throw InvalidEmployeeType{
        switch (r.type){
            case COMMITSSIONED:
                return new CommissionedEmployee(r);
            case HOURLY:
                return new HourlyEmployee(r);
            case SALARIED;
                return SalariedEmployee(r);
            default:
                throw new InvalidEmployeeType(r.type)
        }
    }
}

函数的参数

最理想的是0参数 ,其次是一,再就是二,应该尽量避免三个参数。
如果有三个或者三个以上的参数,最好封装成类了。

使用异常替代返回错误码

if(deletePage(page) == E_OK){
    if(registry.deleteReference(page.name) == E_OK){
        if(configKeys.deleteKey(page.name.makeKey())==E_OK){
            logger.log("page deleted");
        }else{
            logger.log("configKey not deleted");
        }
    }
    else{
            logger.log("deleteReference from registry failed");
        }
}else{
    logger.log("deleted failed");
    return E_ERROR;
}

-----------------另一方面---------------------------
try{
    deletePage(page);
    registry.deleteReference(page.name);
    configKey.deleteKey(page.name.makeKey());
}catch(Exception e){
    logger.log(e.getMessage());
}

参照《Clean Code》第三章
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 219,869评论 6 508
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,716评论 3 396
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 166,223评论 0 357
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 59,047评论 1 295
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 68,089评论 6 395
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,839评论 1 308
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,516评论 3 420
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,410评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,920评论 1 319
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 38,052评论 3 340
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,179评论 1 352
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,868评论 5 346
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,522评论 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,070评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,186评论 1 272
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,487评论 3 375
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,162评论 2 356

推荐阅读更多精彩内容

  • 歇后语是汉语言中独有的语言表达方式、机智、幽默、滑稽、风趣、生动形象而又意味深长,不仅活在人们的口头上,而被老百...
    湖边人老刘阅读 2,728评论 0 3
  • 又到了季节交替的时候,烦人的过敏又开始了,这个时候要注意休息,饮食平衡,少吃高油高盐,多吃水果蔬菜。 唔,作为一只...
    繁华之处阅读 249评论 0 0
  • 不止一次的有过就这样吧,累到坚持不下去,直到把生命耗干为止的想法。不再发泄,不再喊叫,只是默默的忍受着,熬着。 一...
    卓子lonuo阅读 342评论 2 0