Dubbo源码解析之SPI(1):扩展类的加载过程

Stella981
• 阅读 677

Dubbo源码解析之SPI(1):扩展类的加载过程

Dubbo是一款开源的、高性能且轻量级的Java RPC框架,它提供了三大核心能力:面向接口的远程方法调用、智能容错和负载均衡,以及服务自动注册和发现。

Dubbo最早是阿里公司内部的RPC框架,于 2011 年开源,之后迅速成为国内该类开源项目的佼佼者,2018年2月,通过投票正式成为 Apache基金会孵化项目。目前宜信公司内部也有不少项目在使用Dubbo。

本系列文章通过拆解Dubbo源码,帮助大家了解Dubbo,做到知其然,并且知其所以然。

一、JDK SPI

1.1 什么是SPI?

SPI(Service Provider Interface),即服务提供方接口,是JDK内置的一种服务提供机制。 在写程序的时候,一般都推荐面向接口编程,这样做的好处是:降低了程序的耦合性,有利于程序的扩展。

SPI也秉承这种理念,提供了统一的服务接口,服务提供商可以各自提供自己的具体实现。 大家都熟知的JDBC中用的就是基于这种机制来发现驱动提供商,不管是Oracle也好,MySQL也罢,在编写代码时都一样,只不过引用的jar包不同而已。后来这种理念也被运用于各种架构之中,比如Dubbo、Eleasticsearch。

1.2 JDK SPI的小栗子

SPI 的实现方式是将接口实现类的全限定名配置在文件中,由服务加载器读取配置文件,加载实现类。

了解了概念后,来看一个具体的例子。

1)定义一个接口

public interface Operation {        int operate(int num1, int num2);}

2)写两个简单的实现

public class DivisionOperation implements Operation {        public int operate(int num1, int num2) {            System.out.println("run division operation");            return num1/num2;        }}

3)添加一个配置文件

在ClassPath路径下添加一个配置文件,文件名字是接口的全限定类名,内容是实现类的全限定类名,多个实现类用换行符分隔。

  • 目录结构

Dubbo源码解析之SPI(1):扩展类的加载过程

  • 文件内容

    com.api.impl.DivisionOperationcom.api.impl.PlusOperation

4)测试程序

public class JavaSpiTest {    @Test    public void testOperation() throws Exception {        ServiceLoader<Operation> operations = ServiceLoader.load(Operation.class);        operations.forEach(item->System.out.println("result: " + item.operate(2, 2)));    }}

5)测试结果

run division operationresult:1run plus operationresult:4

1.3 JDK SPI的源码分析

例子很简单,实现的话,可以大胆猜测一下,看名字“ServiceLoader”应该就是用类加载器根据接口的类型加上配置文件里的具体实现名字将实现加载了进来。

接下来通过分析源码进一步了解其实现原理。

1.3.1 ServiceLoader类

PREFIX定义了加载路径,reload方法初始化了LazyIterator,LazyIterator是加载的核心,真正实现了加载。加载的模式从名字上就可以看出,是懒加载的模式,只有当真正调用迭代时才会加载。

Dubbo源码解析之SPI(1):扩展类的加载过程

1.3.2 hasNextService方法

LazyIterator中的hasNextService方法负责加载配置文件和解析具体的实现类名。

Dubbo源码解析之SPI(1):扩展类的加载过程

1.3.3 nextService方法

LazyIterator中的nextService方法负责用反射加载实现类。

Dubbo源码解析之SPI(1):扩展类的加载过程

看完了源码,感觉这个代码是有优化空间的,实例化所有实现其实没啥必要,一来比较耗时,二来浪费资源。 Dubbo就没有使用Java原生的SPI机制,而是对其进行了增强,使其能够更好地满足需求。

二、Dubbo SPI

2.1 Dubbo SPI的小栗子

老习惯,在拆解源码之前,先来个栗子。此处示例是在前文例子的基础上稍做了些修改。

1)定义一个接口

修改接口,加上了Dubbo的@SPI注解。

