提到dubbo必须提到SPI。网络上有很多介绍SPI原理的文章,我不多介绍了。我介绍一下SPI的流程。官方文档介绍:
http://dubbo.apache.org/zh-cn/docs/source_code_guide/dubbo-spi.html
SPI提供了一种插件功能,对于服务组件可以替换。dubbo的各层中,除了服务代理层和配置层之外,其他层组件都可以使用SPI替换。
下面的流程图以代码ExtensionLoader.getExtensionLoader(Container.class).getExtension("spring")为例。
上图中提到的搜索文件和目录可以参考代码ExtensionLoader.loadExtensionClasses,这个方法指定了搜索目录:
META-INF/dubbo/internal/
META-INF/dubbo/
META-INF/services/
搜索的文件名为ExtensionLoader.getExtensionLoader方法入参的全限定类名。例如入参Container.class,那么对应的文件名是org.apache.dubbo.container.Container。
当我们要搜索的内容不在文件中时,比如搜索数据库,可以重写loadExtensionClasses方法查询数据库。不过这样我们需要修改源代码。
文件org.apache.dubbo.container.Container里面的内容如下:
spring=org.apache.dubbo.container.spring.SpringContainer
log4j=org.apache.dubbo.container.log4j.Log4jContainer
logback=org.apache.dubbo.container.logback.LogbackContainer
方法getExtension的入参是文件里面每一行等号前面的值。
方法getExtensionLoader的入参为接口,要使用SPI加载对象,接口必须有SPI注解。SPI注解的value值表示要加载对象的默认名字。可以使用getDefaultExtension方法加载默认名字对应的对象。比如Container接口默认对象名字是spring,如果使用getDefaultExtension方法加载对象,那么和getExtension("spring")加载的对象是一样的。
除了getDefaultExtension,getExtension方法,还有getActivateExtension和getAdaptiveExtension。
getActivateExtension可以加载多个对象,可以参考接口Filter。要求接口的实现类必须有Activate注解,如果注解的value和group与getActivateExtension入参一致,那么getActivateExtension方法会返回一个List集合。
getAdaptiveExtension方法一般会通过代码生成模块生成一个Adaptive类型的类,并实例化对象。代码生成是AdaptiveClassCodeGenerator类完成的。Adaptive类型的类方法需要有Adaptive注解,没有Adaptive注解的方法在自动生成的代码里面会抛出UnsupportedOperationException。Adaptive类型的对象是自适应对象,Adaptive注解的方法入参是URL或者包含URL属性的对象,Adaptive注解的value值为URL的属性名,属性名对应的值就是要加载的对象名,如果URL中不包含Adaptive注解指定的值,那么使用Adaptive类型类的接口的SPI注解的value值作为默认值。