dubbo源码分析-ExtensionLoader发现机制和Adaptive注解应用

最新推荐文章于 2020-11-03 11:38:01 发布

matthew_zhang

最新推荐文章于 2020-11-03 11:38:01 发布

阅读量4.3k

点赞数 3

CC 4.0 BY-SA版权

分类专栏： Dubbo源码-Java进阶 Java开发 Spring 文章标签： dubbo 源码扩展

本文链接：https://blog.youkuaiyun.com/matthew_zhang/article/details/68966051

Java开发同时被 3 个专栏收录

15 篇文章

订阅专栏

Spring

6 篇文章

订阅专栏

Dubbo源码-Java进阶

4 篇文章

订阅专栏

Dubbo的灵活性体现在每个系统功能点都可以动态扩展为新的实现，而且只需要额外配置，不需要修改dubbo源码，非常符合面向对象设计的开闭原则，其实现原理利用了JDK5.0的自动发现机制，具体使用相关代码是ExtensionLoader

本文目的：对Dubbo使用ExtensionLoader动态加载扩展点相关源码实现介绍

面向读者：要求对dubbo的扩展点ExtensionLoader使用有基本的了解

背景介绍：官网链接-扩展点加载
- 扩展点配置
- 扩展点自适应

示例代码：来源于Dubbo源码，Git链接

相关术语：
扩展点 Extension - 可以理解为扩展某功能接口的实现类

关于扩展点配置

Dubbo的扩展点加载从JDK标准的SPI(Service Provider Interface)扩展点发现机制加强而来。具体在Dubbo应用实现如下。

服务加载配置文件位于下面目录：
这里写图片描述

代码能找到配置文件，是由下面相关代码定义的：

public class ExtensionLoader<T> {
    private static final Logger logger = LoggerFactory.getLogger(ExtensionLoader.class);
    private static final String SERVICES_DIRECTORY = "META-INF/services/";
    private static final String DUBBO_DIRECTORY = "META-INF/dubbo/";
    private static final String DUBBO_INTERNAL_DIRECTORY = DUBBO_DIRECTORY + "internal/";

如何根据扩展名加载对应实现类

具体例子：下面就是根据扩展名“mymock”加载对应类MockFilter：

 MockFilter filter = (MockFilter)ExtensionLoader.getExtensionLoader(Filter.class).getExtension("mymock");

“mymock”就是指定名字，定义在配置文件内：
mymock=com.alibaba.dubbo.config.spring.filter.MockFilter

其中这里的约定：MockFilter是接口Filter的实现类，文件名
com.alibaba.dubbo.rpc.Filter意思是接口类Filter在包com.alibaba.dubbo.rpc下
目录结构：
这里写图片描述

Dubbo注解@Adaptive用法

-加载扩展点时，扩展点实现类的成员如果为其它扩展点类型，ExtensionLoader在会自动注入依赖的扩展点。
-ExtensionLoader通过扫描扩展点实现类的所有set方法来判定其成员。
即ExtensionLoader会执行扩展点的拼装操作。
-ExtensionLoader注入的依赖扩展点是一个Adaptive实例，直到扩展点方法执行时才决定调用是一个扩展点实现。

1）Adaptive注解定义：

...
public @interface Adaptive {
...
    String[] value() default {};
}

2）接口例子

@SPI("netty")
public interface Transporter {
@Adaptive({Constants.SERVER_KEY, Constants.TRANSPORTER_KEY})
    Server bind(URL url, ChannelHandler handler) throws RemotingException;
...
...
}

这些注解在代码中如何发挥作用？

ExtensionLoader的createAdaptiveExtensionClassCode()方法根据注解@Adaptive的key值注入对应实现类。

● 首先知道ExtensionLoader注入的依赖扩展点是一个Adaptive实例，直到扩展点方法执行时才决定调用是哪一个扩展点实现。

● Dubbo使用URL对象（包含了Key-Value）传递配置信息。key是在配置xml里的定义使用，例如xml指定server = value，则key是‘server’, 然后Adaptive实例代码中指定加载的扩展名extName为value,根据此加载对应实现类。

几点注意：
1）Adaptive实例的代码是由createAdaptiveExtensionClassCode()方法动态产生的。
2）”直到扩展点方法执行时才决定调用是哪一个扩展点实现”, 这句话理解为Adaptive代码中会根据extName扩展名指定加载对应实现类。
3）URL封装的信息里可能含有从配置文件xml传递过来的key=value信息，假如没有，则extName取接口类的注解@SPI(“netty”)中指定的名字,例如这里是extName为Netty，这段逻辑代码如下图部分片段：

java.lang.reflect.Method 对象反射获取注解：
 ...
 Adaptive adaptiveAnnotation = method.getAnnotation(Adaptive.class);
 ...
 ...
 String[] value = adaptiveAnnotation.value();
 ...

这里写图片描述