Dubbo 接口设计原则、服务系统划分

接口设计原则

  1. 接口类型
    • 简单数据查询接口:action、facade、dao
    • 带业务逻辑的数据查询接口:action、facade、biz、dao
    • 简单的数据写入接口:action、facade、dao
    • 带业务逻辑的数据写入接口:action、facade、biz、dao
    • 同步接口
    • 异步接口
  2. 设计原则
    • 接口粗粒度 一个接口代表一个完整的业务功能
      • 减少系统间的网络交互
      • 防止业务接口数量爆炸
      • 解决Dubbo接口的事物问题。
  3. 接口版本 <dubbo:service interface="com.XxService" version="1.0" />
    • 为后期不兼容升级提供可能
  4. 接口兼容性
    • 可兼容 :
      • 增加方法
      • 服务模型增加字段
    • 不兼容 需要变更版本号
      • 删除方法
      • 删除模型字段
      • 枚举类型新增字段也不兼容
  5. 异常处理
    • 使用抛出异常来汇报错误,而不是返回错误码,异常信息能携带
      更多信息,以及语义更友好。
      • 如果担心性能问题,在必要时,可以通过override掉异常类的
        fillInStackTrace()方法为空方法,使其不拷贝栈信息。
      • 查询方法不建议抛出checked异常,否则调用方在查询时将过
        多的try…catch,并且不能进行有效处理。
  6. 必要的接口输入参数校验
  7. 在Provider上尽量多配置Consumer端属性
    作服务的提供者,比服务使用方更清楚服务性能参数,如调用的超时时间,合理的重试次数,等等
    在Provider配置后,Consumer不配置则会使用Provider的配置值,即Provider配置可以作为Consumer的缺省值。否则,Consumer会使用
    Consumer端的全局设置,这对于Provider不可控的,并且往往是不合理的。

    Dubbo 接口设计原则、服务系统划分


服务系统划分

  1. 按业务独立性垂直划分
  2. 本书无状态
  3. 注意事项
    Dubbo 接口设计原则、服务系统划分