Dubbo本地存根 Stub

 

 

本地存根的工作方式与 AOP 的 around advice 类似,而本地伪装的工作方式等同于 AOP 中的 after-throwing advice,也就是说,只有当远程调用发生 exception 的时候才会执行本地伪装。本地存根和本地伪装的工作流程如下图所示:
  1. 服务消费者发起调用
  2. 如果服务消费者端存在本地存根 Stub 的话,会先执行本地存根
  3. 本地存根 Stub 持有远程服务的 Proxy 对象,Stub 在执行的时候,会先执行自己的逻辑 (before),然后通过 Proxy 发起远程调用,最后在返回过程之前也会执行自己的逻辑 (after-returning)
  4. 如果远程服务的 Proxy 对象在执行过程中抛出了 exception,会执行服务消费端的本地伪装 Mock 的逻辑 (after-throwing),返回容错数据,从而达到服务降级的目的
 
一、本地存根 Stub
public class DemoServiceStub implements DemoService { // #1
  
    private final DemoService demoService;
   
    public DemoServiceStub(DemoService demoService) { // #2
        this.demoService = demoService;
    }

    @Override
    public String sayHello(String name) { // #3
        System.out.println("before execute remote service, parameter: " + name); // #4
        try {
            String result = demoService.sayHello(name); // #5
            System.out.println("after execute remote service, result: " + result); // #6
            return result;
        } catch (Exception e) {
            System.out.println("fail to execute service"); // #7
            return null;
        }
    }

}

 

 DemoServiceStub 运行在客户端,要使用本地存根的话,还需要在 .xml 中配置属性 stub。可以简单的通过指定 stub="true" 来告诉 Dubbo 框架使用本地存根,这个时候,本地存根的包名需要和服务接口的包名一致,类名必须在服务接口的类名后加上 Stub 的后缀。例如,当服务接口名是 com.alibaba.dubbo.demo.DemoService 时,本地存根的全类名应该是com.alibaba.dubbo.demo.DemoServiceStub。
<dubbo:reference id="demoService" check="false" interface="com.alibaba.dubbo.demo.DemoService" stub="true">
    <dubbo:method name="sayHello" retries="0"></dubbo:method>
</dubbo:reference>

如果不希望使用默认的命名规则,也可以直接通过 mock 属性来指定本地伪装的全类名

<dubbo:reference id="demoService" check="false" interface="com.alibaba.dubbo.demo.DemoService" 
                 stub="com.alibaba.dubbo.demo.consumer.DemoServiceStub">
    <dubbo:method name="sayHello" retries="0"></dubbo:method>
</dubbo:reference>

 

通过提供一个本地伪装的类,可以最大限度的控制出错之后的容错逻辑。有的时候,业务上并不需要这样灵活的机制,只有返回一个默认值的诉求,这个时候提供一个完整的本地伪装的实现就显得有点重了。或者线上出错的时候,应用并没有打包本地伪装,需要通过推送规则的方式临时对服务降级。Dubbo 框架为上面的这两种诉求都提供了快捷方式,帮助用户快速配置服务降级。
 
 
posted @ 2020-06-16 13:08  cao_xiaobo  阅读(82)  评论(0编辑  收藏