快捷導(dǎo)航

Java中的SPI機(jī)制使用解析

更新時(shí)間：2023年10月07日 08:57:05 作者：cloneme01

這篇文章主要介紹了Java中的SPI機(jī)制使用解析,SPI意思是"服務(wù)提供者的接口",專門提供給服務(wù)提供者或者擴(kuò)展框架功能的開發(fā)者去使用的接口,SPI 將服務(wù)接口和服務(wù)實(shí)現(xiàn)分離開來,將服務(wù)調(diào)用方和服務(wù)實(shí)現(xiàn)方進(jìn)行解耦,需要的朋友可以參考下

SPI機(jī)制簡(jiǎn)述

SPI（Service Provider Interface的縮寫）意思是：“服務(wù)提供者的接口”，專門提供給服務(wù)提供者或者擴(kuò)展框架功能的開發(fā)者去使用的接口。SPI 將服務(wù)接口和服務(wù)實(shí)現(xiàn)分離開來，將服務(wù)調(diào)用方和服務(wù)實(shí)現(xiàn)方進(jìn)行解耦，能夠提升程序的擴(kuò)展性和可維護(hù)性，當(dāng)修改或替換服務(wù)實(shí)現(xiàn)并不需要修改調(diào)用方。 SPI 是JDK內(nèi)置的一種動(dòng)態(tài)加載擴(kuò)展點(diǎn)的實(shí)現(xiàn)。

場(chǎng)景

很多框架都使用了JAVA 的 SPI 機(jī)制，如：數(shù)據(jù)庫加載驅(qū)動(dòng)、日志接口以及DUBBO的擴(kuò)展實(shí)現(xiàn)等。

SPI與API的區(qū)別

（1）API（Application Programming Interface的縮寫），一般都是由實(shí)現(xiàn)方制定接口并完成對(duì)接口的實(shí)現(xiàn)，調(diào)用方僅依賴接口調(diào)用，并無法選擇不同實(shí)現(xiàn)。

（2）SPI（Service Provider Interface的縮寫），一般都是由調(diào)用方來制定接口規(guī)范，將接口規(guī)范提供給外部廠商來實(shí)現(xiàn)，調(diào)用方在調(diào)用時(shí)可以選擇不同的實(shí)現(xiàn)。

在這里插入圖片描述

SPI的實(shí)現(xiàn)

（1）定義一個(gè)公共接口（一般定義在一個(gè)公共的模塊中，實(shí)現(xiàn)方和調(diào)用方都會(huì)引用該模塊）；

（2）實(shí)現(xiàn)方需要實(shí)現(xiàn)剛剛定義的公共接口；

（3）實(shí)現(xiàn)方在“META-INF/services”目錄下新建一個(gè)名稱為接口的全限定名的文本文件，文件內(nèi)容為接口實(shí)現(xiàn)類的全限定名（一般會(huì)在resources目錄下創(chuàng)建如上文件）；

（4）調(diào)用方通過ServiceLoader#load方法加載接口的實(shí)現(xiàn)類實(shí)例。

SPI的示例代碼

在“模塊1”中定義一個(gè)公共接口“Hello”，分別在“模塊2”和“模塊2”兩個(gè)模塊中實(shí)現(xiàn)剛剛定義的接口作為兩個(gè)實(shí)現(xiàn)方，在“模塊4”中通過ServiceLoader進(jìn)行測(cè)試并作為調(diào)用方。

// 1. 公共接口(模塊1)：
package com.hadoopx.common.util;
public interface Hello {
    void say();
}
// 2. 具體實(shí)現(xiàn)1(模塊2)：
package com.hadoopx.m1.test;
import com.hadoopx.common.util.Hello;
public class Chinese implements Hello {
    @Override
    public void say() {
        System.out.println("你好！");
    }
}
// 3. 創(chuàng)建文件： resources/META-INF/services/com.hadoopx.common.util.Hello，內(nèi)容如下：
com.hadoopx.m1.test.Chinese
// 4. 具體實(shí)現(xiàn)2(模塊3)：
package com.hadoopx.m2.test;
import com.hadoopx.common.util.Hello;
public class English implements Hello {
    @Override
    public void say() {
        System.out.println("HELLO WORLD！");
    }
}
// 5. 創(chuàng)建文件： resources/META-INF/services/com.hadoopx.common.util.Hello，內(nèi)容如下：
com.hadoopx.m2.test.English
// 6. 調(diào)用方(模塊4)：
package com.hadoopx.test;
import com.hadoopx.common.util.Hello;
import java.util.Iterator;
import java.util.ServiceLoader;
public class Test {
    public static void main(String[] args) {
        ServiceLoader<Hello> loader = ServiceLoader.load(Hello.class);
        Iterator<Hello> iterator = loader.iterator();
        while (iterator.hasNext()) {
            Hello hello = iterator.next();
            hello.say();
        }
    }
}

JAVA與SPRING關(guān)于SPI的區(qū)別

SPRING SPI對(duì)JAVA SPI進(jìn)行了封裝和增強(qiáng)，調(diào)用方可以使用SpringFactoriesLoader.loadFactories方法得到配置文件中寫的實(shí)現(xiàn)類的集合，其要求如下：

（1）配置文件必須在resources/META-INF/目錄下，文件名必須為spring.factories；

（2）文件內(nèi)容為鍵值對(duì)形式，一個(gè)鍵可以有多個(gè)值（需要用逗號(hào)分割），鍵值都要求是類的全限定名，鍵名為接口的全限定名。

在SPRING BOOT的自動(dòng)裝配過程中，最終會(huì)加載META-INF/spring.factories文件，加載的過程是由SpringFactoriesLoader加載的，它會(huì)從CLASSPATH下的每個(gè)JAR包中搜尋所有META-INF/spring.factories配置文件并解析，然后將其中定義的BEAN注入到SPRING容器。

// 1. 公共接口(模塊1)：
package com.hadoopx.common.util;
public interface Hello {
    void say();
}
// 2. 具體實(shí)現(xiàn)1(模塊2)：
package com.hadoopx.m1.test;
import com.hadoopx.common.util.Hello;
public class Chinese implements Hello {
    @Override
    public void say() {
        System.out.println("你好！");
    }
}
// 3. 創(chuàng)建/修改文件： resources/META-INF/spring.factories，內(nèi)容如下：
com.hadoopx.common.util.Hello = \
com.hadoopx.m1.test.Chinese
// 4. 具體實(shí)現(xiàn)2(模塊3)：
package com.hadoopx.m2.test;
import com.hadoopx.common.util.Hello;
public class English implements Hello {
    @Override
    public void say() {
        System.out.println("HELLO WORLD！");
    }
}
// 5. 創(chuàng)建/修改文件： resources/META-INF/spring.factories，內(nèi)容如下：
com.hadoopx.common.util.Hello = \
com.hadoopx.m2.test.English
// 6. 調(diào)用方(模塊4)：
package com.hadoopx.test;
import com.hadoopx.common.util.Hello;
import java.util.Iterator;
import java.util.ServiceLoader;
public class Test {
    public static void main(String[] args) {
        List<Hello> hellos = SpringFactoriesLoader.loadFactories(Hello.class, null);
        for(Hello hello: hellos) {
            hello.say();
        };
    }
}