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

1、设计API时要区分其目标用户群,8,第八 章,插件、客户端程序的区别： 插件：插件是一种遵循一定规范的应用程序接口编写出来的程序。很多软件都有插件，插件有无数种。例如在IE中，安装相关的插件后，WEB浏览器能够直接调用插件程序，用于处理特定类型的文件。 客户端程序：客户服务（Customer Service），是指一种以客户为导向的价值观，它整合及管理在预先设定的最优成本服务组合中的客户界面的所有要素。广义而言，任何能提高客户满意度的内容都属于客户服务的范围之内。,一些程序功能不仅可以直接通过界面进行操作，还可以提供相应的API,以供其他程序来调用，这样第三方程序可以发起通讯，使用相应程序的A

2、PI指使它完成操作，命令执行完后，控制权返回给调用者。 XMMS的API还提供插件支持，第三方可发商可以通过注册“输出插件”来扩展XMMS的功能。它与前面说的客户端的地位完全不同。,第三方的播放场,SPI组成：是与前面说的客户端的地位完全不同。它没有让XMMS进行任何操作。但它为XMMS增加了很多功能，所以此时的插件不是前文所说的“客户端”。XMMS的这种注册插件来扩展功能的方式是SPI（Service Provider Interface）的典型应用。,Service Provider Interface,为了说明客户端API和SPI区别， Void xmms_play();Void xmm

3、s_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方法、实例方法、抽象方法

