本地存根

远程服务后,客户端通常只剩下接口,而实现全在服务器端,但提供方有些时候想在客户端也执行部分逻辑,比如:做 ThreadLocal 缓存,提前验证参数,调用失败后伪造容错数据等等,此时就需要在 API 中带上 Stub,客户端生成 Proxy 实例,会把 Proxy 通过构造函数传给 Stub [1],然后把 Stub 暴露给用户,Stub 可以决定要不要去调 Proxy。

/user-guide/images/stub.jpg

在 spring 配置文件中按以下方式配置:

  1. <dubbo:service interface="com.foo.BarService" stub="true" />

  1. <dubbo:service interface="com.foo.BarService" stub="com.foo.BarServiceStub" />

提供 Stub 的实现 [2]

  1. package com.foo;
  2. public class BarServiceStub implements BarService {
  3. private final BarService barService;
  4. // 构造函数传入真正的远程代理对象
  5. public BarServiceStub(BarService barService){
  6. this.barService = barService;
  7. }
  8. public String sayHello(String name) {
  9. // 此代码在客户端执行, 你可以在客户端做ThreadLocal本地缓存,或预先验证参数是否合法,等等
  10. try {
  11. return barService.sayHello(name);
  12. } catch (Exception e) {
  13. // 你可以容错,可以做任何AOP拦截事项
  14. return "容错数据";
  15. }
  16. }
  17. }

  1. Stub 必须有可传入 Proxy 的构造函数。 ↩︎

  2. 在 interface 旁边放一个 Stub 实现,它实现 BarService 接口,并有一个传入远程 BarService 实例的构造函数 ↩︎