Dubbo高级篇_07_Dubbo服务接口的设计原则

原创 2016年04月13日 13:42:18

1 、设计方式

action->facade->biz->dao

好的Dubbo服务接口设计,并非只是纯粹的接口服务化

2.接口类型

简单的数据查询接口:action.facade、dao(例根据Id查询记录)

带业务逻辑的数据查询接口:action、facade、biz、dao(复杂的查询,带业务逻辑)

简单的数据写入接口:action、facade、dao(简单数据插入)

带业务逻辑的数据写入接口:action、facade、biz、dao(有业务逻辑的数据处理)

同步接口

异步接口

3.设计原则

服务接口尽可能大粒度,每个服务方法应代表一个功能,而不是某功能的一个步骤,否则将地面临分布式事务问题,

Dubbo暂未提供分布式事务支持,同时可以减少系统间的网络交互


服务接口建议以业务场景为单位划分,并对相近的业务做抽象,防止接口数量爆增(爆炸)

例:某一个接口有多个实现,做成一个接口,再在dubbo分组中多实现


不建议使用过于抽象的通用接口,如Map query(Map),这样的接口没有明确语义,会给后期维护带来不便



接口版本:

每个接口应定义版本号,为后续不兼容升级提供可能

如:

<dubbo:service interface="com.xxService" version="1.0"/>


接口兼容性:

服务接口增加方法,或服务模型增加字段,可向后兼容;

删除方法或删除字段,将不兼容,枚举类型新增字段也不兼容,需要通过变更版本号升级。


异常处理:

建议使用异常汇报错误,而不是返回错误码,异常信息能携带更多的信息,以及语义更友好。


如果担心性能问题,在必要时,可以通过override掉异常类的finlllnStackTrace()方法为空方法,使其不拷贝栈信息。


查询方法不建议抛出checked异常,否则调用 方在查询 时将过多的try...catch,并且不能进行有效处理。


服务提供方不应将DAO或者SQL等异常抛给消费方,应在服务实现中对消费方不关心的异常进行包装,否则可能出现消费方无法反序列化相应异常


必要的接口输入参数校验


在Provider上尽量多配置Consumer端属性:

原因如下:

作为服务的提供者,比服务使用方更清楚服务性能参数,如调用的超时时间,合理的重试次数,并发控制数量,负载均衡 ,等等

在Provider配置后,Consumer不配置则会使用Provider的配置值 ,

即Provider配置可以作为Comsumer的缺省值,否则,Consumer会使用Consumer端的全局设置,这对于Provider不可控的,并且往往是不合理的


Provider上尽量多配置Consumer端的属性,让Provider实现者一开始就思考Provider服务特点、服务质量的问题

样例:



版权声明:本文为博主原创文章,未经博主允许不得转载。

Dubbo是什么

1. Dubbo是什么? Dubbo是一个分布式服务框架,致力于提供高性能和透明化的RPC远程服务调用方案,以及SOA服务治理方案。简单的说,dubbo就是个服务框架,如果没有分布式的需求,其实是不...
  • ichsonx
  • ichsonx
  • 2014年09月02日 16:54
  • 34524

dubbo学习过程、使用经验分享及实现原理简单介绍

一、前言 部门去年年中开始各种改造,第一步是模块服务化,这边初选dubbo试用在一些非重要模块上,慢慢引入到一些稍微重要的功能上,半年时间,学习过程及线上使用遇到的些问题在此总结下。 二、什么是dub...
  • zhouyuqwert
  • zhouyuqwert
  • 2015年02月01日 01:25
  • 57136

使用dubbo自定义返回对象异常

最近修改了dubbo服务端的返回对象,引用了spring-data-commons中的Page接口,还是使用默认的dubbo协议,也就是netty+hessian;当消费端连接过来获取数据时,报了下面...
  • Enough520
  • Enough520
  • 2016年11月24日 16:49
  • 2210

Dubbo

1. Dubbo是什么? Dubbo是一个分布式服务框架,致力于提供高性能和透明化的RPC远程服务调用方案,以及SOA服务治理方案。简单的说,dubbo就是个服务框架,如果没有分布式的需求,其实...
  • u010779348
  • u010779348
  • 2016年07月06日 15:53
  • 437

基于Dubbo的动态远程调用

基于Dubbo的动态远程调用 问题:为解决实际业务,由我方提供接口定义,具体的实现交给第三方处理。然后由第三方将开发好的服务注册到他们自己的Dubbo服务上,由我方调用。问题就在于多个第三方开发具体...
  • u013736404
  • u013736404
  • 2015年03月05日 10:54
  • 12825

dubbo接口访问控制

微服务背景下,一个web应用都可能不再service依赖,而是通过RPC调用远端服务器上的服务。这些服务里,就包括了一些不能轻易暴露的后台功能接口。暴露出去的dubbo接口注册到某一个zk上后,该du...
  • peerless_hero
  • peerless_hero
  • 2017年05月23日 22:08
  • 3494

dubbo 请求调用过程分析

服务消费方发起请求 当服务的消费方引用了某远程服务,服务的应用方在spring的配置实例如下: dubbo:referenceid="demoService"interface="com.alibab...
  • paul_wei2008
  • paul_wei2008
  • 2017年04月11日 18:01
  • 2904

dubbo泛化处理(转)

dubbo泛化处理  收藏 关于泛化,dubbo文档这样描述的。 http://dubbo.io/User+Guide-zh.htm#UserGuide-zh-%E6...
  • zhuxianxin0118
  • zhuxianxin0118
  • 2017年04月18日 13:37
  • 635

dubbo服务接口

  • 2016年10月17日 14:07
  • 6KB
  • 下载

用dubbo框架写的简单的接口作为客户端

在客户端需要依赖服务端的jar包和类,在客户端也新建和服务端一样的接口和实现类 consumer.xml配置如下 ...
  • qq_30353203
  • qq_30353203
  • 2017年09月06日 12:41
  • 411
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:Dubbo高级篇_07_Dubbo服务接口的设计原则
举报原因:
原因补充:

(最多只允许输入30个字)