代码规范重要吗?很重要很重要,整洁的代码能让你和同事都心旷神怡,也能让你在离职的时候不会被骂.....今天就来讲讲优秀IT人的代码都是如何分层的。

一、背景

说起应用分层,大部分人都会认为这个不是很简单嘛 就controller,service, mapper三层。

看起来简单,很多人其实并没有把他们职责划分开,在很多代码中,controller做的逻辑比service还多,service往往当成透传了,这其实是很多人开发代码都没有注意到的地方,反正功能也能用,至于放哪无所谓呗。这样往往造成后面代码无法复用,层级关系混乱,对后续代码的维护非常麻烦。

的确在这些人眼中分层只是一个形式,前辈们的代码这么写的,其他项目代码这么写的,那么我也这么跟着写。

但是在真正的团队开发中每个人的习惯都不同,写出来的代码必然带着自己的标签,有的人习惯controller写大量的业务逻辑,有的人习惯在service中之间调用远程服务,这样就导致了每个人的开发代码风格完全不同。

后续其他人修改的时候,一看,我靠这个人写的代码和我平常的习惯完全不同,修改的时候到底是按着自己以前的习惯改,还是跟着前辈们走,这又是个艰难的选择,选择一旦有偏差,你后来的同事又维护你的代码的时候,恐怕就要怼人了。

所以一个好的应用分层需要具备以下几点:

  • 方便后续代码进行维护扩展;
  • 分层的效果需要让整个团队都接受;
  • 各个层职责边界清晰

二、如何进行分层

2.1、阿里规范

在阿里的编码规范中约束的分层如下:

开放接口层:可直接封装 Service 方法暴露成 RPC 接口;通过 Web 封装成 http 接口;进行 网关安全控制、流量控制等。

终端显示层:各个端的模板渲染并执行显示的层。当前主要是 velocity 渲染,JS 渲染, JSP 渲染,移动端展示等。

Web 层:主要是对访问控制进行转发,各类基本参数校验,或者不复用的业务简单处理等。

Service 层:相对具体的业务逻辑服务层。

Manager 层:通用业务处理层,它有如下特征:

  1. 对第三方平台封装的层,预处理返回结果及转化异常信息;
  2. 对Service层通用能力的下沉,如缓存方案、中间件通用处理;
  3. 与DAO层交互,对多个DAO的组合复用。

DAO 层:数据访问层,与底层 MySQL、Oracle、Hbase 进行数据交互。

阿里巴巴规约中的分层比较清晰简单明了,但是描述得还是过于简单了,以及service层和manager层有很多同学还是有点分不清楚之间的关系,就导致了很多项目中根本没有Manager层的存在。下面介绍一下具体业务中应该如何实现分层。

2.2、优化分层

从我们的业务开发中总结了一个较为的理想模型,这里要先说明一下由于我们的rpc框架选用的是thrift可能会比其他的一些rpc框架例如dubbo会多出一层,作用和controller层类似:

最上层controller和TService是阿里分层规范里面的第一层:轻业务逻辑,参数校验,异常兜底。通常这种接口可以轻易更换接口类型,所以业务逻辑必须要轻,甚至不做具体逻辑。

Service:业务层,复用性较低,这里推荐每一个controller方法都得对应一个service,不要把业务编排放在controller中去做,为什么呢?如果我们把业务编排放在controller层去做的话,如果以后我们要接入thrift,我们这里又需要把业务编排在做一次,这样会导致我们每接入一个入口层这个代码都得重新复制一份如下图所示:

这样大量的重复工作必定会导致我们开发效率下降,所以我们需要把业务编排逻辑都得放进service中去做:

Mannager:可复用逻辑层。这里的Mannager可以是单个服务的,比如我们的cache,mq等等,当然也可以是复合的,当你需要调用多个Mannager的时候,这个可以合为一个Mannager,比如逻辑上的连表查询等。如果是httpMannager或rpcMannager需要在这一层做一些数据转换

DAO:数据库访问层。主要负责“操作数据库的某张表,映射到某个java对象”,dao应该只允许自己的Service访问,其他Service要访问我的数据必须通过对应的Service。

三、分层领域模型的转换

在阿里巴巴编码规约中列举了下面几个领域模型规约:

  • DO(Data Object):与数据库表结构一一对应,通过DAO层向上传输数据源对象。
  • DTO(Data Transfer Object):数据传输对象,Service或Manager向外传输的对象。
  • BO(Business Object):业务对象。由Service层输出的封装业务逻辑的对象。
  • AO(Application Object):应用对象。在Web层与Service层之间抽象的复用对象模型,极为贴近展示层,复用度不高。
  • VO(View Object):显示层对象,通常是Web向模板渲染引擎层传输的对象。
  • Query:数据查询对象,各层接收上层的查询请求。注意超过2个参数的查询封装,禁止使用Map类来传输。

每一个层基本都自己对应的领域模型,这样就导致了有些人过于追求每一层都是用自己的领域模型,这样就导致了一个对象可能会出现3次甚至4次转换在一次请求中,当返回的时候同样也会出现3-4次转换,这样有可能一次完整的请求-返回会出现很多次对象转换。如果在开发中真的按照这么来,恐怕就别写其他的了,一天就光写这个重复无用的逻辑算了吧。

所以我们得采取一个折中的方案:

1、允许Service/Manager可以操作数据领域模型,对于这个层级来说,本来自己做的工作也是做的是业务逻辑处理和数据组装。

2、Controller/TService层的领域模型不允许传入DAO层,这样就不符合职责划分了。

3、同理,不允许DAO层的数据传入到Controller/TService。

四、总结

总的来说业务分层对于代码规范是比较重要,决定着以后的代码是否可复用,是否职责清晰,边界清晰。

