Clean Code

第一章 整洁代码

1、整洁代码只做好一件事
2、推崇小块代码
3、没有重复代码(有意义的命名+方法功能不要太多)
4、代码读的轻松,小规模抽象
5、明确才是王道

第二章 有意义的命名

1、命名要名副其实,尽量不要使用List,用Groups或者Accounts(名词复数形式)表示
2、名称长短应与其作用域大小相对应
3、类名和对象名应该是名词短语
4、方法名应该是动词短语
5、可以添加有意义的语境

第三章 函数

1、函数应该做一件事,做好这件事,只做这一件事。
2、每一个函数一个抽象层级。
3、switch 语句天生要做N件事,我们可以创建多态对象,而且隐藏在某个继承关系中。
if ... else if ... else if ... else等结构需要进行一层抽象,提取出公共接口,然后生成对象数组进行多态调用,将分支结构转化为循环结构)
4、函数参数最理想是零,当有三个及三个以上参数时,需要考虑是否将其中一些参数封装成类
5、向函数传入布尔值简直是骇人听闻,函数将不止做一件事,true时这样做,false时那样做。
6、使用异常代替返回错误码,避免更深层次的嵌套结构。
7、抽离Try/catch代码块,Try/catch代码块破坏原来代码结构,将错误处理和正常流程混为一谈,需要另外形成函数。(错误处理就是一件事
8、别重复自己

第四章 注释

1、尽量用代码而不用注释来阐述
2、注释可以是提供信息的注释,如正则表达式匹配字符
3、注释可以是对意图的解释
4、注释可以用来进行警告
5、//TODO注释放置要做的工作列表

第五章 格式

1、垂直格式,需要向报纸学习
2、垂直方向上的间隔可以很好的隔开概念
3、关系密切应该相互靠近,变量声明应尽可能靠近其使用位置
4、实体变量放置在类的顶部声明
5、相关函数应将其放置在一起,调用者应尽可能放在被调用者的上面;这样函数声明总会再其调用后很快出现
6、概念相关应该放在一起,相关性建立在直接依赖的基础上,如函数间调用或函数使用某个变量

第六章 对象与数据结构

1、使用数据结构代码便于在不改动既有的数据结构的前提下添加新函数,难以添加新的数据结构(必须修改所有函数);
使用面向对象代码便于在不改动既有函数的前提下添加新类,难以添加函数(必须修改所有类)。
2、对于面向对象较难的事,对于过程式代码却比较容易,反之亦然。
3、The Law of Demeter:

  • 模块不应了解它所操作对象的内部情形,**对象隐藏数据,暴露操作。
  • Handler类的方法f()只应该调用以下对象的方法:

Handler
f创建的对象
作为参数传递给f的对象
Handler的实体变量持有的对象

4、最为精炼的数据结构是只有一个公共变量、没有函数的类。这种数据结构被称为数据传送对象,DTO(Data Transfer Objects)
5、对象暴露行为,隐藏数据。

  • 便于添加新对象类型而无需修改既有行为,同时也难以在既有对象中添加新行为。
    数据结构。
    数据结构暴露数据,没有明显的行为。
  • 便于向既有数据结构添加新行为(新函数),同时也难以向既有函数添加新数据结构。

第七章 错误处理

1、使用不可控异常
2、依调用者需要定义异常类,需要考虑如何被捕获
3、将第三方API打包是个良好的时间手段
4、特例模式:创建一个类或配置一个对象,用来处理特例,可将异常行为封装到特例对象中
5、别返回null值,方法返回null可以抛出异常或者返回特例对象
6、别传递null
7、错误处理隔离看待,独立于主要逻辑,就能写出强固而整洁的代码

第八章 边界

1、建议不要将Map(或在边界上的其他接口)在系统中传递,如果使用类似Map的边界接口,就把他保留在类或者近亲类中。
2、学习log4j

第九章 单元测试

1、TDD三定律:

  • 定律一:在编写不能通过单元测试前,不可编写生产代码
  • 定律二:只可编写刚好无法通过的单元测试,不能编译也算不通过
  • 定律三:只可编写刚好足以通过当前失败测试的生产代码

2、F.I.R.S.T.:快速(fast)、独立(independence)、可重复(repeatable)、自足验证(self-validating)、及时(timely)

第十章 类

1、类应该短小,有单一权责原则(Single Responsibility Principle,SRP),类或模块应有且只有一条加以修改的理由。
2、如果一个类的每个变量都被每个方法所使用,则该类具有最大的内聚性。——内聚性高
3、如果函数想要共享某些变量,应该让他们拥有自己的类。故当类丧失内聚性时,就应该拆分类
4、通过降低连接度,就遵循了一条类设计原则——依赖倒置原则(Dependency Inversion Principe)。本质而言,DIP认为类应当依赖于抽象而不是依赖于具体的细节。(减少耦合)

第十一章 系统

1、软件系统应将起始过程与起始过程之后的运行逻辑分离开。
2、main函数创建系统所需的对象,在传递给应用程序,应用程序只管使用。依赖箭头都是从main函数向外走,这表明应用程序对main或者构造过程一无所知。
3、使用抽象工厂模式让应用程序自行控制何时创建对象,但构造细节却隔离于应用程序代码之外。
4、控制反转(Inversion of Control,IoC)将第二权责从对象中拿出来,转移到另一个专注于此的对象中,从而遵循了单一权责原则。
5、延后初始化的好处:

  • DI(Dependency Injection)容器在需要对象之前并不构造对象。
  • 许多这类容器提供调用工厂或构造代理的机制,而这种机制可为延迟赋值或类似的优化处理所用。

6、通过方面式的手段切分关注面,用测试驱动系统架构。

第十三章 并发编程

1、并发防御原则:

  • 单一权责原则(SRP):分离并发相关代码和其他代码。
  • 限制数据作用域:谨记数据封装,严格限制对可能被共享的数据的访问。
  • 使用数据复本:从多个线程收集所有复本的结果,并在单个线程中合并这些结果。
  • 线程应尽可能地独立:尝试架构数据分解到可被独立线程(可能在不同处理器上)操作的独立子集。

2、几种执行模型


基础定义
  • 生产者-消费者模型:生产者与消费者之间队列是一种限定资源。
  • 读者-作者模型:需提供合理的吞吐量
  • 宴席哲学家
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,711评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,079评论 3 387
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,194评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,089评论 1 286
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,197评论 6 385
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,306评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,338评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,119评论 0 269
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,541评论 1 306
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,846评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,014评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,694评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,322评论 3 318
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,026评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,257评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,863评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,895评论 2 351