第七章与其他API协作.pptVIP

7.2 只暴露抽象内容（2） Public Class MYdatabase Private Function GET_TABLE(ByRef STR1 As String, ByVal STR2 As String) As String Public Function NEWS() As Boolean Public Sub OPEN(ByVal psqlstr As String) Public Sub OPEN(ByVal PTABLE As String, ByVal PEXP As String) Private Sub SetDataRow(ByVal i As Int16, ByVal value As Object) Private Sub Set_Value(ByVal i As Integer, ByVal value As Object) Public Sub UPDATE_data(ByVal pname As String, ByVal pvalue As Object) Public Function GET_data(ByVal pname As String) As DataRow Private Sub SetCommandString(ByVal i As Int16) Private Sub SetCommandSql(ByVal i As Int16, ByVal value As String, ByVal bs As String) Public Function SAVE() As Boolean End Class 7.5 避免API的错误 API不仅仅是类、接口加上Javadoc这样简单的组合。所有这些层次之间都需要保持一致性。一个API不能在某个层面说能够完成某种功能，然后一转眼又在另一个层面说，根本不支持这个功能。 如果不想在不同层面上都做到一致性，那么不要保证使用类库时所有的内容都要正确输入正确，而且执行的时候，相关的函数都要运行正确。 运行的功能多少符合开始人员对数据库操作的预期，造成问题就应该是出在相关内容的定义上。 下面的代码 就比较合理些。 7.5 避免API的错误-6 Public interface Connection { Public Savepoint setSavepoint(); Public interface Savepoint { Public void rollback();}} 新写的版本能够保证接口的声明和运行时结果的这两者之间是匹配的。 有UI控件使用了这个接口，它会将配置信息显示给用户，然后允许用户在多种配置间进行切换。 这个API是设计成下面这个样子的。 Interface ProjectConfigurationProvider { Public projectConfiguration[] getConfigurations（）; Public projectConfiguration[] getActive(); Public void setActive(projectConfiguration c); } Interface ProjectConfiguration { Public String getDisplayName();} 用户在不了解API内幕的时候也能开发代码，就必须将这种设计和运行的不一致性最小化。 10.6 不要滥用JavaBeans 那种监听器机制-4 JavaBeans很受欢迎的设计模式，在相应的JVM规范中已经存在了很久。 把自己的API也按照相应的规范进行调整，改得像JavaBeans组件一样。有一个用来在编辑器中将特别信息高亮显示的的API，它允许其他模块将各自实现的Highlights Containerd注册到指定位置。 Public interface HighlightContainer { Public void addHighlightsChangeLister(HighlightsChangeLister 1); Public HighlightsSequence getHighlights(int start,int end); Public void removeHighlightsChangeListener(HighlightsChangeListener 1); }