Dubbo学习总结(五)常用设置

柔情只为你懂 2024-02-19 15:22 19阅读 0赞

**启动时检查**：check="true"

启动时检查依赖的服务是否可用，不可用时会抛出异常，阻止 Spring 初始化完成，以便上线时，能及早发现问题，默认 `check="true"，如果不需要启动进行检查可以将其设置成 check="false".`

关闭所有服务的启动时检查 (没有提供者时报错)：

<dubbo:consumer check="false" />

关闭注册中心启动时检查 (注册订阅失败时报错)：

<dubbo:registry check="false" />

关闭所有服务的启动时检查（没有消费者报错）：

<dubbo:reference  check="false" />

**多协议：**

在一个项目中需要配置多个协议，彼此进行共同生效。在不同服务上支持不同协议或者同一服务上同时支持多种协议。

<dubbo:protocol name="dubbo" port="20880" />
        <dubbo:protocol name="redis" port="6379" />
        
        <dubbo:service interface="com.xxx.UserService" version="1.0.0" ref="userService" protocol="dubbo" />
        
        <dubbo:service interface="com.xxx.AuthService" version="1.0.0" ref="authService" protocol="redis" />

**多注册中心:**

Dubbo 支持同一服务向多注册中心同时注册，或者不同服务分别注册到不同的注册中心上去，甚至可以同时引用注册在不同注册中心上的同名服务。

<dubbo:registry id="ARegistry" address="94.191.86.252:2181" />
        <dubbo:registry id="BRegistry" address="94.191.86.252:2182" default="false" />
        
        <dubbo:service interface="com.xxx.AuthService" version="1.0.0" ref="authService" registry="ARegistry,BRegistry" />

**服务分组:**

一个接口有多种实现时，可以用 group 区分,这个更@validate相似。

服务
    <dubbo:service group="A" interface="com.xxx.UserService" />
    <dubbo:service group="B" interface="com.xxx.AuthService" />
    引用
    <dubbo:reference id="userService" group="A" interface="com.xxx.UserService" />
    <dubbo:reference id="authService" group="B" interface="com.xxx.AuthService" />
    任意组：
    <dubbo:reference id="baseService" interface="com.xxx.BaseService" group="*" />

**多版本:**

当一个接口实现，出现不兼容升级时，可以用版本号过渡，版本号不同的服务相互间不引用。

步骤进行版本迁移：

1.  在低压力时间段，先升级一半提供者为新版本
2.  再将所有消费者升级为新版本
3.  然后将剩下的一半提供者升级为新版本

<dubbo:service ...... version="2.0.0" />
    <dubbo:reference .... version="2.0.0" />
    <dubbo:reference .... version="*" />

**参数验证:**

参数验证功能是基于 [JSR303][] 实现的，用户只需标识 JSR303 标准的验证 annotation，并通过声明 filter 来实现验证。

@NotNull // 不允许为空
        @Size(min = 1, max = 20) // 长度或大小范围
        private String name;
     
        @NotNull(groups = ValidationService.Save.class) // 保存时不允许为空，更新时允许为空 ，表示不更新该字段
        @Pattern(regexp = "^\\s*\\w+(?:\\.{0,1}[\\w-]+)*@[a-zA-Z0-9]+(?:[-.][a-zA-Z0-9]+)*\\.[a-zA-Z]+\\s*$")
        private String email;
     
        @Min(18) // 最小值
        @Max(100) // 最大值
        private int age;
     
        @Past // 必须为一个过去的时间
        private Date loginDate;
     
        @Future // 必须为一个未来的时间
        private Date expiryDate;

开启验证：

<dubbo:reference id="xxxx" interface="xxxxx" validation="true" />
    <dubbo:service interface="zzz" ref="xxxx" validation="true" />

**结果缓存:**

用于加速热门数据的访问速度，Dubbo 提供声明式缓存，以减少用户加缓存的工作量

缓存类型

*  `lru` 基于最近最少使用原则删除多余缓存，保持最热的数据被缓存。
 *  `threadlocal` 当前线程缓存，比如一个页面渲染，用到很多 portal，每个 portal 都要去查用户信息，通过线程缓存，可以减少这种多余访问。
 *  `jcache` 与 [JSR107][] 集成，可以桥接各种缓存实现。

//接口级别
    <dubbo:reference interface="xxxxx" cache="lru" />
    //方法级别
    <dubbo:reference interface="zzzz">
        <dubbo:method name="xxx" cache="lru" />
    </dubbo:reference>

