前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >重构系统的套路-写有组织的代码

重构系统的套路-写有组织的代码

作者头像
春哥大魔王
发布2018-04-25 10:50:48
1.2K0
发布2018-04-25 10:50:48
举报
文章被收录于专栏:服务端技术杂谈

如果一个项目经历了快速发展,势必在业务发展背后留下了一个很无序,结构混乱的代码,无序而混乱的代码势必造成很大的bug修复及扩展成本。

说到搭建系统都在谈论高并发,大数据,而易于维护和可扩展性则被大部分人抛之脑后,增加最基础的面向对象思想和设计模式帮助我们组织好易于维护和阅读的代码。

不要好高骛远看一下高并发,高可用的东西,做好以下这些最基础的东西,你的系统在可读性和可维护可扩展方面将会提升一倍的能力,将大家的人效从每次bug产生梳理代码的过程中解放出来,建立标准建立原则才是架构师首先要做的。

  • 进行适当的封装
  • 开放封闭原则
  • 单一只能原则
  • 代码具备随时删掉而不影响上下文的能力

命名与注释

命名需要见名知义,注释则可以帮助我们去了解当时的业务逻辑,不然后期只能通过一行行的日志去定位问题了。

考虑到IDE会帮助我们创建变量名称,如果名称相似则存在误用可能造成很难定位的BUG,入参可以以Req结尾或者Command结尾,返回值以Resp结尾或者Result结尾。

抽离业务骨骼

Web系统的入口层是Controller,基于RPC的服务入口层往往是XxxServiceImpl,入口层应该像一本书的目录和前言部分,说明了这个方法的主要目的,同时梳理了核心的业务流程,流程不要太细或者太粗,刚刚好满足产品的需求骨骼为主,可以简单的理解为是产品PRD的信息抽象。

建立胶水层代码

大型系统或者业务系统具有一定的复杂程度,势必在某些问题场景包含一些必要的大逻辑处理,于是建立一个胶水层代码,胶水类可以用入口层的一个方法名称作为名称定义。 胶水层代码向外暴露的public接口则为入口层的核心骨骼逻辑,将内部复杂逻辑进行封装,达到部分方法随时可以删掉,注释掉,替换掉而不影响核心骨骼逻辑的效果,可以理解为TDD,关注入参和返回值就好。 如果通过RPC或者ResultAPI和其他系统具有一定的依赖,则放到这里。 其实这层有些上DDD里面的Domain,但是DDD用不好的话在分布式微服务场景下会出现很难把控的问题。

下层依赖代码

在入口和业务逻辑之下基本就是Service层代码和Dao层代码了,Dao主要是和存储系统打交道,主要目的是可以随时切换到其他的存储逻辑中去,而不影响上层业务和代码。 Service则是进行一定的数据结构组织,数据结构可能来自于底层Dao,可能来自于消息队列的订阅,可能来自于Redis缓存或者Hbase等,放在这一层可以有效分离依赖系统数据和本系统数据。

总结

其实总结起来很简单,增加必要的封装和抽离,通过入参和返回值把控。 用看书的思维组织代码系统的,增加一个业务的可阅读可理解能力,在一个系统发展一定阶段之后,最让RD同学苦恼的不是技术问题,往往是一些业务逻辑或者布丁代码,所以研发同学要有意识的对业务和技术进行抽离,而不是简单的将技术和业务纠缠在一起,做好某块业务逻辑代码随时可以删掉而不影响系统的能力。 建立适当的代码命名规则,避免IDE带来的不必要的误用。 丰富wiki及文档,涉及到测试用例,数据库字段文档,产品PRD等。

本文参与 腾讯云自媒体同步曝光计划,分享自微信公众号。
原始发表:2018-04-21,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 春哥talk 微信公众号,前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 命名与注释
  • 抽离业务骨骼
  • 建立胶水层代码
  • 下层依赖代码
  • 总结
相关产品与服务
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档