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服务特点、服务质量的问题

样例:



版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/hardworking0323/article/details/51142320

Result dubbo接口返回类型的设计

dubbo实现了分布式远程调用的框架,集成了spring配置功能,dubbo要求远程接口的参数和返回值都是可序列化的,Result泛型返回类型可作为接口的统一返回类型: int code,接口调...
  • a82793510
  • a82793510
  • 2017年09月20日 01:13
  • 1558

dubbo服务划分和接口设计原则(五)

1.服务划分 服务化的目标: 将系统中独立的业务模块抽取出来,按业务的独立性进行垂直划分,抽象出基础服务层。 服务化的目标: 服务化的目标:基础服务为上游业务的功能实现...
  • u014401141
  • u014401141
  • 2017年05月07日 09:45
  • 2989

Dubbo工程里的数据传递实体model必须且建议只实现一种接口

问题背景: 一个dubbo接口,返回值为一个排序的 List,为了排序方便,对List&lt;model&gt;中的model实体实现了comparable接口,重载了comp...
  • hikeboy
  • hikeboy
  • 2018年02月21日 18:52
  • 150

Dubbo服务接口的设计原则

根据接口类型划分 简单的数据查询接口:action facade dao 带业务逻辑的数据查询接口:action facade biz dao 简单的数据写入接口:action facade dao ...
  • qq_32120645
  • qq_32120645
  • 2017年10月26日 20:36
  • 220

Dubbo的正确打开方式之基本接口定义及异常处理

为什么要写这篇文章呢?因为公司在使用Dubbo时并没有对Dubbo的用法做深入的了解,而是属于拿来就用,随着自己的想法来使用。这样很不好,就像天龙八部的鸠摩智练习错误的六脉神剑一样,方式不对,就容易走...
  • luxianping
  • luxianping
  • 2015年12月23日 03:27
  • 890

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

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

Dubbo源码分析 之 netty调用获取返回值

netty作为异步非阻塞的rpc框架,也是dubbo默认的远程rpc协议,让我们来看一下dubbo的客户端是实现同步获取返回信息的效果的: 在调用发送请求之前,如果我们设置断点进行跟踪的话会进入一连串...
  • rewerma
  • rewerma
  • 2017年07月31日 16:02
  • 982

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

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

Dubbo的正确打开方式之基本接口定义及异常处理

为什么要写这篇文章呢?因为公司在使用Dubbo时并没有对Dubbo的用法做深入的了解,而是属于拿来就用,随着自己的想法来使用。这样很不好,就像天龙八部的鸠摩智练习错误的六脉神剑一样,方式不对,就容易走...
  • u012345283
  • u012345283
  • 2015年11月30日 13:26
  • 6722

规范-dubbo服务设计

1、工程架构     层次设计大致分为:Remote层、Manager层、Service层、Cache层、DAO层、DTO\DO。     各层次功能描述: Remote层:对外暴露du...
  • zdx_csdn
  • zdx_csdn
  • 2017年04月26日 16:02
  • 800
收藏助手
不良信息举报
您举报文章:Dubbo高级篇_07_Dubbo服务接口的设计原则
举报原因:
原因补充:

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