Spring SPI

SPI 服务供给接口（Service Provider Interface）。是Java 1.5新添加的一个内置标准，允许不同的开发者去实现某个特定的服务。

1 SPI 介绍

一个接口，可能会有许多个实现，我们在编写代码时希望能动态切换具体实现，例如：

Interface interface = new Implement1(); // 创建一个具体的interface

上面是硬编码方式，我们希望在不修改代码的情况下，更换interface的具体实现。当然我们可以使用配置文件方式来实现这个需求，伪代码如下：

ResourceBundle rb = ResourceBundle.getBundle(“interface.properties”);

String impName = rb.getString(“impName”);

Interface interface = (Interface) Class.forName(impName).newInstance();

SPI 的实现则类似于上面的方法。让系统找到具体的实现。

1.1 SPI的使用

图示例代码的项目结构说明

1）定义一个接口，在spi_example_interface项目中定义MakeMoney接口。

public interface MakeMoney {
    void hardWord();
}

2) 在自定义项目中实现接口，在spi_example_implement项目编写TeacherMakeMoney和ProgrammerMakeMoney两个类并实现MakeMoney接口。

public class ProgrammerMakeMoney implements MakeMoney {

    public ProgrammerMakeMoney() {
        System.out.println("程序员实例被创建了");
    }

    @Override
    public void hardWord() {
        System.out.println("敲代码");
    }
}

public class TeacherMakeMoney implements MakeMoney {

    public TeacherMakeMoney() {
        System.out.println("教师实例被创建了");
    }

    @Override
    public void hardWord() {
        System.out.println("教书");
    }
}

3）在spi_example_implement项目中，resources文件下新建META-INF/services 文件夹，并在该文件夹下面创建由接口完全限定名命名的文件，在文件中依次列出该接口实现类的完全限定名。

图接口实现类说明文件

4）使用定义的接口，利用Java提供的ServiceLoader类发现这个接口的实现，并使用它们。

public class SpiUse {
    public static void main(String[] args) {
        ServiceLoader<MakeMoney> makeMonies = ServiceLoader.load(MakeMoney.class);
        Iterator<MakeMoney> iterator = makeMonies.iterator();
        while (iterator.hasNext()) {
            MakeMoney imp = iterator.next(); // 实现被加载的系统
            imp.hardWord();
        }
    }
}
/*
运行结果：
程序员实例
敲代码
教师实例被创建了
教书
*/

1.2 java.sql.Driver与SPI

在Java中定义了接口java.sql.Driver，其并没有具体的实现，具体的实现都是由不同的厂商提供。下面将以mysql的驱动为例，来大致介绍Java如何管理JDBC服务。

1）实现java.sql.Driver接口。

图 mysql-connector-java jar包中Driver的定义

2) 在META-INFA/services文件夹下编写以Driver接口全限定名命名的文档，来引导ServiceLoader发现mysql实现的Driver的接口。

图 mysql jar包下的引导文件

3）注册并管理JDBC服务。

图 jdbc服务的调用过程

我们在使用jdbc 服务时，第一步是获取对数据库的连接，即执行上图的DriverManager.getConnection(url)方法。

图 DriverManager的getConnection()方法的部分代码块

以下代码是模拟数据库厂商实现java.sql.Driver这个接口：

定义SqlDriver接口，全限定名是 com.huangmingfu.SqlDriver:

public abstract class SqlDriver {

    private static List<SqlDriver> driverList = new ArrayList<>();

    /**
     * 执行sql
     */
    public abstract void execute(String sql);

    public abstract Boolean connect(String url);

    public static void register(SqlDriver sqlDriver) {
        driverList.add(sqlDriver);
    }

    public static SqlDriver getConnect(String url) {
        for (SqlDriver driver : driverList)
            if (driver.connect(url)) return driver;
        return null;
    }

}

第三方项目中对SqlDriver接口的实现（mysql和oracle）