4、、以及final方法，这些都是可以的。但编写一个SPI，情况就不同。 如果要使用C语言来为XMMS编写程序一个插件的话，必须要写一个支持回放的函数，代码如下： Void my_playbackprints(char *text) Printf(“%sn”,text); Interface Playback Public void playback(byte data); Class MyCallbackPrints implements XMMS.Playback Public void playback (byte data) System.out.println(new String(da

5、ta); Xmms.registerPlayback(new MyCallbackPrints();,C和Java语言中如何定义API和SPI（3）,对于Java程序员，只要所编写的方法不是private、final或者static的，那么就表示该是方法支持调的，而且可以用看成是一个API。对很多程序员，甚至是教师都没有清楚地理解这一点，它也的确不是日常编码的内容。,8.2 API演进不同于SPI演进(1),具体的演进方案则还是取决于具体的接口类型：向API中添加一些内容总是可以的，但要移除一些内容则不行。 但对于SPI，移除一些内容可以允许，但不允许添加新的内容。建立契约时，必须清楚地区分哪

6、些是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的确有点怪。调用一个方法

7、竟然要写四行代码,java.io.Write 的演进(2),假设已有一个优化过Write类，它无须将数据转换成字符串，而是直接处理以提高性能，但用户却可能无法用到这种梦寐以求的优化， Public class CountingWrite extends Write Private int counter; Public int getcharacterCount() Return counter; ,java.io.Write 的演进(3),Override Public void write(char cbuf ,int off,int len) throws IoException Cou

8、nter+=len; Override Public Write append(CharSepuence csq) throws IoException Counter +=csq.length(); Return this ; 。,Private static final class CDSequence implements CharSequence Private final int start;Private final int end; Public CDSequence() This(0,647*1024*1024); Private CDSequence(int start,in

9、t end) This.start=start; This.end=end; Public int length() Return end-start; CountingWriter writer=new CountingWriter(); CDSequence cdImage=new CDSequence(); BufferedWriter bufferedWriter=new BufferedWriter(writer); bufferedWriter.append(cdImage); assertEquals( “Correct number of writes delegated”,

10、cdImage.length(),writer.getCharacterCount();,从JDK1.4到JDK5的演进（4）,这个通过覆盖来优化性能的方法却不会被调用，效率仍然没有提高。 If (shouldBufferAs TheSequenceIsNotTooBig(csq) Write(csq.toString(); else Flush();Out.append(csq)； Return this;,从JDK1.4到JDK5的演进（5）,首先计算一下字符的数量，如果数量比较小，性能影响也比较小，就使用老的方式处理，否则就先写入当前数据后，再写入大数据。然而，还远远没有结束，还有一个潜

11、在的问题需要解决。 Public class CryptoWriter extends BufferedWriter Public CryptoWriter(Writer out) Super(out); Override Public void write(char buf,int off,int len) throws IoException Char arr=new charlen; For (int i=0;ilen;i+) Arri=encryptChar(bufoff+i); Super.write(arr,0,len);,从JDK1.4到JDK5的演进(6),Override P

12、ublic void write(int c) throws IoException Super.write(encryptChar); override Public void write(String str,int off,int len) throws IoException StringBuffer sb=new StringBuffer(); For (int i+0;ilen;I+) Sb.append(encryptChar(str.charAt(off+i); Super.write(sb.toString(),0,len); Private char encryptChar

13、(int c) If (c=Z) Return A; If (c=z) Return a; Return (char)(c+1); 。,从JDK1.4到JDK5的演进(7),事情变得越来越复杂了！为了处理含有大量字符串的对象等目的，最好是直接将数据写入相应的Writer对象。 Boolean isOverriden =false; Try isOverriden=( getClas().getMethod( “write”,String.class ).getDeclaringClass()!=Writer.class)| (getClass().getMethod( “write”,inte

14、ger.TYPE ).getDeclaringClass !=BufferedWriter.class)| ( getClass().getMethod( “write”,String.class,Integer.TYPE,Integer.TYPE ).getDeclaringClass()!=BufferedWriter.class ); catch (Exception ex) Throws new IoException(ex); If (isOverriden |shouldBufferAsTheSequenceIsNotTooBig(csq) Write(csq.toString()

15、; else Flush(); Out.append(csq); Return this;,反射技术,第三个版本才是最终的解决方案。它使用了反射技术，所以看起来复杂一点，但却是一个非常有效的解决方案。 反射技术让这段代码看起来不如原来那么漂亮了，但至少它可以正常运行，结果也是正确的。 让一个类可以被动继承，其实就意味着把它当作一个SPI，因为其子类可以提共新技术部的功能，或者说新的服务，但对于代理来说，它更多是让其它的代码来进行调用它的功能，属于功能API，两者是不一样。不能像表面看起来那么简单、顺畅了。,如何避免继承（1）,Public final class Writer Private

16、final Impl impl ; Private Writer(Impl,impl) This.impl=impl; Public final void write(int c) throws IoException Char arr= (char) c ; Impl.write(arr,0,1); Public final void write(char cbuf) thrpws IoException Impl.write(cbuf,0,cbuf.length); Public final void write(char cbuf,int off,int len ) Throws IoE

17、xception Impl.write(cbuf ,off,len); Public final void write(String str) throws IoException Impl.write(str,0,str.length(); ,如何避免继承（2）,Public final void write(String str ,int off,int len) Throws IoException Impl.write(str,off,len); Public final void flush() throws IoException Impl.flush(); Public fina

18、l void close() throws IoException Impl.close();,SPI的提供者类（1),现在写一个SPI的提供者类，这个类中全部都是工厂方法，用来提供Impl接口的具体实现，基本上就是下面这个样子。 Public static Writercreat(Impl impl ) Return new Writer(impl)； Public static Writer creat(final java.io.Writer w) Return new Writer(new Impl() Public void Write(String,str,int off,int

19、len ) Throws IoException w.Write(str,off,len);,SPI的提供者类（2),Public void write(char arr,int off,int len ) Throws IoException w.write(arr,off,len); Public void close() throws IoExcepton w.close(); Public void flush() throws IoException w.flush(); Public static Writer creatBuffered(final Writer out) Ret

20、urn create(new SimpleBuffer(out); Public static interface Impl Public void close() throws IoException; Public void flush() throws IoException ; Public void write(String s,int off,int len) throws IoException; Public void write(char a,int off,int len) throws IoException;,SPI的提供者类（3),Public final class

21、 Writer implements Appendable Private final Impl impl ; Private final ImplSeq seq; Private Writer(Impl impl ,ImplSeq seq) This.impl =impl; Thisseq =seq; Public final void write(int c) throws IException If (impl!=null) Char arr =(char) c; Impl.write(arr ,0,1) else Seq.write(new CharSeq(c); Public fin

22、al void write(char cbuf) throws IoException If (impl!=null) Impl.write(cbuf,0,cbuf.length); elseSeq.write(new CharSeq(cbuf,0,cbuf.length); ,SPI的提供者类（4),Public final void write(char cbuf,int off,int len) Throws IoException If (impl! =null) Impl.write(cbuf,off,len); else Seq.write(new CharSeq(cbuf,off

23、,len); Public final void write(String str) throws IoException If (impl! =null) Impl.write(str,0,str.length); else Seq.write(str); Public final void write(String str,int off,int len) Throws IoException If (impl!=null) Impl.write(str,off,len); else Seq.write(str.subSequence(off,off+len); ,SPI的提供者类（5),

24、Public final void flush() throws IoException If (impl!=null) Impl.flush(); else Seq.flush(); Public final void close() throws IoException If (impl!=null) Impl.close(); else Seq.flush(); ,SPI的提供者类（6),设计给客户使用API,最好用final类；而设计SPI的时候，则最好用接口，然后 通过一个工厂模式将它们结合在一起。借助“工厂设计模式”尽可能是对客户“隐藏了”相应的复杂度，在API功能时，用户则只看到final类Writer，对于要扩展API功能的人，则只需要看到两个要实现的接口Impl和ImplSeq，所以不管是使用还是扩展这个API，复杂度都不高。虽然根据这个方案写出第一个版本API时，也许工作量会多一些，但是将客户用到功能性API和SPI分离出来，大大降低了演进难度，避免出现将代理与继承混合时出现的那种问题。,8.4 合理分解API（1）,可以把API分为两类，一类是供他人调用来