@SPIpublic interface Operation {        int operate(int num1, int num2);}

2)写两个简单的实现

沿用之前的两个实现类。

3)添加一个配置文件

新增配置文件放在dubbo目录下。

  • 目录结构

Dubbo源码解析之SPI(1):扩展类的加载过程

  • 文件内容

    division=com.api.impl.DivisionOperationplus=com.api.impl.PlusOperation

4)测试程序

public class DubboSpiTest {    @Test    public void testOperation() throws Exception {          ExtensionLoader<Operation> loader = ExtensionLoader.getExtensionLoader(Operation.class);          Operation division = loader.getExtension("division");          System.out.println("result: " + division.operate(1, 2));    }}

5)测试结果

run division operationresult:0

2.2 Dubbo SPI源码

上面的测试例子也很简单,和JDK原生的SPI对比来看,Dubbo的SPI可以根据配置的kv值来获取。在没有拆解源码之前,考虑一下如何实现。

我可能会用双层Map来实现缓存: 第一层的key为接口的class对象,value为一个map;第二层的key为扩展名(配置文件中的key),value为实现类的class。实现懒加载的方式,当运行方法的时候创建空map。在真正获取时先从缓存中查找具体实现类的class对象,找得到就直接返回、找不到就根据配置文件加载并缓存。

Dubbo又是如何实现的呢?

2.2.1 getExtensionLoader方法

首先来拆解getExtensionLoader方法。

Dubbo源码解析之SPI(1):扩展类的加载过程

这是一个静态的工厂方法,要求传入的类型必须为接口并且有SPI的注解,用map做了个缓存,key为接口的class对象,而value是 ExtensionLoader对象。

2.2.2 getExtension方法

再来拆解ExtensionLoader的getExtension方法。

Dubbo源码解析之SPI(1):扩展类的加载过程

这段代码也不复杂,如果传入的参数为'true',则返回默认的扩展类实例;否则,从缓存中获取实例,如果有就从缓存中获取,没有的话就新建。用map做缓存,缓存了holder对象,而holder对象中存放扩展类。用volatile关键字和双重检查来应对多线程创建问题,这也是单例模式的常用写法。

2.2.3 createExtension方法

重点分析createExtension方法。

Dubbo源码解析之SPI(1):扩展类的加载过程

这段代码由几部分组成:

  • 根据传入的扩展名获取对应的class。

  • 根据class去缓存中获取实例,如果没有的话,通过反射创建对象并放入缓存。

  • 依赖注入,完成对象实例的初始化。

  • 创建wrapper对象。也就是说,此处返回的对象不一定是具体的实现类,可能是包装的对象。

第二个没啥好说的,我们重点来分析一下1、3、4三个部分。

1)getExtensionClasses方法

Dubbo源码解析之SPI(1):扩展类的加载过程

老套路,从缓存获取,没有的话创建并加入缓存。这里缓存的是一个扩展名和class的关系。这个扩展名就是在配置文件中的key。创建之前,先缓存了一下接口的限定名。加载配置文件的路径是以下这几个。

Dubbo源码解析之SPI(1):扩展类的加载过程

2)loadDirectory方法

Dubbo源码解析之SPI(1):扩展类的加载过程

获取配置文件路径,获取classLoader,并使用loadResource方法做进一步处理。

3)loadResource方法

Dubbo源码解析之SPI(1):扩展类的加载过程

Dubbo源码解析之SPI(1):扩展类的加载过程

loadResource加载了配置文件,并解析了配置文件中的内容。loadClass 方法操作了不同的缓存。

首先判断是否有Adaptive注解,有的话缓存到cacheAdaptiveClass(缓存结构为class);然后判断是否wrapperclasses,是的话缓存到cacheWrapperClass中(缓存结构为Set);如果以上都不是,这个类就是个普通的类,存储class和名称的映射关系到cacheNames里(缓存结构为Map)。

基本上getExtensionClasses方法就分析完了,可以看出来,其实并不是很复杂。

