SPI - Service Provider Interfaces

java 1.6起增加了SPI机制,定义好一个Provider Interface,然后在META-INF/services目录下建一个同名的文档,按行添加该接口的实现类,即可通过ServiceLoader获取所有的Provider实例,是OOAD设计原则中依赖反转思想的体现,让系统可扩展性更好。

java原生的SPI机制只能由jvm根据类来提供实例,按DI的理念来讲,我们不应该关注或者限定实例的提供方式,所以coodex设计了一个既兼容java SPI且扩展性更强的SPI机制。

org.coodex.util.ServiceLoader<T>

Map<String, T> getAll()

获取所有此类型的实例,coodex SPI为实例增加了一个名称的属性,参考了javax.inject规范的name设计,在扩展和服务选择时可以更方便的操作

T get(Class<? extends T>)

根据一个类型获取服务实例

T get(String)

根据名称获取服务实例

T get()

获取实例,当存在多个服务实例时,可通过重载LazyServiceLoader的conflict系列方法来解决

T getDefault()

获取默认的服务实例。coodex SPI建议每个Loader都能提供一个默认的服务实例,减少使用复杂度

org.coodex.util.LazyServiceLoader<T>

coodex SPI的实现

usage

例如,我们有一个interface A

private static final ServiceLoader<A> A_SERVICE_LOADER = new ServiceLoaderImpl<A>(){};

扩展点

org.coodex.util.ServiceLoaderProvider

coodex SPI机制相对java SPI来讲,支持多种ServiceLoader,需要增加你的Loader机制时,只需要实现一个ServiceLoaderProvider即可

已有的实现包括

org.coodex.util.JavaUtilServiceLoaderProvider

coodex-utitlies中,基于java.util.ServiceLoader的Provider

org.coodex.util.SpringServiceLoaderProvider

基于Spring的ServiceLoaderProvider,使用时放入JUS和spring容器即可

SelectableServiceLoader<Param_Type, T extends SelectableService<Param_Type>>

一个coodex SPI的扩展,可以根据参数来选择一个能够处理该参数的服务实例

假定有以下service

public interface NumberSelectableService extends SelectableService<Integer>{}

奇数是一个服务实例,偶数是一个实例

public class OddNumberSelectableService implements NumberSelectableService{
    @Override
    public boolean accept(Integer param) {
        return param != null && param % 2 == 1;
    }
}
public class EvenNumberSelectableService implements NumberSelectableService{
    @Override
    public boolean accept(Integer param) {
        return param != null && param % 2 == 0;
    }
}

使用

    private static final SelectableServiceLoader<Integer, NumberSelectableService> NUMBER_SERVICE_LOADER =
            new LazySelectableServiceLoader<Integer, NumberSelectableService>() {
            };
        NUMBER_SERVICE_LOADER.select(0);// 获取到的是EvenNumberSelectableService的实例
        NUMBER_SERVICE_LOADER.select(1);// 获取到的是OddNumberSelectableService的实例

SelectableServiceLoader是一种策略模式(wiki, 百度)的设计,非常理想的隔离了不同数据控制实现

© coodex.org 2014-2020 all right reserved,powered by GitbookFile Modify: 2020-10-19 09:07:46

results matching ""

    No results matching ""