代码整洁之道

Description

书签已装载， 书签制作方法请找 [email protected] 完全免费 软件质量，不但依赖于架构及项目管理，而且与代码质量紧密相关。这一点，无论是敏捷开发流派还是传统开发流派，都不得不承认。 本书提出一种观念：代码质量与其整洁度成正比。干净的代码，既在质量上较为可靠，也为后期维护、升级奠定了良好基础。作为编程领域的佼佼者，本书作者给出了一系列行之有效的整洁代码操作实践。这些实践在本书中体现为一条条规则（或称“启示”），并辅以来自现实项目的正、反两面的范例。只要遵循这些规则，就能编写出干净的代码，从而有效提升代码质量。 本书阅读对象为一切有志于改善代码质量的程序员及技术经理。书中介绍的规则均来自作者多年的实践经验，涵盖从命名到重构的多个编程方面，虽为一“家”之言，然诚有可资借鉴的价值。 封面 书名 版权 前言 目录 第1章 整洁代码 1.1要有代码 1.2糟糕的代码 1.3混乱的代价 1.3.1华丽新设计 1.3.2态度 1.3.3迷题 1.3.4整洁代码的艺术 1.3.5什么是整洁代码 1.4思想流派 1.5我们是作者 1.6童子军军规 1.7前传与原则 1.8小结 1.9文献 第2章 有意义的命名 2.1介绍 2.2名副其实 2.3避免误导 2.4做有意义的区分 2.5使用读得出来的名称 2.6使用可搜索的名称 2.7避免使用编码 2.7.1匈牙利语标记法 2.7.2成员前缀 2.7.3接口和实现 2.8避免思维映射 2.9类名 2.10方法名 2.11别扮可爱 2.12每个概念对应一个词 2.13别用双关语 2.14使用解决方案领域名称 2.15 使用源自所涉问题领域的名称 2.16添加有意义的语境 2.17不要添加没用的语境 2.18最后的话 第3章 函数 3.1短小 3.2只做一件事 3.3每个函数一个抽象层级 3.4 switch语句 3.5使用描述性的名称 3.6函数参数 3.6.1一元函数的普遍形式 3.6.2标识参数 3.6.3二元函数 3.6.4三元函数 3.6.5参数对象 3.6.6参数列表 3.6.7动词与关键字 3.7无副作用 3.8分隔指令与询问 3.9使用异常替代返回错误码 3.9.1抽离Try/Catch代码块 3.9.2错误处理就是一件事 3.9.3 Error.java依赖磁铁 3.10别重复自己 3.11结构化编程 3.12如何写出这样的函数 3.13小结 3.14 SetupTeardownIncluder程序 3.15 文献 第4章 注释 4.1注释不能美化糟糕的代码 4.2用代码来阐述 4.3好注释 4.3.1法律信息 4.3.2提供信息的注释 4.3.3对意图的解释 4.3.4阐释 4.3.5警示 4.3.6 TODO注释 4.3.7放大 4.3.8公共API中的Javadoc 4.4坏注释 4.4.1喃喃自语 4.4.2多余的注释 4.4.3误导性注释 4.4.4循规式注释 4.4.5日志式注释 4.4.6废话注释 4.4.7可怕的废话 4.4.8能用函数或变量时就别用注释 4.4.9位置标记 4.4.10括号后面的注释 4.4.11归属与署名 4.4.12注释掉的代码 4.4.13 HTML注释 4.4.14非本地信息 4.4.15 信息过多 4.4.16不明显的联系 4.4.17函数头 4.4.18非公共代码中的Javadoc 4.4.19范例 4.5文献 第5章 格式 5.1格式的目的 5.2垂直格式 5.2.1向报纸学习 5.2.2概念间垂直方向上的区隔 5.2.3垂直方向上的靠近 5.2.4垂直距离 5.2.5垂直顺序 5.3横向格式 5.3.1水平方向上的区隔与靠近 5.3.2水平对齐 5.3.3缩进 5.3.4空范围 5.4团队规则 5.5鲍勃大叔的格式规则 第6章 对象和数据结构 6.1数据抽象 6.2数据、对象的反对称性 6.3得墨忒耳律 6.3.1火车失事 6.3.2 混杂 6.3.3隐藏结构 6.4数据传送对象 6.5小结 6.6文献 第7章 错误处理 7.1使用异常而非返回码 7.2先写Try-Catch-Finally语句 7.3使用不可控异常 7.4给出异常发生的环境说明 7.5依调用者需要定义异常类 7.6定义常规流程 7.7别返回null值 7.8别传递null值 7.9小结 7.10文献 第8章 边界 8.1使用第三方代码 8.2浏览和学习边界 8.3学习log4j 8.4学习性测试的好处不只是免费 8.5使用尚不存在的代码 8.6整洁的边界 8.7文献 第9章 单元测试 9.1 TDD三定律 9.2保持测试整洁 9.3整洁的测试 9.3.1面向特定领域的测试语言 9.3.2双重标准 9.4每个测试一个断言 9.5 F.I.R.S.T 9.6小结 9.7文献 第10章类 10.1类的组织 10.2类应该短小 10.2.1单一权责原则 10.2.2内聚 10.2.3保持内聚性就会得到许多短小的类 10.3为了修改而组织 10.4文献 第11章 系统 11.1如何建造一个城市 11.2将系统的构造与使用分开 11.2.1分解main 11.2.2工厂 11.2.3依赖注入 11.3扩容 11.4 Java代理 11.5纯Java AOP框架 11.6 AspectJ的方面 11.7测试驱动系统架构 11.8优化决策 11.9明智使用添加了可论证价值的标准 11.10系统需要领域特定语言 11.11小结 1112文献 第12章 迭进 12.1通过迭进设计达到整洁目的 12.2简单设计规则1：运行所有测试 12.3简单设计规则2～4：重构 12.4不可重复 12.5表达力 12.6尽可能少的类和方法 12.7小结 12.8文献 第13章 并发编程 13.1为什么要并发 13.2挑战 13.3并发防御原则 13.3.1单一权责原则 13.3.2推论：限制数据作用域 13.3.3推论：使用数据复本 13.3.4推论：线程应尽可能地独立 13.4了解Java库 13.5了解执行模型 13.5.1生产者-消费者模型 13.5.2读者-作者模型 13.5.3宴席哲学家 13.6警惕同步方法之间的依赖 13.7保持同步区域微小 13.8很难编写正确的关闭代码 13.9测试线程代码 13.9.1将伪失败看作可能的线程问题 13.9.2先使非线程代码可工作 13.9.3编写可插拔的线程代码 13.9.4编写可调整的线程代码 13.9.5运行多于处理器数量的线程 13.9.6在不同平台上运行 13.9.7装置试错代码 13.9.8硬编码 13.9.9自动化 13.10小结 13.11文献 第14章 逐步改进 14.1 Args的实现 14.2 Args：草稿 14.2.1所以我暂停了 14.2.2渐进 14.3字符串参数 14.4小结 第15章JUnit内幕 15.1 JUnit框架 15.2小结 第16章 重构SerialDate 16.1首先让它能工作 16.2让它做对 16.3小结 16.4文献 第17章 味道与启发 17.1注释 17.2环境 17.3函数 17.4一般性问题 17.5 Java 17.6名称 17.7测试 17.8小结 17.9文献 附录A并发编程Ⅱ A.1客户端／服务器的例子 A.1.1服务器 A.1.2添加线程代码 A.1.3观察服务器端 A.1.4小结 A.2执行的可能路径 A.2.1路径数量 A.2.2深入挖掘 A.2.3小结 A.3了解类库 A.3.1 Executor框架 A.3.2非锁定的解决方案 A.3.3非线程安全类 A.4方法之间的依赖可能破坏并发代码 A.4.1容忍错误 A.4.2基于客户代码的锁定 A.4.3基于服务端的锁定 A.5提升吞吐量 A.5.1单线程条件下的吞吐量 A.5.2多线程条件下的吞吐量 A.6死锁 A.6.1互斥 A.6.2上锁及等待 A.6.3无抢先机制 A.6.4循环等待 A.6.5不互斥 A.6.6不上锁及等待 A.6.7满足抢先机制 A.6.8不做循环等待 A.7测试多线程代码 A.8测试线程代码的工具支持 A.9小结 A.10教程：完整代码范例 A.10.1客户端／服务器非线程代码 A.10.2使用线程的客户端／服务器代码 附录B org.jfree.date.SerialDate 结束语