2.2.4 IOC

1)injectExtension方法

Dubbo源码解析之SPI(1):扩展类的加载过程

这个方法实现了依赖注入,即IOC。首先通过反射获取到实例的方法;然后遍历,获取setter方法;接着从objectFactory中获取依赖对象;最后通过反射调用setter方法注入依赖。

objectFactory的变量类型为AdaptiveExtensionFactory。

2)AdaptiveExtensionFactory

Dubbo源码解析之SPI(1):扩展类的加载过程

这个类里面有个ExtensionFactory的列表,用来存储其他类型的 ExtensionFactory。Dubbo提供了两种ExtensionFactory,一种是SpiExtensionFactory, 用于创建自适应的扩展;另一种是SpringExtesionFactory,用于从Spring的IOC容器中获取扩展。配置文件一个在dubbo-common模块,一个在dubbo-config模块。

  • 配置文件

Dubbo源码解析之SPI(1):扩展类的加载过程

Dubbo源码解析之SPI(1):扩展类的加载过程

SpiExtensionFactory中的Spi方式前面已经解析过了。

Dubbo源码解析之SPI(1):扩展类的加载过程

SpringExtesionFactory是从ApplicationContext中获取对应的实例。先根据名称查找,找不到的话,再根据类型查找。

Dubbo源码解析之SPI(1):扩展类的加载过程

依赖注入的部分也拆解完毕,看看这次拆解的最后一部分代码。

2.2.5 AOP

创建wrapper对象的部分,wrapper对象是从哪里来的呢?还记得之前拆解的第一步么,loadClass方法中有几个缓存,其中wrapperclasses就是缓存这些wrapper的class。

Dubbo源码解析之SPI(1):扩展类的加载过程

从代码中可以看出,只要构造方法里有且只有唯一参数,同时此参数为当前传入的接口类型,即为wrapper class。

Dubbo源码解析之SPI(1):扩展类的加载过程

此处循环创建wrapper实例,首先将instance做为构造函数的参数,通过反射来创建wrapper对象,然后再向wrapper中注入依赖。

看到这里,可能会有人有疑问:为什么要创建一个wrapper对象?其实很简单,系统要在真正调用的前后干点别的事呗。这个就有点类似于spring的aop了。

三、总结

本文简单介绍了JDK的SPI和Dubbo的SPI用法,分析了JDK的SPI源码和Dubbo的SPI源码。在拆解的过程中可以看出,Dubbo的源码还是很值得一读的。在实现方面考虑得很周全,不仅有对多线程的处理、多层缓存,也有IOC、AOP的过程。不过,Dubbo的SPI就这么简单么?当然不是,这篇只拆解了扩展类的加载过程,Dubbo的SPI中还有个很复杂的扩展点-自适应机制。欲知后事如何,请听下回分解~~

本文作者:宜信支付结算部支付研发团队Java研发高级工程师郑祥斌

原文首发于支付结算团队技术公众号「野指针」

>>>>活动推荐

2020年5月29日,北京,Gdevops全球敏捷运维峰会将开启年度首站!重点围绕数据库、智慧运维、Fintech金融科技领域,dbaplus携手阿里、腾讯等技术代表,展望云时代下数据库发展趋势、破解运维转型困局。

Dubbo源码解析之SPI(1):扩展类的加载过程


⭐️⭐️⭐️欢迎加入“宜信技术交流群”。进群方式:请加小助手微信(微信号:18910316664)。

◆ ◆ ◆ ◆ ◆

如需转载请与小助手(微信号:18910316664)联系。****发现文章有错误、对内容有疑问,都可以通过关注宜信技术学院微信公众号(CE_TECH),在后台留言给我们。我们每周会挑选出一位热心小伙伴,送上一份精美的小礼品。快来扫码关注我们吧!

Dubbo源码解析之SPI(1):扩展类的加载过程

⏬点击“阅读原文”查看更多技术干货

Dubbo源码解析之SPI(1):扩展类的加载过程

