第五章 只公开你要公开内容.pptVIP

只公开你要公开的内容; 作为API,如何公开内部的相关数据和结构，是涉及经验问题，怎样既要保证需要用的公开出去，同时把要隐含的信息隐含起来。 API公开的内容越少越好。 一般设计者认为：终究会有些人用得上这些功能，只要功夫深有人用，当然就要公开，这这是错的。 应该是有必要才公开 ;方法添加容易与移去难 设计者带来的问题往往远远多于其解决的问题。向API中添加一个新方法是很容易的一件事，但与此相反，想从API中移徐一个方法却非常困难。一个API对外提供的功能越多，那么为保持向后兼容性所做的工作也就越多。提供的功能越多留给具体实现的空间也就越少。如果API公开的不必要的内容越多，可改进的空间也就越少。 ;1 用例不具有说服力 2内部特性存在 对于API设计来说，其水平越差，所编写的API越会公开大量不必要的内容。这种设计方式没有任何规划，最终把相关的API给捣成一堆浆糊。 他们所写的API可能会被动他人误用。一个人设计的API长，他设计的API公开的内容就会越少。 ; 在发布API的第一个版本之前，将不必要时的内容从API中移走。每公开的一个API，意味着你对该API的用户做出了一个未来的兼容性承诺。最简单、有效的解决方法就是，一切都以用户为中心，但要逐步来满足他们的需求。 ;5.1 方法优于字段;1.类中的字段不公开;2.虚拟机;3.动态编译代码要比静态编译代码执行快;5.2 工厂方法优于构造函数;工厂方法支持参数化的返回类型（1）;工厂方法支持参数化的返回类型（2）;工厂方法支持参数化的返回类型（3）;5.3 让所有的内容都不可更改;各种使用方式;能不继承就不继承;5.4 避免滥用setter方法; 避免滥用setter方法; 5.5 尽可能通过友元的方式来开来公开功能;尽可能通过友元的方式来开来公开功能（2）;通过友元的方式来开来公开功能（3）;通过友元的方式来开来公开功能（4）;通过友元的方式来开来公开功能（5）;通过友元的方式来开来公开功能（6）;5.6 赋予对象创建者更多权利;赋予对象创建者更多权利（2）;赋予对象创建者更多权利（3）;赋予对象创建者更多权利（3）;赋予对象创建者更多权利（4）;赋予对象创建者更多权利（4） Public static Excutor creat(Configuration config) { Return new Fair(config);} Public static final class Configuration { Boolean fair; Int maxWaiters=-1; Public void setFair(Boolean fair) {This.fair=fair; } Public void setMaxWaiters(int max) { This.maxWaiters=max;}} Lock.enterReadAccess(); Try　｛Do the operation } finally { Lock.exitReadAccess();｝ ;赋予对象创建者更多权利（5） 一些恶意代码会故意不释放锁，这样会因为这个锁而打破整个子系统的一致性。 最好的处理方式则是利用两个类：一个类为对象的创建者提供高级权限，而另一个则提供公开的API，供任何人调用。 ;5.7 避免暴露深层次继承(1) 调用一个方法时并不见得是固定要调用哪一段代码，很可能是根据具体情况在多个具体实现中选择某一个方法的实现代码执行。 直接将深层次的继承体系公开出来并不能提高API的可用性。要注意“继承”不是用来改变具体的行为，而是用来添加一些额外的行为。 ;5.7 避免暴露深层次继承(2) 面向对象语言中一个常见的API缺陷。如去继承一个类，为了切换某些方法的执行路径，这种做法是应该避免的。避免深层次继承，定义程序接口，并让用户来实现这些接口。类继承了某个类或者实现了某个接口，那么就可以作为相应的类和接口被使用。 Frame之所以继承自Component,完全出于实现该类的代码比较方便，只想复用Component类中的一部分代码。面向对象的复用，更应该称为误用，一旦发现继承体系超过两层时，一定要打住。