Java的SPI机制与简单的示例

一、SPI机制

这里先说下SPI的一个概念，SPI英文为Service Provider Interface单从字面可以理解为Service提供者接口，正如从SPI的名字去理解SPI就是Service提供者接口；我对SPI的定义：提供给服务提供厂商与扩展框架功能的开发者使用的接口。

在我们日常开发的时候都是对问题进行抽象成Api然后就提供各种Api的实现，这些Api的实现都是封装与我们的Jar中或框架中的虽然当我们想要提供一种Api新实现时可以不修改原来代码只需实现该Api就可以提供Api的新实现，但我们还是生成新Jar或框架（虽然可以通过在代码里扫描某个目录已加载Api的新实现，但这不是Java的机制，只是hack方法），而通过Java SPI机制我们就可以在不修改Jar包或框架的时候为Api提供新实现。

     很多框架都使用了java的SPI机制，如java.sql.Driver的SPI实现（mysql驱动、oracle驱动等）、common-logging的日志接口实现、dubbo的扩展实现等等框架；

 

SPI机制的约定：

1)         在META-INF/services/目录中创建以接口全限定名命名的文件该文件内容为Api具体实现类的全限定名

2)         使用ServiceLoader类动态加载META-INF中的实现类

3)         如SPI的实现类为Jar则需要放在主程序classPath中

4)         Api具体实现类必须有一个不带参数的构造方法

                                SPI机制结构图

二、SPI机制示例

 

                        实例结构图

IOperation接口：

1 2 3 4 5 6 7 8

/**   * Created by LX on 2015/3/8.   */ public  interface  IOperation {        public  int  operation( int  numberA,  int  numberB);   }

PlusOperationImpl实现：

1 2 3 4 5 6 7 8 9 10 11 12

import  co.solinx.demo.api.IOperation;   /**   * Created by LX on 2015/3/8.   */ public  class  PlusOperationImpl  implements  IOperation {        @Override      public  int  operation( int  numberA,  int  numberB) {          return  numberA + numberB;      } }

SPI接口的实现类：DivisionOperationImpl

1 2 3 4 5 6 7 8 9 10 11 12

import  co.solinx.demo.api.IOperation;   /**   * Created by LX on 2015/3/8.   */ public  class  DivisionOperationImpl  implements  IOperation {        @Override      public  int  operation( int  numberA,  int  numberB) {          return  numberA / numberB;      } }

META-INF/Services目录中的文件：

文件名：co.solinx.demo.api.IOperation，内容：co.solinx.demo.spi.DivisionOperationImpl

Main类：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29

import  co.solinx.demo.api.IOperation; import  co.solinx.demo.impl.PlusOperationImpl; import  co.solinx.demo.spi.DivisionOperationImpl;   import  java.util.Iterator; import  java.util.ServiceLoader;   /**   * Created by LX on 2015/3/8.   */ public  class  main {        public  static  void  main(String[] args) {          IOperation plus =  new  PlusOperationImpl();            IOperation division =  new  DivisionOperationImpl();          System.out.println(plus.operation( 5 ,  3 ));            System.out.println(division.operation( 9 ,  3 ));            ServiceLoader<IOperation> operations = ServiceLoader.load(IOperation. class );          Iterator<IOperation> operationIterator = operations.iterator();          System.out.println( "classPath:" +System.getProperty( "java.class.path" ));          while  (operationIterator.hasNext()) {              IOperation operation = operationIterator.next();              System.out.println(operation.operation( 6 ,  3 ));          }      } }

运行结果：

 

如把SPI实现打包为jar需要把jar放在classpath目录中，SPI jar包运行结果：

 

文章首发地址：Solinx

http://www.solinx.co/archives/142