第二章：（6）Dubbo 常用配置之 本地存根

一、本地存根

　　在 Dubbo 中利用本地存根在客户端执行部分逻辑

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

　　

 　　1、在 spring 配置文件中按以下方式配置：

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

　　或

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

　　2、提供 Stub 的实现

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

　　注意：

　　1、Stub 必须有可传入 Proxy 的构造函数；

　　2、在 interface 旁边放一个 Stub 实现，它实现 BarService 接口，并有一个传入远程 BarService 实例的构造函数；

二、代码示例

　　1、创建本地存根

public class UserServiceStub implements UserService {

    private final UserService userService;

    /**
     * 传入的是 UserService 的远程的代理对象
     * @param userService
     */
    public UserServiceStub(UserService userService) {
        this.userService = userService;
    }

    @Override
    public List<UserAddress> getUserAddressList(String userId) {
        System.out.println("UserServiceStub 被调用了");
        if (!StringUtils.isEmpty(userId)) {
            return userService.getUserAddressList(userId);
        }
        return Collections.emptyList();
    }
}

　　2、配置

    <dubbo:reference interface="com.njf.gmall.service.UserService"
                     id="userService" check="false" timeout="5000" version="*"
                     stub="com.njf.gmall.service.impl.UserServiceStub">
    </dubbo:reference>

　　扩展：https://blog.csdn.net/piqianming/article/details/98345678