当然这种分层其实见仁见智, 团队中的所有人的分层习惯也不同,所以很难权衡出一个标准的准则,总的来说只要满足职责逻辑清晰,后续维护容易,就是好的分层。

最后,如果你的团队有更好的分层,或者上面所描述的有什么错误的地方还请评论指正一下。

阿里代码规范pdf_看完阿里的代码规范,立马学会代码分层,再也不会被同事怼...相关推荐

  1. 神了!!看完这篇文章我不仅学会了手撸vue三开关组件,还搞懂了父子组件传值

    神了!!看完这篇文章我不仅学会了手撸vue三开关组件,还搞懂了父子组件传值 引子 前置知识 什么是vue组件 父子组件传值 父传子 子传父 model选项的引入 三开关组件(three-switch) ...

  2. 看完阿里的食堂,我想辞职了!

    点击上方"民工哥技术之路"选择"置顶或星标" 每天10点为你分享不一样的干货 转载自 阿里巴巴.杭州美食评论 日常上班族最头疼的灵魂三连问 早上吃什么.中午吃什 ...

  3. 看完阿里云的haddop云梯集群设计思路有感

    上次去hadoop大会,听了互联网的专场,对于阿里的云梯这个主题颇有些印象,但是由于对hadoop纯属概念党,所以听的也不是太懂,今天在网上查了下这个云梯,其实网关于这个上面的还是挺多的,所以特别看了 ...

  4. 别乱提交代码了,看下大厂 Git 提交规范是怎么做的!

    Git是现在市面上最流行的版本控制工具,书写良好的commit message能大大提高代码维护的效率. 但是在日常开发中由于缺少对commit message的约束,导致填写内容随意.质量参差不齐, ...

  5. 这5个让人窒息的烂代码,你看完都忍不了!

    摘要:下面就为大家带来个人认为的常见的烂注释风格. 相信作为程序员的大家,只要写代码,就会自己写及看到别人写的代码注释.所以,我们往往会遇到"百花齐放,百家争鸣"般的注释.程序员最 ...

  6. 看完这篇JVM内存管理机制,面试再也不慌了!

    /   今日科技快讯   / 近日,美国新冠肺炎确诊病例已破300万例,众多美企深受疫情打击.然而,特朗普政府当前正全力推进一项针对华为.中兴等中企产品的采购禁令,又让一众美企措手不及.7月10日,代 ...

  7. 软件工程师职业道德规范_看一下三个职业道德规范的最新更新

    软件工程师职业道德规范 It is common for professional societies and membership organizations to have a Code of E ...

  8. 苹果ppt_熬夜看完苹果发布会,我居然学会了用PPT做霓虹灯特效?!

    前几天苹果又双叒叕开发布会了,这次苹果爸爸为我们带来了全新的IOS,MacOS以及iPadOS,以及两款全新的硬件设备--Mac Pro与Display XDR! Mac Pro 与 Display ...

  9. 看完阿里的代码规范,立马学会代码分层,再也不会被同事怼

    代码规范重要吗?很重要很重要,整洁的代码能让你和同事都心旷神怡,也能让你在离职的时候不会被骂.....今天就来讲讲优秀IT人的代码都是如何分层的. 一.背景 说起应用分层,大部分人都会认为这个不是很简 ...

  10. 看完阿里p8整理的Spring Security应用到源码手册,豁然开朗

    又逢"金九银十",年轻的毕业生们满怀希望与忐忑,去寻找.竞争一个工作机会.已经在职的开发同学,也想通过社会招聘或者内推的时机争取到更好的待遇.更大的平台. 然而,面试人群众多,技术 ...

最新文章

  1. BZOJ 3566: [SHOI2014]概率充电器
  2. 《淘宝网开店 进货 运营 管理 客服 实战200招》——2.3 开店需要掌握哪些 进货技巧...
  3. spring事务管理-xml配置aop事务(重点)
  4. android 状态栏、标题栏、屏幕高度
  5. 看漫画,学Linux内核!看完明白小企鹅们在干啥了吧?
  6. ESP8266学习笔记6:ESP8266规范wifi连接操作
  7. 推荐算法概述(01)
  8. 推荐一本学习生信的好书,新手友好,实战性强
  9. YII 规则rule 里面 min,max 提示错误信息
  10. 《精通ArcGIS Server 应用与开发》——1.3 ArcGIS 10 Mobile新特性1
  11. 从mp4,flv文件中解析出h264和aac,送解码器解码失败
  12. C语言学习:原子操作
  13. 国际区块链专利:中国蚂蚁、平安、腾讯、复杂美位列前十
  14. 人脸识别活体检测技术探讨
  15. SATA 与 PCIe
  16. 如何调研如何写调研报告
  17. SVD奇异值分解在推荐系统中的应用及实现
  18. 语义标签(Semantic label)与多模态模型的一些关系
  19. 【Uipath杂谈】用Datatable处理数据(二)
  20. 智遥工作流导出Excel分析

热门文章

  1. 对js原型简单的理解和图解
  2. 网络营销时不仅需要考虑用户体验,也要赋予情感
  3. 记录最近的几个bug
  4. 用户空间与内核空间数据交换的方式(3)------seq_file
  5. 复制不能复制的网页文字(实用篇) [图片]
  6. 5.2刚买了佳能的ixus100is数码相机,可以录像不过是mov格式的,需要转换为dvd的软件...
  7. 9.凤凰架构:构建可靠的大型分布式系统 --- 可靠通信
  8. 6.大数据架构详解:从数据获取到深度学习 --- 交互式分析
  9. 85. php 绘图体系
  10. 6. Magento2 --- 创建主题