Java SPI机制

有这样的一个应用场景，在某个JAR包内，有一个接口IA，然后有3个IA接口的具体实现类，分别是AIA,BIA,CIA。

那么如果在该JAR包内其他的类中使用接口IA的时候，硬编码IA对象对应的具体实现类，就会导致非常不灵活。这就是SPI机制产生的场景由来。

一、SPI机制概念
SPI的全称是Service Provider Interface。

简单来说，SPI机制提供了一个表达接口和其具体实现类之间的绑定关系的方案。具体是在JAR包的"META-INF/services/"目录下建立一个文件，文件名是接口的全限定名，文件的内容可以有多行，每行都是该接口对应的具体实现类的全限定名。

二、使用例子
2.1、 commons-logging中的例子

在commons-logging:commons-logging:1.1包中有个LogFactory抽象类（全限定名是"org.apache.commons.logging.LogFactory"），在其中有个静态方法

public static LogFactory getFactory() throws LogConfigurationException

用于获取一个默认的LogFactory实例。

在该方法中，有一段Java代码片段如下：

if(factory == null) {
                if(isDiagnosticsEnabled()) {
                    logDiagnostic("[LOOKUP] Looking for a resource file of name [META-INF/services/org.apache.commons.logging.LogFactory] to define the LogFactory subclass to use...");
                }


                try {
                    InputStream names1 = getResourceAsStream(contextClassLoader, "META-INF/services/org.apache.commons.logging.LogFactory");
                    if(names1 != null) {
                        BufferedReader name;
                        try {
                            name = new BufferedReader(new InputStreamReader(names1, "UTF-8"));
                        } catch (UnsupportedEncodingException var7) {
                            name = new BufferedReader(new InputStreamReader(names1));
                        }


                        value = name.readLine();
                        name.close();
                        if(value != null && !"".equals(value)) {
                            if(isDiagnosticsEnabled()) {
                                logDiagnostic("[LOOKUP]  Creating an instance of LogFactory class " + value + " as specified by file \'" + "META-INF/services/org.apache.commons.logging.LogFactory" + "\' which was present in the path of the context" + " classloader.");
                            }


                            factory = newFactory(value, baseClassLoader, contextClassLoader);
                        }
                    } else if(isDiagnosticsEnabled()) {
                        logDiagnostic("[LOOKUP] No resource file with name \'META-INF/services/org.apache.commons.logging.LogFactory\' found.");
                    }
                } catch (Exception var8) {
                    if(isDiagnosticsEnabled()) {
                        logDiagnostic("[LOOKUP] A security exception occurred while trying to create an instance of the custom factory class: [" + var8.getMessage().trim() + "]. Trying alternative implementations...");
                    }
                }
}

这段代码的意思就是说使用SPI机制，在Jar包的"META-INF/services/"目录下查找一个文件名为"org.apache.commons.logging.LogFactory"的文件，在文件中可以配置默认要使用的LogFactory具体实现类的全限定名。


2.2、自己的例子

现在有以下类层次结构

IA的内容如下：

package spi;

public interface IA {
    void doIt();
}

AIA的内容如下：

package spi;

public class AIA implements IA {
    public void doIt() {
        System.out.println("doIt In AIA");
    }
}

BIA的内容如下：

package spi;

public class BIA implements IA {
    public void doIt() {
        System.out.println("doIt In BIA");
    }
}

CIA的内容如下：

package spi;

public class CIA implements IA {
    public void doIt() {
        System.out.println("doIt In CIA");
    }
}

Main的内容如下：

package spi;

import java.util.Iterator;
import java.util.ServiceLoader;

public class Main {
    public static void main(String[] args) {
        ServiceLoader spiLoader = ServiceLoader.load(IA.class);
        Iterator iaIterator = spiLoader.iterator();
        while (iaIterator.hasNext()) {
            iaIterator.next().doIt();
        }
    }
}

在META-INF/services/spi.IA文件中的内容如下：

spi.AIA
spi.BIA
spi.CIA

运行spi.Main，可以发现输出结果如下：

参考文献：

[1]http://singleant.iteye.com/blog/1497259

[2]http://blog.csdn.net/fenglibing/article/details/7083071