本文分享自微信公众号 - 宜信技术学院(CE_TECH)。
如有侵权,请联系 support@oschina.cn 删除。
本文参与“OSC源创计划”,欢迎正在阅读的你也加入,一起分享。

点赞
收藏
评论区
推荐文章
blmius blmius
3年前
MySQL:[Err] 1292 - Incorrect datetime value: ‘0000-00-00 00:00:00‘ for column ‘CREATE_TIME‘ at row 1
文章目录问题用navicat导入数据时,报错:原因这是因为当前的MySQL不支持datetime为0的情况。解决修改sql\mode:sql\mode:SQLMode定义了MySQL应支持的SQL语法、数据校验等,这样可以更容易地在不同的环境中使用MySQL。全局s
皕杰报表之UUID
​在我们用皕杰报表工具设计填报报表时,如何在新增行里自动增加id呢?能新增整数排序id吗?目前可以在新增行里自动增加id,但只能用uuid函数增加UUID编码,不能新增整数排序id。uuid函数说明:获取一个UUID,可以在填报表中用来创建数据ID语法:uuid()或uuid(sep)参数说明:sep布尔值,生成的uuid中是否包含分隔符'',缺省为
待兔 待兔
4个月前
手写Java HashMap源码
HashMap的使用教程HashMap的使用教程HashMap的使用教程HashMap的使用教程HashMap的使用教程22
Jacquelyn38 Jacquelyn38
3年前
2020年前端实用代码段,为你的工作保驾护航
有空的时候,自己总结了几个代码段,在开发中也经常使用,谢谢。1、使用解构获取json数据let jsonData  id: 1,status: "OK",data: 'a', 'b';let  id, status, data: number   jsonData;console.log(id, status, number )
Wesley13 Wesley13
3年前
mysql设置时区
mysql设置时区mysql\_query("SETtime\_zone'8:00'")ordie('时区设置失败,请联系管理员!');中国在东8区所以加8方法二:selectcount(user\_id)asdevice,CONVERT\_TZ(FROM\_UNIXTIME(reg\_time),'08:00','0
Stella981 Stella981
3年前
Dubbo源码解析之SPI(一):扩展类的加载过程
Dubbo是一款开源的、高性能且轻量级的JavaRPC框架,它提供了三大核心能力:面向接口的远程方法调用、智能容错和负载均衡,以及服务自动注册和发现。Dubbo最早是阿里公司内部的RPC框架,于2011年开源,之后迅速成为国内该类开源项目的佼佼者,2018年2月,通过投票正式成为Apache基金会孵化项目。目前宜信公司内部也有不少项目在使用Dub
Wesley13 Wesley13
3年前
00:Java简单了解
浅谈Java之概述Java是SUN(StanfordUniversityNetwork),斯坦福大学网络公司)1995年推出的一门高级编程语言。Java是一种面向Internet的编程语言。随着Java技术在web方面的不断成熟,已经成为Web应用程序的首选开发语言。Java是简单易学,完全面向对象,安全可靠,与平台无关的编程语言。
Stella981 Stella981
3年前
Django中Admin中的一些参数配置
设置在列表中显示的字段,id为django模型默认的主键list_display('id','name','sex','profession','email','qq','phone','status','create_time')设置在列表可编辑字段list_editable
Wesley13 Wesley13
3年前
MySQL部分从库上面因为大量的临时表tmp_table造成慢查询
背景描述Time:20190124T00:08:14.70572408:00User@Host:@Id:Schema:sentrymetaLast_errno:0Killed:0Query_time:0.315758Lock_
Python进阶者 Python进阶者
10个月前
Excel中这日期老是出来00:00:00,怎么用Pandas把这个去除
大家好,我是皮皮。一、前言前几天在Python白银交流群【上海新年人】问了一个Pandas数据筛选的问题。问题如下:这日期老是出来00:00:00,怎么把这个去除。二、实现过程后来【论草莓如何成为冻干莓】给了一个思路和代码如下:pd.toexcel之前把这