Dubbo服务治理篇——服务接口的设计原则-阿里云开发者社区

开发者社区> -技术小助手-> 正文

Dubbo服务治理篇——服务接口的设计原则

简介: 1 、设计方式 action->facade->biz->dao 好的Dubbo服务接口设计,并非只是纯粹的接口服务化
+关注继续查看

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


样例:

s.jpg


版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

相关文章
Dubbo服务消费者调用过程
上图是服务消费的主过程: 首先通过ReferenceConfig类的private void init()方法会先检查初始化所有的配置信息后,调用private T createProxy(Map map)创建代理,消费者最终得到的是服务的代理, 在createProxy接着调用Protocol接口实现的 Invoker refer(Class type, URL url)方法生成Invoker实例(如上图中的红色部分),这是服务消费的关键。
955 0
阿里云服务器怎么设置密码?怎么停机?怎么重启服务器?
如果在创建实例时没有设置密码,或者密码丢失,您可以在控制台上重新设置实例的登录密码。本文仅描述如何在 ECS 管理控制台上修改实例登录密码。
8027 0
面象对象设计6大原则之四:接口隔离原则
接口隔离原则(ISP),The Interface Segregation Principle 定义 客户端不需要强迫依赖那些它们不需要的接口。
781 0
阿里云服务器端口号设置
阿里云服务器初级使用者可能面临的问题之一. 使用tomcat或者其他服务器软件设置端口号后,比如 一些不是默认的, mysql的 3306, mssql的1433,有时候打不开网页, 原因是没有在ecs安全组去设置这个端口号. 解决: 点击ecs下网络和安全下的安全组 在弹出的安全组中,如果没有就新建安全组,然后点击配置规则 最后如上图点击添加...或快速创建.   have fun!  将编程看作是一门艺术,而不单单是个技术。
9791 0
源码分析Dubbo服务消费端启动流程
通过前面文章详解,我们知道Dubbo服务消费者标签dubbo:reference最终会在Spring容器中创建一个对应的ReferenceBean实例,而ReferenceBean实现了Spring生命周期接口:InitializingBean,接下来应该看一下其afterPropertiesSet方法的实现。
1466 0
阿里云服务器如何登录?阿里云服务器的三种登录方法
购买阿里云ECS云服务器后如何登录?场景不同,阿里云优惠总结大概有三种登录方式: 登录到ECS云服务器控制台 在ECS云服务器控制台用户可以更改密码、更换系.
11533 0
dubbo-go 的开发、设计与功能介绍
dubbo-go 的前世今生 dubbo-go 是目前 Dubbo 多语言生态最火热的项目。dubbo-go 最早的版本应该要追溯到 2016 年,由社区于雨同学编写 dubbo-go 的初版。当时很多东西没有现成的轮子,如 Go 语言没有像 netty 一样的基于事件的网络处理引擎、 hessian2 协议没有 Go 语言版本实现,加上当时 Dubbo 也没有开始重新维护。
8131 0
用C++如何实现开放API接口服务器
比如新浪微博的API服务器。接口是使用HTTP请求。服务器端如何实现一个HTTP SERVER呢?使用libcurl可以吗?   c++的话,一般用libevent或则libev这种库来实现吧。
1118 0
分布式--Dubbo 分布式服务
1. Dubbo官网 Dubbo下载地址 1). 发展历史 随着互联网的不断发展,网站的应用规模越来越大,常规的垂直架构已经无法应对,尤其是类似电商的项目,所以分布式架构和流动计算架构已经势在必行。
900 0
1633
文章
0
问答
文章排行榜
最热
最新
相关电子书
更多
《2021云上架构与运维峰会演讲合集》
立即下载
《零基础CSS入门教程》
立即下载
《零基础HTML入门教程》
立即下载