《代码整洁之道》--第八章 边界

第八章边界 在软件开发的过程中，难免会引入第三方程序包或者是开源代码，然后整合进自己的项目代码中。这一章主要从引入第三方程序或者开源代码入手，介绍一些保持软件边界整洁的实践手段和技巧。 8.1使用第三方代码 　　接口提供者和使用者之间，存在与生俱来的矛盾。第三方程序包和框架提供者追求普适性，这样就能在多个环境中工作，吸引广泛的用户。而使用者则想要获得满足特定需求的接口。...

在开发系统过程中，我们总是需要购买第三方或使用开发源代码，有时我们也会依赖公司其他团队的组件或者子系统，不管哪种情况，我们都需要处理好本系统和第三方之间的边界问题，本章主要介绍一些保持软件边界整洁的实践手段和技巧。 1.使用第三方代码 在接口提供者和使用者之间，存在与生俱来的张力，接口提供者追求普适应，而接口使用者追求特定需求的满足，两者之间的矛盾就是导致系统边界的问题根本原因，以Map为例，Map提供了丰富的函数，可以对映射图中的数据进行灵活的操作，但是如果Map的使用场景只想来进行数据的存取，但是在

所谓的“边界”是指外来代码和自己写的代码之间进行整合的连接区域，自身项目调用外来代码以及外来代码提供的功能，这两部分代码就是边界。如果干净利落的将这些代码整合，就能保持软件边界的整洁。 1.使用第三方代码 第三方和框架提供者追求通用性，这样就能在多个环境下工作，吸引更多的用户。而使用者则想要集中满足特定需求的接口，这样方便开发需求。正是因为服务提供者和使用者的目标的差异，导致了在系统边界上可能会出现问题。 2.使用尚不存在的代码 协同开发过程中经常会碰到代码调用的API还...

　　我们内部每周都有读书会，最近在读《clean code》，基本上是20分钟左右。总体原则是大家轮流来讲。 我自己也领了其中一章，第八章。这一张特别不巧，书少了3页。整个一章少了一半的内容。于是我自己发挥了一下，希望大家能有所收获。   从接口到类、工程、系统、框架。在做设计的时候关于边界的基本思路是一致的。就是需要在普适性和集中性中做一个权衡。权衡的结果直接就影响着边界。 边界的目的是要...

外来代码： 购买的第三方程序包； 开源代码； 公司其他团队打造组件或子系统。 不管哪种情况，我们都得将外来代码干净利落地整合进自己的代码中。即保持软件边界整洁的实践手段和技巧。8.1 使用第三方代码接口提供者和使用者之间的关系： 第三方程序包和框架提供者追求普适性； 使用者则想要集中满足特定需求的接口。

Robert C.Martin 著 第1章 专业主义 1.1 清楚你要什么 专业主义：它不但象征着荣誉与骄傲，而且明确意味着责任义务与担当。 1.3 首先，不行损害之事 1.3.1 不要破坏软件功能 写一些随时都能运行的单元测试，然后尽可能多地执行这些测试。测试覆盖率尽可能为100%。 1.3.2 不要破坏结构 结构良好的代码更灵活。以牺牲结构为代价，得不偿失，将来必追悔莫及。 如果希望自己的软...

  一、重构定义： 在不改变软件可观察行为的前提下，对软件内部进行调整(使用重构手法)，以提高其可理解性，降低其修改成本。 -- 重点在两点： 1. 不改变软件的可观察行为。2. 提高其可理解性。 两个目的：1. 添加新功能。 2. 重构。 --重构就只管修改程序结构，不要添加新功能。 添加新功能就不要修改既有代码。两者混合进行会使得程序朝不可理解的方向发展。 ps: 重构与设计模式具有辩...

我们对他不了解，而且他们的开发者还没有将接口定义出来，为了不被这种事情阻碍到，我们就要做一些事情。无论如何我们都得学习要使用的API,而编写测试则是获得这些知识的容易而不会影响其他工作的途径。学习性的测试是一种精确试验，帮助我们增进对API的理解。边界上的代码需要清晰的分割和定义了期望的测试。应该避免我们的代码过多地了解第三方代码中的特定信息。依靠你能控制的东西，好过依靠你控制不了的东西，免得日后受它控制。这样的代码就不简洁了。在系统中不受限制的传递Map，当Map的接口被修改时，也有许多地方需要修改。

第八章 边界 我们很少能控制系统中的全部软件，有时用的第三方或者开源代码，有时用我们公司其他人打造的组件或者子系统，无论哪种情况，我们都得将外来的代码干净利落地整合进自己的代码中 8.1 使用第三方代码 第三方API的作者追求普适性，吸引广泛的用户。使用者想要集中满足特定的需求，这两者有一种张力，会导致系统边界上出问题 作者举了一个例子： // 这段代码不太整洁，而且没说明自己的用途 Map sensors = new HashMap(); Sensor s = (Sensor)senso

待完善…

阅读本文有两种原因：第一，你是个程序员；第二，你想成为更好的程序员。你如果想成为更好的程序员，那就请细细品味文章内容，它绝不会让你失望。

这一章书中全是理论性的东西，再加上中文翻译肯定有词不达意的地方（并未有意冒犯译者，sry），初读起来并没有理解，遂仔细思考后又读了两遍才敢总结。 作者在本章提到“边界”的概念，我个人的理解是：使用外部代码（第三方库提供的API、或者其他模块的服务）与自身项目代码结合的时候，自身项目调用外来代码以及外来代码提供的功能，这两部分代码就是边界。如果干净利落的将这些代码整合，就能保持软件边界的整洁。 一、使用第三方代码（良好的实践范例） 第三方jar包和框架提供者追求通用性，这样就能在多个环境下工作，吸引更多的用户

Sensor类对象的Map的映射代码如下： Map sensors = new HashMap (); 当代码的其他部分访问这些sensors，就会出现以下代码： Sensors s = (Sensors)sensors.get(sensorId); 这行代码一再出现。代码的调用端承担了从Map中取得对象并将其转换为正确类型的责任。行是行，却并非整洁的代码。而且，这行代码并未说...

保持边界整洁，可以避免我们的代码过多依赖第三方程序的内部实现细节，减少第三方程序对我们代码的入侵程度，尽可能降低因第三方程序修改而对我们代码产生的影响。

所谓的“边界”是指外来代码（三方程序包、开放源代码、其他团队打造的组件和子系统）和自己写的代码之间进行整合的连接区域 1.使用第三方代码 1.第三方程序包和框架提供者追求普适性，这样就能在多个环境中工作，吸引广泛的用户。 2.我们建议不要将Map（或在边界上的其他接口）在系统中传递，把它保留在类或近亲类中，避免从API中返回边界接口，或将接口作为参数传递给公共API。 比如应用程序可能构造一个map对象并传递它。我们的初衷可能是map对象的所有接收者都不要删除映射图中的任何东西。但map正好有一个clea

1、使用第三方代码，把边界接口保留在类或近亲类中。避免从公共API中返回边界接口，或将边界接口作为参数传递给公共API。 2、浏览和学习边界，不要在生产代码中试验新东西，而是编写测试来遍览和理解第三方代码。Jim Newkirk把这个叫做学习性测试。 3、学习性测试的好处不只是免费，能帮助我们增进对API的理解；看看程序包的行为有没有改变；快速发现能不能兼容新版本。 4、使用尚不存...