public class MySqlDriver extends SqlDriver {

    public MySqlDriver() {
        System.out.println("MySqlDriver实例被创建");
    }

    static {
        System.out.println("MySqlDriver实例被创建被加载到虚拟机了,进行注册：SqlDriver.register");
        SqlDriver.register(new MySqlDriver());
    }

    @Override
    public void execute(String sql) {
        System.out.println("mysql数据驱动，执行sql:" + sql);
    }

    @Override
    public Boolean connect(String url) {
        return url.startsWith("mysql");
    }
}

public class OracleDriver extends SqlDriver {

    public OracleDriver() {
        System.out.println("OracleDriver 实例被创建");
    }

    static {
        System.out.println("OracleDriver实例被创建被加载到虚拟机了,进行注册：SqlDriver.register");
        SqlDriver.register(new OracleDriver());
    }

    @Override
    public void execute(String sql) {
        System.out.println("oracle数据驱动，执行sql:" + sql);
    }

    @Override
    public Boolean connect(String url) {
        return url.startsWith("oracle");
    }

}

在第三方项目的META-INF/com.huangmingfu.SqlDriver 引导文件中写入实现类的全限定名：

com.custom.MySqlDriver
com.custom.OracleDriver

使用Driver的实现类，来获取数据库连接：

public class UserDriver {

    private static SqlDriver sqlDriver;

    public static void main(String[] args) throws Exception{
        System.out.println("项目启动....");
//        classForName();
        spi();
    }

    /**
     * 反射形式
     */
    private static void classForName() throws Exception {
        System.out.println("尝试先通过class.forName的形式");
        sqlDriver = (SqlDriver)Class.forName("com.custom.MySqlDriver").newInstance();
        sqlDriver.execute("SELECT VERSION();");
    }

    /**
     * spi形式
     */
    private static void spi() {
        ServiceLoader<SqlDriver> serviceLoader = ServiceLoader.load(SqlDriver.class);
        Iterator<SqlDriver> iterator = serviceLoader.iterator();
        while (iterator.hasNext()) iterator.next(); //只是做加载动作
        SqlDriver driver = SqlDriver.getConnect("mysql://");
        if (driver != null) driver.execute("SELECT VERSION()");
    }
}
/*
运行结果
项目启动....
MySqlDriver实例被创建被加载到虚拟机了,进行注册：SqlDriver.register
MySqlDriver实例被创建
MySqlDriver实例被创建
OracleDriver实例被创建被加载到虚拟机了,进行注册：SqlDriver.register
OracleDriver 实例被创建
OracleDriver 实例被创建
mysql数据驱动，执行sql:SELECT VERSION()
 */

2 SPI 原理

java实现SPI的是ServiceLoader类，其实现步骤一共有两步：1）根据接口的全限定名查找META-INF/services下的接口实现引导文件记录的实现类全限定名集合；2）通过Class.forName(全限定名).newInstance()方法来将这些实现类加载进jvm中。

图第一步ServiceLoader获取接口实现类的全限定名

图第二步 ServiceLoader创建实现类的实例

3 SPI的优缺点及应用场景

spi 能扩展服务，将接口与实现解耦。通过服务接口和服务提供者，实现了服务规范的制定和服务具体实现的分离。

API	在大多数情况下，都是实现方制定接口并完成对接口的实现。调用方仅仅依赖接口调用，且无权选择不同实现。API是直接被应用开发人员使用。
SPI	是调用方来制定接口规范，提供给外部来实现。调用方在调用时则选择自己需要的外部实现。SPI是被框架扩展人员使用。

表 API与SPI的对比

缺点：

1）不能按需加载，需要遍历所有的实现并实例化，然后在循环中才能找到我们需要的实现。

2）多个并发多线程使用ServiceLoader类的实例是不安全的。

应用场景：

有关组织和公司定义接口标准，第三方提供具体实现。例如JDBC。