关于java:追踪解析-Dubbo-的-Spi-机制源码

7次阅读

共计 8473 个字符，预计需要花费 22 分钟才能阅读完成。

文章异样啰嗦且绕弯。

JDK 版本 : Adoptopenjdk 14.0.1
IDE : idea 2020.2
Dubbo 版本 : dubbo 2.7.6

Dubbo Spi 是 Dubbo 框架扩展性的基本根底，是基于 jdk spi 的封装和扩大。

import org.apache.dubbo.common.extension.Adaptive;
import org.apache.dubbo.common.extension.SPI;

@SPI("dubbo")  // spi 最次要的注解
public interface SpiDemoService {void sayHello(); 
}

一号实现类 :

public class SpiDemoOneServiceImpl implements SpiDemoService {
    @Override
    public void sayHello() {System.out.println("hello 1");
    }
}

二号实现类 :

public class SpiDemoTwoServiceImpl implements SpiDemoService {
    @Override
    public void sayHello() {System.out.println("hello 2");
    }
}

测试方法类：

import org.apache.dubbo.common.extension.ExtensionLoader;

public class SpiTest {public static void main(String[] args) {

        // 获取 loader 工厂类
        ExtensionLoader<SpiDemoService> loader 
            = ExtensionLoader
                .getExtensionLoader(SpiDemoService.class);

        // 获取实体类
        SpiDemoService one = loader.getExtension("one");

        // 测试方法
        one.sayHello();}
}

回到 demo :

ExtensionLoader<SpiDemoService> loader 
            = ExtensionLoader
                .getExtensionLoader(SpiDemoService.class);

getExtensionLoader 是 ExtensionLoader 最外围的静态方法，用于获取 ExtensionLoader 实例

// org.apache.dubbo.common.extension.ExtensionLoader
public static <T> ExtensionLoader<T> getExtensionLoader(Class<T> type) {

        // 可行性判断，均疏忽
        
        if (type == null) {throw new IllegalArgumentException("Extension type == null");
        }
        if (!type.isInterface()) {throw new IllegalArgumentException("Extension type (" + type + ") is not an interface!");
        }
        if (!withExtensionAnnotation(type)) {
            throw new IllegalArgumentException("Extension type (" + type +
                    ") is not an extension, because it is NOT annotated with @" + SPI.class.getSimpleName() + "!");
        }


        // 先尝试获取，如果获取失败就创立一个 ExtensionLoader
        // EXTENSION_LOADERS 是一个动态 ConcurrentHashMap，用来寄存 loader
        ExtensionLoader<T> loader = (ExtensionLoader<T>) EXTENSION_LOADERS.get(type);
        if (loader == null) {EXTENSION_LOADERS.putIfAbsent(type, new ExtensionLoader<T>(type));
            loader = (ExtensionLoader<T>) EXTENSION_LOADERS.get(type);
        }
        return loader;
    }

// org.apache.dubbo.common.extension.ExtensionLoader
private ExtensionLoader(Class<?> type) {
    // 存储要创立的 loader 的类型
    this.type = type;
    
    // objectFactory 是 ExtensionFactory 类型的对象，是用来依赖注入的工厂
    objectFactory 
        = (type == ExtensionFactory.class ? 
          null : ExtensionLoader
                     .getExtensionLoader(ExtensionFactory.class)
                     .getAdaptiveExtension());
    }

// org.apache.dubbo.common.extension.ExtensionLoader
public T getAdaptiveExtension() {
    // cachedAdaptiveInstance 是一个 Holder 对象，Holder 是对 Object 的包装
    // 在此处先尝试获取实例化实现的对象，如果获取不到，就进入加载逻辑
    Object instance = cachedAdaptiveInstance.get();
    if (instance == null) {
    
        // 如果之前初始化的时候报错了，那么谬误会被记录下来并缓存在此处，间接抛出
        // 此处的设计应该是缩小锁耗费
        if (createAdaptiveInstanceError != null) {throw new IllegalStateException("Failed to create adaptive instance:" + createAdaptiveInstanceError.toString(),
            createAdaptiveInstanceError);
        }

        synchronized (cachedAdaptiveInstance) {
            // 双锁验证
            instance = cachedAdaptiveInstance.get();
            if (instance == null) {
                try {
                    // 创立实例并存储在 Holder 对象里
                    instance = createAdaptiveExtension();
                    cachedAdaptiveInstance.set(instance);
                } catch (Throwable t) {
                    // 如果报错了就会把谬误存储起来
                    createAdaptiveInstanceError = t;
                    throw new IllegalStateException("Failed to create adaptive instance:" + t.toString(), t);
                }
            }
        }
    }
    
    // 返回对象实例
    return (T) instance;
}

创立实例对象：

