Dubbo源码(一) - SPI使用
为什么学SPI
Dubbo 的可扩展性是基于 SPI 去实现的,而且Dubbo所有的组件都是通过 SPI 机制加载。
什么是SPI
SPI 全称为 (Service Provider Interface) ,是一种服务提供发现机制。可以将服务接口与服务实现分离以达到解耦可拔插、大大提升了程序可扩展性。
说人话:
一个接口有多个实现类,具体使用哪个实现类,通过SPI机制让用户来决定。也就是,定好规范,实现允许百花齐放。
举栗子:
以JDBC为例,Java提供了JDBC API用来连接 Java 编程语言和广泛的数据库。可是数据库种类这么多,无法一个个地去适配,怎么办?定好规范(Driver
等一系列接口),实现类交由别人实现。
那么,实现类也有了,JDBC怎么知道该使用什么实现类(毕竟命名可以千奇百怪)?通过SPI
Java SPI
简单体验下,Dubbo SPI才是重点
编写测试接口和实现类(我的代码是放在
com.javaedit.javaspi
包)// 定义接口
public interface Color {
String getName();
} // 两个实现类
public class BlueColor implements Color{
@Override
public String getName() {
return "blue";
}
} public class RedColor implements Color {
@Override
public String getName() {
return "red";
}
}
SPI配置文件
在META-INF/services/目录下创建配置文件,文件名格式为接口的全限定名
配置文件的内容为实现类的全限定的类名
com.javaedit.javaspi.RedColor
com.javaedit.javaspi.BlueColor
运行测试代码
public class TestDemo {
public static void main(String[] args) {
ServiceLoader<Color> colors = ServiceLoader.load(Color.class);
for (Color color : colors) {
System.out.println(color.getName());
}
}
}
效果输出:
red
blue
Dubbo SPI
基本示例
@SPI
:此注解表示这是一个SPI接口,标注在类上。
基本使用
编写测试接口和实现类(我的类在com.javaedit.spi包下)
接口必须添加SPI注解
package com.javaedit.spi;
import com.alibaba.dubbo.common.URL; @SPI // 必须添加SPI注解
public interface Robot {
@Adaptive("robot")
void sayHello(URL url);
} // 实现类
public class RobotImpl implements Robot {
@Override
public void sayHello(URL url) {
System.out.println("大家好,我是普通机器人...");
}
}
配置文件
在指定目录下创建配置文件,文件名格式为接口的全限定名(此处为com.javaedit.spi.Robot)
指定目录有3个,分别为:
META-INF/dubbo/internal
META-INF/dubbo
META-INF/services
文件内容为:
norRobot = com.javaedit.spi.RobotImpl
测试方法
public static void main(String[] args) {
ExtensionLoader<Robot> extensionLoader = ExtensionLoader.getExtensionLoader(Robot.class);
// 这里的name需要和配置文件中的key保持一致
String name = "norRobot";
Robot robot = extensionLoader.getExtension(name);
robot.sayHello(null);
}
碎碎念:
@SPI注解有value参数,可以配置默认实现类的key,例如:
// 接口的注解添加默认值
@SPI("norRobot")
// 获取实现类时将getExtension替换一下
// Robot robot = extensionLoader.getExtension("norRobot");
Robot robot = extensionLoader.getDefaultExtension();
包装类
Dubbo SPI提供了类似装饰器模式的实现
在基本使用的代码基础上,增加包装类
public class RobotWrapper implements Robot { private Robot robot; // 带Robot参数的构造方法,这是包装类的重点
public RobotWrapper(Robot robot) {
this.robot = robot;
} @Override
public void sayHello(URL url) {
System.out.println("wrapper before...");
this.robot.sayHello(url);
System.out.println("wrapper after...");
}
}
配置文件中增加包装类的配置
norRobot = com.javaedit.spi.RobotImpl
wrapper = com.javaedit.spi.RobotWrapper
测试类不变
输出结果
wrapper before...
大家好,我是普通机器人...
wrapper after...
碎碎念:
原理就是RobotWrapper
只要有构造方法是有且只有一个参数,且这个参数是Robot
类型,就认为其实包装类,会自动将Robot通过构造方法注入。
所以getExtension("norRobot")
实际返回的是RobotWrapper
自适应扩展
有些拓展并不想在框架启动阶段被加载,而是希望在拓展方法被调用时,根据运行时参数进行加载。这就是Dubbo SPI自适应扩展的作用。
@Adaptive
:此注解用于自适应扩展,可标注在类或者方法上。
类的自适应扩展
新增自适应类
@Adaptive // 注意,注解在实现类上
public class AdaptiveRobot implements Robot {
@Override
public void sayHello(URL url) {
System.out.println("标注在类上的自适应代理类,类名:" + this.getClass().getSimpleName());
}
}
测试代码
public static void main(String[] args) {
ExtensionLoader<Robot> extensionLoader = ExtensionLoader.getExtensionLoader(Robot.class);
// 不用再指定key
Robot robot = extensionLoader.getAdaptiveExtension();
robot.sayHello(null); // 此时的robot是AdaptiveRobot
}}
当@Adaptive
标注在类上时,无需通过key指定需要获取的实现类,通过getAdaptiveExtension方法即可获取自适应扩展类。同一个接口,有且只能有一个实现类允许使用@Adaptive
标注
方法的自适应扩展
注意:@Adaptive
标注在类上和标注在方法上是冲突的,将上一步的AdaptiveRobot删除,或者把AdaptiveRobot类的Adaptive注解注释掉
修改Robot接口,给sayHello方法添加
@Adaptive
注解。注意,是接口,不是实现类。@SPI
public interface Robot {
@Adaptive("robotAda") // robotAda是名字,随意
void sayHello(URL url);
}
测试代码
public static void main(String[] args) {
ExtensionLoader<Robot> extensionLoader = ExtensionLoader.getExtensionLoader(Robot.class);
Map<String, String> map = new HashMap<>();
map.put("robotAda", "norRobot");
URL url = new URL("", "", 1, map);
Robot robot = extensionLoader.getAdaptiveExtension();
robot.sayHello(url); // 此时的robot是Robot$Adaptive,但是实际调用的是RobotImpl的sayHello
}}
当
@Adaptive
标注在方法上时,getAdaptiveExtension获取的是动态生成的自适应扩展类,固定类名是 接口名$Adaptive,下面我们来看看自动生成的Robot$Adaptive长什么样Robot$Adaptive,此类是动态生成的
public class Robot$Adaptive implements com.javaedit.spi.Robot {
public void sayHello(com.alibaba.dubbo.common.URL arg0) {
if (arg0 == null) throw new IllegalArgumentException("url == null");
com.alibaba.dubbo.common.URL url = arg0;
// 从url中获取robotAda参数,也就是extName = "norRobot"
String extName = url.getParameter("robotAda");
if (extName == null)
throw new IllegalStateException("Fail to get extension(com.javaedit.spi.Robot) name from url(" + url.toString() + ") use keys([robot])");
// 获取norRobot,也就是RobotImpl类
com.javaedit.spi.Robot extension = (com.javaedit.spi.Robot) ExtensionLoader.getExtensionLoader(com.javaedit.spi.Robot.class).getExtension(extName);
// 调用norRobot的sayHello方法
extension.sayHello(arg0);
}
}
Robot$Adaptive的sayHello会动态从URL参数中获取实际要调用的Robot实现类,这样就实现了根据运行时参数进行加载的功能。
碎碎念:
动态选择实现类,是需要通过URL来传递参数的。也就是方法参数中需要包含URL对象或者方法参数中有getUrl()方法来提供URL对象。
IOC
Dubbo SPI也支持类似spring自动注入的功能,来看看怎么用。
新增需要自动注入的类
public class IocRobotImpl implements Robot { private Robot robot;
// 只要带set开头的方法,都会被判断是否需要自动注入
public void setRobot(Robot robot) {
this.robot = robot;
} @Override
public void sayHello(URL url) {
System.out.println("ioc start");
robot.sayHello(url);
}
}
setRobot方法注入的robot是通过自适应扩展方法getAdaptiveExtension获取的
测试类
public static void main(String[] args) {
ExtensionLoader<Robot> extensionLoader = ExtensionLoader.getExtensionLoader(Robot.class);
Map<String, String> map = new HashMap<>();
map.put("robot", "norRobot");
URL url = new URL("", "", 1, map);
Robot robot = extensionLoader.getExtension("iocRobot");
robot.sayHello(url);
}
输出结果:
ioc start
大家好,我是普通机器人...由输出结果看到,setRobot注入的是norRobot,而norRobot自适应扩展从URL中获取的。
碎碎念:
Dubbo SPI的自动注入,也支持注入Spring的bean,此处没有演示。
总结
本文讲了Java SPI和Dubbo SPI的使用,至于DubboSPI的实现,请看下回分解。
Dubbo源码(一) - SPI使用的更多相关文章
- Dubbo源码(二) - SPI源码
前情提要 假设你已经知道Dubbo SPI的使用方式,不知道的请出门左转: Dubbo源码(一) - SPI使用 Dubbo源码地址: apache/dubbo 本文使用版本:2.6.x 测试Demo ...
- Dubbo 源码分析 - SPI 机制
1.简介 SPI 全称为 Service Provider Interface,是 Java 提供的一种服务发现机制.SPI 的本质是将接口实现类的全限定名配置在文件中,并由服务加载器读取配置文件,加 ...
- dubbo源码解析-spi(4)
前言 本篇是spi的第四篇,本篇讲解的是spi中增加的AOP,还是和上一篇一样,我们先从大家熟悉的spring引出AOP. AOP是老生常谈的话题了,思想都不会是一蹴而就的.比如架构设计从All in ...
- dubbo源码解析-spi(3)
前言 在上一篇的末尾,我们提到了dubbo的spi中增加了IoC和AOP的功能.那么本篇就讲一下这个增加的IoC,spi部分预计会有四篇,因为这东西实在是太重要了.温故而知新,我们先来回顾一下,我们之 ...
- dubbo源码解析-spi(一)
前言 虽然标题是dubbo源码解析,但是本篇并不会出现dubbo的源码,本篇和之前的dubbo源码解析-简单原理.与spring融合一样,为dubbo源码解析专题的知识预热篇. 插播面试题 你是否了解 ...
- dubbo源码解析-spi(二)
前言 上一篇简单的介绍了spi的基本一些概念,在末尾也提到了,dubbo对jdk的spi进行了一些改进,具体改进了什么,来看看文档的描述 JDK 标准的 SPI 会一次性实例化扩展点所有实现,如果有扩 ...
- Dubbo 源码分析 - 服务调用过程
注: 本系列文章已捐赠给 Dubbo 社区,你也可以在 Dubbo 官方文档中阅读本系列文章. 1. 简介 在前面的文章中,我们分析了 Dubbo SPI.服务导出与引入.以及集群容错方面的代码.经过 ...
- Dubbo 源码分析 - 集群容错之 LoadBalance
1.简介 LoadBalance 中文意思为负载均衡,它的职责是将网络请求,或者其他形式的负载"均摊"到不同的机器上.避免集群中部分服务器压力过大,而另一些服务器比较空闲的情况.通 ...
- Dubbo 源码分析 - 集群容错之 Cluster
1.简介 为了避免单点故障,现在的应用至少会部署在两台服务器上.对于一些负载比较高的服务,会部署更多台服务器.这样,同一环境下的服务提供者数量会大于1.对于服务消费者来说,同一环境下出现了多个服务提供 ...
随机推荐
- Android8.0 后台服务保活的一种思路
原文地址:Android8.0 后台服务保活的一种思路 | Stars-One的杂货小窝 项目中有个MQ服务,需要一直连着,接收到消息会发送语音,且手机要在锁屏也要实现此功能 目前是使用广播机制实现, ...
- 中间件漏洞之Nginx
中间件漏洞之Nginx 我们常见的中间件有IIS.Apache.Nginx,其中Nginx中间件有什么漏洞呢? Nginx 文件名逻辑漏洞(CVE-2013-4547): 漏洞版本: Nginx 0. ...
- 使用WebDriverManager实现自动获取浏览器驱动程序
原理: 自动到指定的地址下载相应的浏览器驱动保存到缓存区 ~/.cache/selenium 痛点: 解决因Chrome浏览器升级,driver需要同步升级,要重新下载驱动的问题 区别: 传统方式 需 ...
- 谈谈markdown
谈谈markdown 欢迎关注我的博客,️点他即可. 最近一年开始学习有关编程的内容了. 迷上代码的我开始接触到一些好玩的东西,我发现很多事情都可以由代码来完成,甚至是ppt.同学就经常说我疯掉了,连 ...
- 试驾 Citus 11.0 beta
https://www.citusdata.com/blog/2022/03/26/test-drive-citus-11-beta-for-postgres/ Citus 11.0 beta 的最大 ...
- 无线:PIN码
PIN码(PIN1),全称Personal Identification Number.就是SIM卡的个人识别密码.手机的PIN码是保护SIM卡的一种安全措施,防止别人盗用SIM卡,如果启用了开机PI ...
- 运维:DevSecOps
什么是DevSecOps DevSecOps 是一场关于 DevOps 概念实践或艺术形式的变革.DevOps之父Patrick Debios 强调:"DevOps2.0时代应首先解决人的问 ...
- Spring Security之短信登录
实现短信验证码登录 前面实现了 用户名+密码 的登录方式,现在实现一下短信验证码登录. 开发短信验证码接口 短信验证码和图形验证码类似,用户从手机短信得到验证码和从图片得到验证码类似. 校验短信验证码 ...
- [2018-03-04] 利用 Settings Sync 插件同步 VS Code 设置
VS Code 已原生支持设置同步,本文仅备份记录 [2018-03-04] 早就听说这个插件了,今天用了一下,确实挺方便的.通过把配置文件创建为 Gist 上来实现了 VS Code 设置的同步,下 ...
- Activate-or-Not:learning-customized-activation
关于activate-or-Not的PPT paper code step1 step2 step3 step4 step5 step6 step7 step8 step9 step10