第八章 设计API时要区分其目标用户群.pptVIP

设计API时要区分其目标用户群 8 第八 章 插件、客户端程序的区别： 插件：插件是一种遵循一定规范的应用程序接口编写出来的程序。很多软件都有插件，插件有无数种。例如在IE中，安装相关的插件后，WEB浏览器能够直接调用插件程序，用于处理特定类型的文件。 客户端程序：客户服务（Customer Service），是指一种以客户为导向的价值观，它整合及管理在预先设定的最优成本——服务组合中的客户界面的所有要素。广义而言，任何能提高客户满意度的内容都属于客户服务的范围之内。 一些程序功能不仅可以直接通过界面进行操作，还可以提供相应的API,以供其他程序来调用，这样第三方程序可以发起通讯，使用相应程序的API指使它完成操作，命令执行完后，控制权返回给调用者。 XMMS的API还提供插件支持，第三方可发商可以通过注册“输出插件”来扩展XMMS的功能。它与前面说的客户端的地位完全不同。 第三方的播放场 SPI组成：是与前面说的客户端的地位完全不同。它没有让XMMS进行任何操作。但它为XMMS增加了很多功能，所以此时的插件不是前文所说的“客户端”。XMMS的这种注册插件来扩展功能的方式是SPI（Service Provider Interface）的典型应用。 Service Provider Interface 为了说明客户端API和SPI区别， Void xmms_play();Void xmms_pause(); Void xmms_add_to_list(char *); 使用Java语言来定义API的方式则完全不同。 Public class XMMS { Public void play() { doPlay(); } Public void pause() { doPause(); } Public void addToPlaylist(String file) { do addToPlaylist(file); } } 8.1 C和Java语言中如何定义API和SPI（1） C和Java语言中如何定义API和SPI（2） 在Java中声明API方式有多种。如说可使用static方法、实例方法、抽象方法、以及final方法，这些都是可以的。但编写一个SPI，情况就不同。 如果要使用C语言来为XMMS编写程序一个插件的话，必须要写一个支持回放的函数，代码如下： Void my_playbackprints(char *text) { Printf(“%s\n”,text);} Interface Playback { Public void playback(byte[] data);} Class MyCallbackPrints implements XMMS.Playback { Public void playback (byte[] data) { System.out.println(new String(data)); }} Xmms.registerPlayback(new MyCallbackPrints()); C和Java语言中如何定义API和SPI（3） 对于Java程序员，只要所编写的方法不是private、final或者static的，那么就表示该是方法支持调的，而且可以用看成是一个API。对很多程序员，甚至是教师都没有清楚地理解这一点，它也的确不是日常编码的内容。 8.2 API演进不同于SPI演进(1) 具体的演进方案则还是取决于具体的接口类型：向API中添加一些内容总是可以的，但要移除一些内容则不行。 但对于SPI，移除一些内容可以允许，但不允许添加新的内容。建立契约时，必须清楚地区分哪些是API，提供给外面调用，而哪些是SPI，用来让外部来扩展程序功能。设计时容易犯的最大错误就是将API和SPI混在一个类里。根据SPI的契约，不能添加方法，根据API的契约，也不能减少方法。 8.3 java.io.Write 这个类从JDK1.4到JDK5的演进 还需要使用try/catch/finally的方式来进行防御性编码。 Try { bufferedWrite.append(what); } catch (UnsupportedOpeartionException ex ) { bufferedWrite.write(what.toString());} 这样来调用API的确有点怪。调用一个方法竟然要写四行代码 java.io.Write 的演进(2) 假设已有一个优化过Write类，它无须将数据转换成字符串，而是直接处理以提高性能，但用户却可能无法用到这种梦寐