// org.apache.dubbo.common.extension.ExtensionLoader
private T createAdaptiveExtension() {
    try {// getAdaptiveExtensionClass().newInstance() 办法会应用 Class 对象的 newInstance() 办法创立一个对象
        // injectExtension(...) 则会对创立进去的对象进行依赖注入
        return injectExtension((T)getAdaptiveExtensionClass().newInstance());
    } catch (Exception e) {throw new IllegalStateException("Can't create adaptive extension "+ type +", cause: " + e.getMessage(), e);
    }
}

// org.apache.dubbo.common.extension.ExtensionLoader
private T injectExtension(T instance) {

    // objectFactory 是用来依赖注入的 ExtensionFactory
    // 如果 objectFactory 为空，就间接返回
    // 须要留神的是，只有非 ExtensionFactory 的 loader 才有 objectFactory
    if (objectFactory == null) {return instance;}

    try {
        // 轮训实例对象中所有的办法
        for (Method method : instance.getClass().getMethods()) {
        
            // 如果办法不是 set 办法就跳过
            // 此处能够了解为，dubbo 的 spi 依赖注入须要 set 办法反对
            if (!isSetter(method)) {continue;}

            // 如果办法被标注了 DisableInject 注解就跳过
            if (method.getAnnotation(DisableInject.class) != null) {continue;}
            
            // 如果办法的参数是原始类型就跳过
            // 依赖注入须要应用包装类型
            Class<?> pt = method.getParameterTypes()[0];
            if (ReflectUtils.isPrimitives(pt)) {continue;}

            try {
            
                // 反射注入
                String property = getSetterProperty(method);
                Object object = objectFactory.getExtension(pt, property);
                if (object != null) {method.invoke(instance, object);
                }
            } catch (Exception e) {logger.error("Failed to inject via method" + method.getName()
                             + "of interface" + type.getName() + ":" + e.getMessage(), e);
            }

        }
    } catch (Exception e) {logger.error(e.getMessage(), e);
    }
    return instance;
}

ExtensionFactory 是用来依赖注入的工厂：

@SPI
public interface ExtensionFactory {<T> T getExtension(Class<T> type, String name);
}

该接口在 Dubbo 中有三个默认实现类：

org.apache.dubbo.config.spring.extension.SpringExtensionFactory
org.apache.dubbo.common.extension.factory.AdaptiveExtensionFactory
org.apache.dubbo.common.extension.factory.SpiExtensionFactory

在开发中 SpringExtensionFactory 应该会用的更宽泛一些，本示例中此处临时不开展。

AdaptiveExtensionFactory 是默认工厂：

import org.apache.dubbo.common.extension.Adaptive;
import org.apache.dubbo.common.extension.ExtensionFactory;
import org.apache.dubbo.common.extension.ExtensionLoader;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;

@Adaptive
public class AdaptiveExtensionFactory implements ExtensionFactory {

    private final List<ExtensionFactory> factories;

    // 结构器
    public AdaptiveExtensionFactory() {
        ExtensionLoader<ExtensionFactory> loader 
            = ExtensionLoader
                .getExtensionLoader(ExtensionFactory.class);
        
        // AdaptiveExtensionFactory 会将 SpiExtensionFactory 和 SpringExtensionFactory 搁置在 factories 列表里
        
        List<ExtensionFactory> list = new ArrayList<ExtensionFactory>();
        for (String name : loader.getSupportedExtensions()) {list.add(loader.getExtension(name));
        }
        factories = Collections.unmodifiableList(list);
    }

    // 应用 AdaptiveExtensionFactory 去获取实体类的时候，// 会调用 spi 或者 spring 的 ext 工厂去尝试获取实体类
    @Override
    public <T> T getExtension(Class<T> type, String name) {for (ExtensionFactory factory : factories) {T extension = factory.getExtension(type, name);
            if (extension != null) {return extension;}
        }
        return null;
    }
}

import org.apache.dubbo.common.extension.ExtensionFactory;
import org.apache.dubbo.common.extension.ExtensionLoader;
import org.apache.dubbo.common.extension.SPI;

public class SpiExtensionFactory implements ExtensionFactory {

    @Override
    public <T> T getExtension(Class<T> type, String name) {
        // spi 工厂用于解析 spi 注解
        if (type.isInterface() && type.isAnnotationPresent(SPI.class)) {
            // 如果传入的 type 是一个被 spi 正文的接口，那么会初始化一个它的 class loader
            ExtensionLoader<T> loader 
                    = ExtensionLoader.getExtensionLoader(type);
                    
            // 初始化对象
            if (!loader.getSupportedExtensions().isEmpty()) {return loader.getAdaptiveExtension();
            }
        }
        return null;
    }
}

回到 demo :

SpiDemoService one = loader.getExtension("one");