**异步调用：**

基于 NIO 的非阻塞实现并行调用，客户端不需要启动多线程即可完成并行调用多个远程服务，相对多线程开销较小。

![/user-guide/images/future.jpg][user-guide_images_future.jpg]

<dubbo:method name="xxx" async="true" />

设置是否等待消息发出：

*  `sent="true"` 等待消息发出，消息发送失败将抛出异常。
 *  `sent="false"` 不等待消息发出，将消息放入 IO 队列，即刻返回。

<dubbo:method name="xx" async="true" sent="true" />

如果只是想异步，完全忽略返回值，可以配置 `return="false"`，以减少 Future 对象的创建和管理成本.

<dubbo:method name="xxx" async="true" return="false" />

**本地存根:**

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

![/user-guide/images/stub.jpg][user-guide_images_stub.jpg]

在 spring 配置文件中按以下方式配置：
    <dubbo:service interface="com.xx.UserService" stub="true" />
    或
    
    <dubbo:service interface="com.xxx.UserService" stub="com.xxx.UserServiceStub" />

案例

public interface UserService {
    
        public String findUserInfo(String name);
    }
    
    import org.apache.dubbo.config.annotation.Service;
     
    @Service(timeout = 5000)
    public class UserService Impl implements UserService { 
    
        public String findUserInfo(String name) {
            // 此代码在客户端执行, 你可以在客户端做ThreadLocal本地缓存，或预先验证参数是否合法，等等
       
         return userService .findUserInfo(name);
            
        }
    }
    //存根
    public class UserServiceStub implements UserService { 
        private final userService userService ;
        
        // 构造函数传入真正的远程代理对象
        public UserServiceStub(userService  userService ) {
            this.userService = userService ;
        }
     
        public String findUserInfo(String name) {
            // 此代码在客户端执行, 你可以在客户端做ThreadLocal本地缓存，或预先验证参数是否合法，等等
            try {
                return userService .findUserInfo(name);
            } catch (Exception e) {
                // 你可以容错，可以做任何AOP拦截事项
                return "容错数据";
            }
        }
    }

本地伪装：

通常用于服务降级，比如某验权服务，当服务提供方全部挂掉后，客户端不抛出异常，而是通过 Mock 数据返回授权失败。

<dubbo:reference interface="com.xxxx.UserService" mock="com.xxx.UserServiceMock" />

public class UserServiceMock implements UserService {
        public String findUser(String name) {
            // 你可以伪造容错数据，此方法只在出现RpcException时被执行
            return "容错数据";
        }
    }

如果服务的消费方经常需要 try-catch 捕获异常,可以使用 Mock 实现，并在 Mock 实现中 return null。

<dubbo:reference interface="com.xxx.UserService" mock="return null" />

#### return ####

使用 `return` 来返回一个字符串表示的对象，作为 Mock 的返回值。合法的字符串可以是：

*  *empty*: 代表空，基本类型的默认值，或者集合类的空值
 *  *null*: `null`
 *  *true*: `true`
 *  *false*: `false`
 *  *JSON 格式*: 反序列化 JSON 所得到的对象

#### throw ####

使用 `throw` 来返回一个 Exception 对象，作为 Mock 的返回值。当调用出错时，抛出一个默认的 RPCException:

<dubbo:reference interface="com.xxx.UserService" mock="throw" />

总结：

1.  Mock 是 Stub 的一个子集，便于服务提供方在客户端执行容错逻辑，因经常需要在出现 RpcException (比如网络失败，超时等)时进行容错，而在出现业务异常(比如登录用户名密码错误)时不需要容错，如果用 Stub，可能就需要捕获并依赖 RpcException 类，而用 Mock 就可以不依赖 RpcException，因为它的约定就是只有出现 RpcException 时才执行。 [↩︎][Link 1]
2.  在 interface 旁放一个 Mock 实现，它实现 UserService 接口，并有一个无参构造函数 .代理。

[JSR303]: https://jcp.org/en/jsr/detail?id=303
[JSR107]: http://jcp.org/en/jsr/detail?id=107%27
[user-guide_images_future.jpg]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/7e301c8695e248f08d67dc7e90e585cb.png
[user-guide_images_stub.jpg]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/39ed36bbe3324815a77ac4a9c13fa206.png
[Link 1]: http://dubbo.apache.org/zh-cn/docs/user/demos/local-mock.html#fnref1