目录
- 绪论
- 实践
- dubbo-demo-interface
- dubbo-demo-xml-provider
- dubbo-demo-xml-consumer
- 启动
绪论
今天主要学习并实践dubbo的本地存根stub机制。首先了解一下官网文档对本地存根的介绍:
远程服务后,客户端通常只剩下接口,而实现全在服务器端,但提供方有些时候想在客户端也执行部分逻辑。
比如:做 ThreadLocal 缓存,提前验证参数,调用失败后伪造容错数据等等。
核心思想:API 中带上 Stub,客户端生成 Proxy 实例,**会把 Proxy 通过构造函数传给 Stub** ,然后把 Stub 暴露给用户,Stub 可以决定要不要去调 Proxy。
Stub会使用代理模式将原有的远程调用service进行包装,让使用者可以在远程服务调用前后做一些通用处理,非常适合做缓存容错,或者日志处理,异常包装等。故本地存根机制类似与AOP机制中的around advice(环绕增强);
则本地存根执行顺序:
1.服务消费者发起调用;
2.如果服务消费者端存在本地存根 Stub 的话,会先执行本地存根;
3.本地存根 Stub 持有远程服务的 Proxy 对象,Stub 在执行的时候,会先执行自己的逻辑(before)
,然后通过Proxy 发起远程调用
,最后在返回过程之前也会执行自己的逻辑(after-returning)
4.如果远程服务的 Proxy 对象在执行过程中抛出了 exception,会执行服务消费端的本地伪装 Mock 的逻辑 (after-throwing)
【后面再议】,返回容错数据,从而达到服务降级的目的。
如图:
实践
虽然dubbo官网简单给了本地存根的示例,但不是能够足以解决新手实战问题,其他博客千篇一律,没有几乎什么改进的地方,溪源学习的时候也是在花费了两个下班的时间搞定的实践,实属坎坷~
写在前面
dubbo官网给出两种设置本地存根的示例
-
stub
的属性值设置为实现类的全限定名; stub
的属性值,则默认设置为true;
溪源主要给大家说下第二种方式:踩坑点;
如果默认将stub
属性设置为true,则必须保证本地存根实现类以Stub
命名结尾,例如UserServiceStub
.
那为什么要这么设置呢????给大家贴一下源码ServiceConfig#checkAndUpdateSubConfigs()
类中。
如果实现类不以Stub结束,那反射查找本地存根实现类便找不到,又谈何实现本地存根的逻辑呢~
踩坑点相信大家已经清楚,下面开始进入实战环节。再看下dubbo官网本地存根,细品细品:
dubbo-demo-interface
- 目录结构如下:
- UserService
简单定义一个方法
/**
* @author wx
* @date 2020/9/6 11:39 下午
* 测试本地存根服务接口
*/
public interface UserService {
/**
* 根据用户名,返回用户名字
* @param userId 用户ID
* @return 用户名
*/
String getUserName(String userId);
}
- UserServiceStub
/**
* @author wx
* @date 2020/9/6 11:09 下午
* 服务消费者实现接口,并实现本地存根逻辑
*/
public class UserServiceStub implements UserService {
private static final String USER_ID = "1503891";
private final UserService userService;
/**
* 通过构造方法将服务接口代理对象(接口实现类对象)传入stub
* @param userService
*/
public UserServiceStub(UserService userService) {
this.userService = userService;
}
@Override
public String getUserName(String userId) {
System.out.println("开始执行服务消费端本地存根逻辑");
if (StringUtils.isBlank(userId)) {
return "userId is null";
}
if (!USER_ID.equals(userId)) {
return "user not exits";
}
String userName = userService.getUserName(userId);
System.out.println("结束执行服务消费端本地存根逻辑");
return userName;
}
}
dubbo-demo-xml-provider
- 目录结构
- stub-provider.xml
- UserProviderStubServiceImpl
/**
* @author wx
* @date 2020/9/6 11:09 下午
* 服务消费者实现接口,并实现本地存根逻辑
*/
@Service
public class UserProviderStubServiceImpl implements UserService {
private static final String USER_ID = "1503891";
@Override
public String getUserName(String userId) {
return USER_ID.equals(userId) ? "溪~源" : "";
}
}
- ProviderApplication
/**
* 服务端Stub测试
* @throws IOException
*/
private static void stubTest() throws IOException {
ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext("spring/stub-provider.xml");
context.start();
System.in.read();
}
dubbo-demo-xml-consumer
- stub-consumer.xml
消费者端并没有新增实现类,但溪源为了代码的整洁与后期维护、梳理,选择了新建stub-consumer.xml
配置文件和单元测试的模式实践. - ConsumerApplication
private static void stubTest() {
ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext("spring/stub-consumer.xml");
UserService stubService = context.getBean(UserService.class);
String userName = stubService.getUserName("1503891");
System.out.println(userName);
}
启动
分别启动provider,consumer如图:
- 测试1
将userId传为空 - 测试2
到此为止,本地存根实践应用结束,大家对源码如何实现原理,可以借助此demo开始debug吧~
溪源初次接触dubbo本地存根机制,如文中存在错误之处,希望大家及时指正!
源码传送门:https://github.com/stream-source/dubbo/tree/master/dubbo-demo