// org.apache.dubbo.common.extension.ExtensionLoader
public T getExtension(String name) {

    // 非空验证，疏忽
    if (StringUtils.isEmpty(name)) {throw new IllegalArgumentException("Extension name == null");
    }
    
    // 默认机制，会去找名称为 dubbo 的实例
    // 个别用不到
    if ("true".equals(name)) {return getDefaultExtension();
    }
    
    // 如果之前不存在这个名称对应的 Holder 对象，此处会创立一个空白的 Holder
    // 调用 get() 办法会取得空对象
    final Holder<Object> holder = getOrCreateHolder(name);
    Object instance = holder.get();
    if (instance == null) {synchronized (holder) {instance = holder.get();
            if (instance == null) {
                // 创建对象实例，并装进 holder 中
                instance = createExtension(name);
                holder.set(instance);
            }
        }
    }
    // 返回实例
    return (T) instance;
}

// org.apache.dubbo.common.extension.ExtensionLoader
private T createExtension(String name) {

    // 如果 class 不存在就报错
    Class<?> clazz = getExtensionClasses().get(name);
    if (clazz == null) {throw findException(name);
    }
    
    try {
        // 尝试获取 class 对应的实例，如果不存在就创立
        T instance = (T) EXTENSION_INSTANCES.get(clazz);
        if (instance == null) {EXTENSION_INSTANCES.putIfAbsent(clazz, clazz.newInstance());
            instance = (T) EXTENSION_INSTANCES.get(clazz);
        }
        
        // 进行依赖注入
        injectExtension(instance);
        Set<Class<?>> wrapperClasses = cachedWrapperClasses;
        if (CollectionUtils.isNotEmpty(wrapperClasses)) {for (Class<?> wrapperClass : wrapperClasses) {instance = injectExtension((T) wrapperClass.getConstructor(type).newInstance(instance));
            }
        }
        initExtension(instance);
        return instance;
    } catch (Throwable t) {
        throw new IllegalStateException("Extension instance (name:" + name + ", class:" +
                                        type + ") couldn't be instantiated: " + t.getMessage(), t);
    }
}

spi 的代码有点绕，做一下总结。

ExtensionLoader 是整个 spi 零碎的门面，也是 spi 的实例联合类。

内置对象

EXTENSION_LOADERS

记录了 class 和 loader 的对应关系

EXTENSION_INSTANCES

记录了 class 和实例对象的对应关系。能够认为是一个动态的全局 bean 容器。

次要办法

getExtensionLoader(Class)

尝试创立这个 class 对应的 loader 对象；
然而在创立个别 spi 接口的 loader 对象之前，还会先创立 ExtensionFactory 的 loader 对象。

getExtension(String)

依照需要实例化对象，搁置到 EXTENSION_INSTANCES 对象中，而后做依赖注入并返回给使用者。

用来做依赖注入的工厂。
ExtensionFactory 也是被 ExtensionLoader 治理的一类非凡的 spi 类。

dubbo 的 spi 还有很重要的一部分即为 @Adaptive 注解的应用，这部分波及动静代理，较为简单，有空开新篇讲。

本文仅为集体的学习笔记，可能存在谬误或者表述不清的中央，有缘补充

正文完

java

发表至： java

2020-10-20

0

关于java:Docker全攻略pdf

通用文件服务组件Netty实现版本

关于java:珠联壁合地设天造M1-Mac-os基于vscode打造Java开发环境集成Springboot

关于java:24岁零基础自学编程先学哪种语言最好

关于ci:gitlab-钩子

关于java:追踪解析-Dubbo-的-Spi-机制源码

零后期筹备

0 FBI WARNING

1 版本

2 Spi 简介

3 Demo

3.1 须要扩大的接口类

3.2 接口实现类

一 getExtensionLoader

1 getExtensionLoader

2 ExtensionLoader 结构器

二 getAdaptiveExtension

1 getAdaptiveExtension

2 createAdaptiveExtension

3 injectExtension

三 ExtensionFactory

1 AdaptiveExtensionFactory

2 SpiExtensionFactory

四 getExtension

1 getExtension

2 createExtension

五一点唠叨

1 总结

ExtensionLoader

ExtensionFactory

2 未实现

站内搜索

关于java:追踪解析-Dubbo-的-Spi-机制源码

零 后期筹备

0 FBI WARNING

1 版本

2 Spi 简介

3 Demo

3.1 须要扩大的接口类

3.2 接口实现类

一 getExtensionLoader

1 getExtensionLoader

2 ExtensionLoader 结构器

二 getAdaptiveExtension

1 getAdaptiveExtension

2 createAdaptiveExtension

3 injectExtension

三 ExtensionFactory

1 AdaptiveExtensionFactory

2 SpiExtensionFactory

四 getExtension

1 getExtension

2 createExtension

五 一点唠叨

1 总结

ExtensionLoader

ExtensionFactory

2 未实现

站内搜索

零后期筹备

五一点唠叨