dubbo版本
- dubbo版本2.6.7
本地存根Stub
-
本地存根:在客户端执行部分逻辑。如果向下客户端执行部分逻辑,比如ThreadLocal缓存、提前校验参数、调用失败伪装容错数据等。此时就需要在API中带上Stub,客户端生成proxy实例,会把Proxy通过构造函数传递给Stub,然后把Stub暴露给用户,由Stub决定是否进行远程调用
-
配置
<dubbo:service interface="com.foo.BarService" stub="true" /> 或者 <dubbo:service interface="com.foo.BarService" stub="com.foo.BarServiceStub" /> 在consumer配置(stub本身就在consumer,所以consumer端配置比较合适) <dubbo:service interface="com.foo.BarService" stub="true" /> <dubbo:reference interface="com.foo.BarService" stub="com.foo.BarServiceStub" /> 因为local已经过时,现在使用stub代替local <dubbo:service interface="com.foo.BarService" local="true" /> <dubbo:reference interface="com.foo.BarService" local="com.foo.BarServiceLocal" />
-
编写存根实现规范:
- Stub和Local 必须有可传入 Proxy 的构造函数和实现业务接口。
- 如果配置local=true,实现类的命名规范必须是接口名+Stub或者接口名+Local,而且要和接口在一个包下
@Slf4j public class DemoServiceLocal implements DemoService { private final DemoService demoService; /** *构造函数传入真正的远程代理对象 */ public DemoServiceLocal(DemoService demoService) { this.demoService = demoService; } @Override public String sayHello(String name) { //可以前后实现AOP增强或者容错 try { log.info("开始远程调用"); String result = demoService.sayHello(name); log.info("结束远程调用,返回信息:{}", result); return result; } catch (Exception e) { log.error("容错数据"); } return "容错数据"; } @Override public SayResponseDTO sayHello(SayRequestDTO sayRequestDTO) { return null; } }
源码分析
-
检查配置
AbstractInterfaceConfig#checkStub
void