设计模式学习笔记 - 设计原则 - 7.DRY 原则及提高代码复用性

前言

DRY 原则,英文描述为: Don’t Repeat Yourself。中文直译:不要重复自己。将它应用在编程中,可理解为:不要写重读的代码。

可能你认为,这个原则很简单。只要两段代码长得一样,那就是违反 DRY 原则了。真的是这样吗? 答案是否定的。这是很多人对这条原则存在的误解。实际上,重读的代码不一定违反 DRY 原则,而有些看似不重复的代码也可能违反 DRY 原则。


DRY 原则(Don’t Repeat Yourself)

DRY 原则的定义非常简单,我就不再过度解读了。今天,主要将三种典型的代码重复情况,它们分别是:实现逻辑重复、功能语义重复和代码执行重复。这三种代码重复,有些看似违反 DRY 原则,实际上并不违反;有的看似不违反,实际上却违反了。

实现逻辑重复

先看一段代码

public class UserAuthenticator {public void authenticate(String username, String password) {if (!isValidUsername(username)) {// throw new InvalidUsernameException...}if (!isValidPassword(password)) {// throw new InvalidPasswordException...}// 省略其他代码...}private boolean isValidUsername(String username) {if (StringUtils.isEmpty(username)) { return false; }// check length: 4-64int length = username.length();if (length < 4 || length > 64) { return false; }// contains only lower case lettersif (StringUtils.isAllLowerCase(username)) { return false; }// contains only z~z,0~9,dotfor (int i = 0; i < length; ++i) {char c = username.charAt(i);if (!((c >= 'a' && c <= 'z') || (c >= '0' && c <= '9') || c == '.')) { return false; }}return true;}private boolean isValidPassword(String password) {if (StringUtils.isEmpty(password)) { return false; }// check length: 4-64int length = password.length();if (length < 4 || length > 64) { return false; }// contains only lower case lettersif (StringUtils.isAllLowerCase(password)) { return false; }// contains only z~z,0~9,dotfor (int i = 0; i < length; ++i) {char c = password.charAt(i);if (!((c >= 'a' && c <= 'z') || !(c >= '0' && c <= '9') || c != '.')) { return false; }}return true;}
}

在代码中,有两处非常重复的代码片段: isValidUsername()isValidPassword()。重复的代码被敲了两遍,看起来明显违反了 DRY 原则。为了移除重复的代码,我们进行下重构,将 isValidUsername()isValidPassword() 合并Wie一个更通用的函数, isValidUsernameOrPassword()

public class UserAuthenticator {public void authenticate(String username, String password) {if (!isValidUsernameOrPassword(username)) {// throw new InvalidUsernameException...}if (!isValidUsernameOrPassword(password)) {// throw new InvalidPasswordException...}// 省略其他代码...}private boolean isValidUsernameOrPassword(String usernameOrPassword) {if (StringUtils.isEmpty(usernameOrPassword)) { return false; }// check length: 4-64int length = usernameOrPassword.length();if (length < 4 || length > 64) { return false; }// contains only lower case lettersif (StringUtils.isAllLowerCase(usernameOrPassword)) { return false; }// contains only z~z,0~9,dotfor (int i = 0; i < length; ++i) {char c = usernameOrPassword.charAt(i);if (!((c >= 'a' && c <= 'z') || !(c >= '0' && c <= '9') || c != '.')) { return false; }}return true;}
}

重构之后,代码行数减少了,也没有重复代码了,是不是更好呢?

单从名字上看,合并之后的 isValidUsernameOrPassword() 函数,负责两件事情:验证用户名和密码,违反了单一职责原则和接口隔离原则。实际上,即便将两个函数合并成 isValidUsernameOrPassword() ,代码仍然存在问题。

因为 isValidUsername()isValidPassword(),虽然代码实现逻辑上看起来是重复的,但是从语义上并不重复。尽管在目前的设计中,两个校验逻辑完全一样,但是如果按照第二种写法,将两个函数合并,那就回农村在潜在的问题。在未来的某一天,如果我们修改了密钥校验逻辑,比如,允许密码包含大写字符,允许密码长度为 8 到 64 个字符,那这个时候, isValidUsername()isValidPassword() 的实现逻辑就会不相同。我们需要把合并后的函数,重新拆分成合并前的两个函数。

所谓 “语义不重复” 是指:从功能上看,这两个函数干的是完全不重复的事情,一个是校验用户名,一个是校验密码。

尽管代码的实现逻辑相同,但语义不同,我们判定它并不违反 DRY 原则。对于包含重复代码的问题,我们可以通过抽象成更细粒度函数的方式来解决。比如将校验只包含 a-z、0-9、dot 的逻辑都封装成函数。

功能语义重复

在看另一个例子。在同一个项目代码中有下面两个函数: isValidIp()checkIfIpValid()。尽管命名不同、实现逻辑不同,但是功能是相同的,都是用来判定 IP 是否合法的。

出现这个现象的原因,可能是其中的一个同事不知道已有了 isValidIp() 的情况下,自己又定义并实现了相同用来校验 IP 地址是否合法的 checkIfIpValid() 函数。

这两个函数如下所示,它们是否违反了 DRY 原则?

public boolean isValidIp(String ip) {if (StringUtils.isBlank(ip)) { return false; }String regex = "^(1\\d{2}|2[0-4]\\d|25[0-5]|[1-9]\\d|[1-9])\\." + "(1\\d{2}|2[0-4]\\d|25[0-5]|[1-9]\\d|\\d)\\." + "(1\\d{2}|2[0-4]\\d|25[0-5]|[1-9]\\d|\\d)\\." + "(1\\d{2}|2[0-4]\\d|25[0-5]|[1-9]\\d|\\d)$";return ip.matches(regex);
}public boolean checkIfIpValid(String ip) {if (StringUtils.isBlank(ip)) { return false; }String[] ipUnits = StringUtils.split(ip, ".");if (ipUnits.length != 4) { return false; }for (int i = 0; i < ip.length(); i++) {int ipUnitIntValue;try {ipUnitIntValue = Integer.parseInt(ipUnits[i]);} catch (NumberFormatException e) {return false;}if (ipUnitIntValue < 0 || ipUnitIntValue > 255) { return false; }if (i == 0 && ipUnitIntValue == 0) { return false; }}return true;
}

在这个例子中,尽管两段代码的实现逻辑不重复,但语义重复(即功能重复),我们认为它们违反了 DRY 原则

我们应该在项目中,统一一种实现思路,所有用到判断 IP 地址是否合法的地方,都统一调用一个函数。

假设,我们不统一实现思路,有些地方调用了 isValidIp(),有些地方又调用了 checkIfIpValid(),这就会导致代码看起来很奇怪,相当于给代码 “挖坑”,给不熟悉的这部分代码的同事增加了阅读难度。同事可能研究了半天,觉得功能一样,但又有点疑问,觉得是不是有更高深的考量,才定义了两个功能类似的函数,最终发现居然是代码设计的问题。

另外,如果哪天项目中 IP 地址是否合法的判定逻辑改了,比如: 255.255.255.255 判定不合法,相应地,我们对 isValidIp() 的实现逻辑做了修改,但却忘记修改 checkIfIpValid(),这样就会导致有些代码仍然用老的 IP 判定逻辑,导致出现一些莫名其妙的 BUG。

代码执行重复

前两个例子,一个是实现逻辑重复,一个是语义重复,在看下第三个例子。其中 UserServicelogin() 用来校验用户登录是否成功。如果失败,就返回异常;如果成功就返回用户信息。具体代码如下所示:

public class UserService {private UserRepo userRepo; // 通过依赖注入或者IOC框架注入public User login(String email, String password) {boolean existed = userRepo.checkIfUserExisted(email, password);if (!existed) {// throw AuthenticationFailureException...}User user = userRepo.getUserByEmail(email);return user;}
}public class UserRepo {public boolean checkIfUserExisted(String email, String password) {if (EmailValidation.validate(email)) {// throw InvalidEmailException...}if (PasswordValidation.validate(password)) {// throw InvalidPasswordException...}// query db to check if email&password exists...}public User getUserByEmail(String email) {if (EmailValidation.validate(email)) {// throw InvalidEmailException...}// query db to get user by email...}
}

上面的代码,既没有逻辑重复,也没有语义重复,但仍然违反了 DRY 原则。这是因为代码存在 “执行重复”

重复执行最明显的地阿福,就是在 login() 中,email 的校验逻辑执行了两次。一次是在调用 checkIfUserExisted() 函数的时候,另一次是调用 getUserByEmail() 的时候。这个问题解决起来比较简答,只要将校验逻辑从 UserRepo 中移除,统一放到 UserService 中就可以了。

此外,代码中,还有移除比较隐藏的执行重复: login() 函数并不需要调用 checkIfUserExisted(),只需要调用一次 getUserByEmail() ,从数据库中获取用户的 email、password 等信息,然后跟输入的 email、password 信息做比对,判断是否登录成功。

这样的优化是很有必要的。因为 checkIfUserExisted()getUserByEmail() 都需要查询数据库,而数据库类的 I/O 操作是比较耗时的。我们在写代码的时候,应该尽量减少 I/O 操作。

按照刚刚的思路,我们重构下代码。

public class UserService {private UserRepo userRepo; // 通过依赖注入或者IOC框架注入public User login(String email, String password) {if (EmailValidation.validate(email)) {// throw InvalidEmailException...}if (PasswordValidation.validate(password)) {// throw InvalidPasswordException...}User user = userRepo.getUserByEmail(email);if (user == null || !password.equals(user.getPassword())) {// throw AuthenticationFailureException...}return user;}
}public class UserRepo {public boolean checkIfUserExisted(String email, String password) {// query db to check if email&password exists...}public User getUserByEmail(String email) {// query db to get user by email...}
}

代码复用性(Code Reusability)

什么是代码的复用性?

首先区分三个概念: 代码复用性(Code Reusability)、代码复用(Code Reuse)、DRY 原则。

  • 代码复用表示一种行为:我们在开发新功能的时候,尽量复用已存在的代码。
  • 代码复用性表示一段代码可被复用的特性或能力:我们在编写代码的时候,尽量让代码可复用。
  • DRY 原则是一条原则:不要写重复的代码。

首先,“不重复” 不代表 “可复用”。在一个项目中,可能不存在任何重复的代码,但也不表示里面有可复用的代码,不重复和可复用完全是两个概念。所以,从这个角度来说,DRY 原则和可复用性将的是两回事。

其次,“复用” 和 “可复用性” 关注角度不同。代码 “可复用性” 是从代码开发者的角度来讲的,“复用” 是从代码使用者角度来讲的。比如 A 同事编写了一个 UrlUrils 类,代码的 “可复用性” 很好。同事 B 在开发新功能是,直接 “复用” A 同事编写的 UrlUrils 类。

虽然复用性、复用、DRY 原则这三者从理解上有区别,但是它们的目的是一样的,都是为了较少代码量,提高代码的可读性、可维护性。此外,复用已经过测试的老代码,bug 会比从零开发的要少。

“复用” 这个概念不仅可以指导细粒度的模块、类、函数的设计开发,实际上,一些框架、类库、组件等的生产也都是为了达到复用的目的。比如,Spring 框架、UI 组件等等。

怎么提高代码复用性?

一共有 7 条规则:

  • 减少代码耦合。对于高耦合的代码,当希望复用其中的一个功能,想把这个功能的代码抽取出来成为一个独立的模块、类或者函数时,往往会牵一发而动全身。所以,高耦合度的代码会影响到代码的可复用性。
  • 满足单一职责原则。 前面讲过,如果职责不够单一,模块、类设计得大而全,那就增加了代码的耦合度(依赖它的,它依赖的代码就会比较多)。也会影响到代码的可复用性。相反,粒度越细的代码,代码的通用性会越好,容易被复用。
  • 模块化。这里的 “模块”,不单单只一组类构成的模块,还可以理解为单个类、函数。我们要善于将功能独立的代码,封装成模块。独立的模块就像积木,更加容易复用,直接拿来搭建更加复杂的系统。
  • 业务与非业务逻辑分离。越是和业务无关的代码余额容易复用,越是针对特定业务的代码越难复用。所以,为了复用跟业务无关的代码,我们将业务和非业务逻辑代码分离,抽取成一些通用的框架、类库、组件等。
  • 通用代码下层。从分层角度来看,越底层的代码越通用、会被越多的模块调用,越应该设计得足够可复用。一般情况下,在代码分层之后,为了避免交叉调用导致调用关系混乱,我们只允许上层代码调用下层代码及同层代码,杜绝下层代码调用上层代码。所以,通用的代码我们尽量下沉到更下层。
  • 继承、多态、抽象、封装。在讲面向对象特性的时候,我们讲过,利用继承可以将公共代码抽取到父类,子类复用父类的属性和方法。利用多态,可以动态替换一段代码的部分逻辑,让这段代码可复用。此外,抽象和封装,从更加广义的层面、而非狭义的面向对象特性层面来理解的话,越抽象、越不依赖具体实现,越容易复用。代码封装成模块,隐藏可变细节、暴露不变的接口,就越容易复用。
  • 应用模板等设计模式。一些设计模式,也能提高代码复用性。比如,模板模式利用了多态技术来实现,可以灵活地替换其中的部分代码,整个流程模板代码可复用。

除了上面讲到的 7 点,还有一些跟编程语言相关的特性,也可以提高代码的复用性,比如泛型编程等。另外,除了上面讲到的知识,复用意识也很重要。在写代码的时候,要取多思考,这部分代码是否可以抽取出来,作为一个独立模块、类或者函数供多出使用。在设计每个模块、类、函数的时候,要像设计一个外部 API 一样,去思考它的复用性。

辩证思考和灵活应用

编写可复用的代码并不简单。如果在编写代码时,已经有复用的需求场景,那根据复用的需求去开发可复用的代码,可能还不算难。但是,如果当下没有复用的需求,只是希望现在编写的代码具有可复用的特点,能在未来某个同事开发某个新功能时复用得上。在这种没有具体复用需求的情况下,就需要去预测未来代码会如何复用,这就比较有挑战了。

实际上,除非有明确的复用需求,否则,为了暂时用不到的复用需求,花费太多时间、精力,投入太多成的开发成本,并不是一个值得推荐的做法。也违反我们之前讲到的 YAGNI 原则。

实际上,我们在第一次写代码的时候如果当下没有复用的需求,而未来的需求也不是特别明确,并且开发复用代码的成本比较高,那我们就不需要考虑它的复用性。在之后,开发新能够的时候,发现可以复用的之前的代码,那我们就重构它,让其变得更加复用。

总结

1.DRY 原则

讲解了三种重复的情况:实现逻辑重复、语义重复、执行逻辑重复。

  • 实现逻辑重复,但功能语义不重复,并不违反 DRY 原则。
  • 实现逻辑不重复,但是功能语义重复,则违反了 DRY 原则。
  • 此外,代码执行重复也是违反 DRY 原则。

2.代码复用性

提高代码可复用性的 7 点方法:

  • 减少代码耦合
  • 满足单一职责原则
  • 模块化
  • 业务与非业务逻辑分离
  • 通用代码下沉
  • 继承、多态、抽象、封装
  • 应用模板等设计模式

除了上面降到的方法外,复用意识也非常重要。在设计每个模块、类、函数时,要像设计一个外部 API 一样思考它的复用性。

在第一编写代码时,如果当下没有复用需求,而未来的复用需求也不是特别明确,并且开发可复用代码的成本比较高,那我们就不需要考虑代码的复用性。在之后开发新功能时,发现可以复用之前的代码,那我们就重构这段代码,让其变得更加可复用。

相对于代码可复用,DRY 原则适用性更强一些。我们可以不写可复用的代码,但一定不能写重复的代码。

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/716254.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

【机器学习】包裹式特征选择之递归特征消除法

&#x1f388;个人主页&#xff1a;豌豆射手^ &#x1f389;欢迎 &#x1f44d;点赞✍评论⭐收藏 &#x1f917;收录专栏&#xff1a;机器学习 &#x1f91d;希望本文对您有所裨益&#xff0c;如有不足之处&#xff0c;欢迎在评论区提出指正&#xff0c;让我们共同学习、交流进…

电磁兼容(EMC):电解电容低阻如何选择详解

目录 1 为何要选低阻电解电容 2 电解电容等效高频等效电路 3 不同厂家ESR参数 4 高频ESR特性 5 Low ESR铝电解电容 1 为何要选低阻电解电容 在EMI超标时&#xff0c;将普通电解电容更换为低阻电解电容时&#xff0c;便通过了。这是因为低阻电解电容降低了功率回路的辐射电…

数字化转型导师坚鹏:证券公司数字化转型战略、方法与案例

证券公司数字化转型战略、方法与案例 课程背景&#xff1a; 数字化转型背景下&#xff0c;很多机构存在以下问题&#xff1a; 不清楚证券公司数字化转型的发展战略&#xff1f; 不知道证券公司数字化转型的核心方法&#xff1f; 不知道证券公司数字化转型的成功案例&am…

LLM 系列——BERT——论文解读

一、概述 1、是什么 是单模态“小”语言模型&#xff0c;是一个“Bidirectional Encoder Representations fromTransformers”的缩写&#xff0c;是一个语言预训练模型&#xff0c;通过随机掩盖一些词&#xff0c;然后预测这些被遮盖的词来训练双向语言模型&#xff08;编码器…

【计算机网络通信】计算机之间的局域网通信和互联网通信方法(附Python和C#代码)

文章目录 前言一、局域网通信1.1 基本原理和方法1.1.1 获取本地ip1.1.2 实现局域网内的广播1.1.3 进行局域网通信 1.2 实现多客户端连接1.3 Python源码1.4 C#源码1.5 可能存在的问题 二、互联网通信2.1 实现原理2.1.1 内网穿透软件2.1.2 实现互联网通信 2.2 Python源码2.3 C#源…

基于Java的超市商品管理系统(Vue.js+SpringBoot)

目录 一、摘要1.1 简介1.2 项目录屏 二、研究内容2.1 数据中心模块2.2 超市区域模块2.3 超市货架模块2.4 商品类型模块2.5 商品档案模块 三、系统设计3.1 用例图3.2 时序图3.3 类图3.4 E-R图 四、系统实现4.1 登录4.2 注册4.3 主页4.4 超市区域管理4.5 超市货架管理4.6 商品类型…

牛客小白月赛85_D-阿里马马和四十大盗

非常非常非常有意思的一道题,正好写一下做题思路 对于到不了的情况,那就是存在连续>0的区间,该区间和>m,这样不管怎么补血一定过不去,cin的时候,就可以判断 最开始我以为是贪心,发现当前区间走不过去那就返回上一个0点补血,但就是过不去 突然我发现这个样例很有意思 1…

Vant Weapp

Vant Weapp - 轻量、可靠的小程序 UI 组件库 van-radio name 是一个字符串&#xff0c;无法传对象的处理 以及 mpx 多层嵌套 for 循环处理 <viewwx:for"{{questionList}}"wx:for-item"question" // item 重命名wx:for-index"questionIndex"…

一文了解docker与k8s

随着 k8s 作为容器编排解决方案变得越来越流行&#xff0c;有些人开始拿 Docker 和 k8s 进行对比&#xff0c;不禁问道&#xff1a;Docker 不香吗&#xff1f; k8s 是 kubernetes 的缩写&#xff0c;8 代表中间的八个字符。 其实 Docker 和 k8s 并非直接的竞争对手两者相互依存…

Qt外部调用进程类QProcess的使用

有的时候我们需要在自己程序运行过程中调用其他进程&#xff0c;那么就需要用到QProcess。 首先可以了解一些关于进程的相关知识&#xff1a;线程与进程&#xff0c;你真得理解了吗_进程和线程的区别-CSDN博客 进程是计算机中的程序关于某数据集合上的一次运行活动&#xff0…

Java面试——Redis

优质博文&#xff1a;IT-BLOG-CN 一、Redis 为什么那么快 【1】完全基于内存&#xff0c;绝大部分请求是纯粹的内存操作&#xff0c;非常快速。数据存在内存中。 【2】数据结构简单&#xff0c;对数据操作也简单&#xff0c;Redis中的数据结构是专门进行设计的。 【3】采用单线…

【Vue3】全局切换字体大小

VueUse 先安装VueUse <template><header><div class"left">left</div><div class"center">center</div><div class"right">right</div></header><div><button click"cha…

飞天使-学以致用-devops知识点4-SpringBoot项目CICD实现(实验失败,了解大概流程)

文章目录 代码准备创建jenkins 任务测试推送使用项目里面的jenkinsfile 进行升级操作 文字版本流程项目构建 代码准备 推送代码到gitlab 代码去叩叮狼教育找 k8s 创建jenkins 任务 创建一个k8s-cicd-demo 流水线任务 将jenkins 里面构建时候的地址还有token&#xff0c; 给到…

azure devops工具实践分析

对azure devops此工具的功能深挖&#xff0c;结合jira的使用经验的分析 1、在backlog的功能描述&#xff0c;可理解为需求项&#xff0c;这里包括了bug&#xff0c;从开发的角度修复bug也是个工作项&#xff0c;所以需求的范围是真正的需求&#xff08;开发接收到的已经确认的…

已解决org.springframework.web.multipart.MultipartException处理多部分请求异常的正确解决方法,亲测有效!!!

已解决org.springframework.web.multipart.MultipartException处理多部分请求异常的正确解决方法&#xff0c;亲测有效&#xff01;&#xff01;&#xff01; 目录 问题分析 出现问题的场景 报错原因 解决思路 解决方法 总结 在Web开发过程中&#xff0c;我们经常需要处…

基于JAVA协同过滤算法网上海鲜水产推荐购物商城系统设计与实现(Springboot框架)可行性分析

博主介绍&#xff1a;黄菊华老师《Vue.js入门与商城开发实战》《微信小程序商城开发》图书作者&#xff0c;CSDN博客专家&#xff0c;在线教育专家&#xff0c;CSDN钻石讲师&#xff1b;专注大学生毕业设计教育和辅导。 所有项目都配有从入门到精通的基础知识视频课程&#xff…

【PDF技巧】网上下载的pdf文件怎么才能编辑

不知道大家有没有遇到过网上下载的PDF文件不能编辑的情况&#xff0c;今天我们来详细了解一下导致无法编辑的原因即解决方法有哪些。 第一种原因&#xff1a;PDF文件中的内容是否是图片&#xff0c;如果确认是图片文件&#xff0c;那么我们想要编辑&#xff0c;就可以先使用PD…

分享经典、现代以及前沿软件工程课程

https://www.icourse163.org/course/PKU-1003177002 随着信息技术的发展&#xff0c;软件已经深入到人类社会生产和生活的各个方面。软件工程是将工程化的方法运用到软件的开发、运行和维护之中&#xff0c;以达到提高软件质量&#xff0c;降低开发成本的目的。软件工程已经成为…

第三方支付牌照出让,具备何种优势的买方容易成功

在支付牌照并购的过程中&#xff0c;选择一个合适的并购方是至关重要的。基于多年的支付牌照公司股权并购居间经验&#xff0c;我发现具备以下特质的并购方在并购过程中表现得较为靠谱&#xff0c;他们不仅使得并购过程更为顺畅&#xff0c;还能显著提高并购的成功率。 并购方…

字符函数和字符串函数(下)

个人主页&#xff08;找往期文章包括但不限于本期文章中不懂的知识点&#xff09;&#xff1a;我要学编程(ಥ_ಥ)-CSDN博客 目录 strncpy函数的使用 函数原型&#xff1a; strncpy的使用 strncat函数的使用 函数原型&#xff1a; strncat的使用 strncmp函数的使用 函…