设计模式学习笔记 - 设计原则 - 6.KISS原则和YAGNI原则

2024-03-03 03:12

本文主要是介绍设计模式学习笔记 - 设计原则 - 6.KISS原则和YAGNI原则,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

前言

今天,将两个设计原则:KISS 原则和 YANGI 原则。其中,KISS 原则比较经典,耳熟能详,但 YANGI 你可能没怎么听过,不过它理解起来也不难。

理解这个两个原则的时候,经常会有一个共同的问题,那就是看一眼就觉得懂了,但深究的话,又有很多细节不是很清楚。

  • 怎么理解 KISS 原则中的 “简单” ?
  • 什么代码才算 “简单”?怎样的代码才算 “复杂”?
  • 如何才能写出 “简单” 的代码?
  • YANGI 原则和 KISS 预原则说的是一回事吗?

理解 KISS 原则

KISS 原则的意思是尽量保持简单。它的英文描述有好几个版本:

  • keep it Simple and Stupid。
  • keep it Short and Simple。
  • keep it Simple and Straightforward。

我们知道,代码的可读性和可维护性是衡量代码质量非常重要的两个标准。而 KISS 原则就是保持代码可读性和可维护性的重要手段。代码足够简单,也意味着很容易读懂,bug 难以隐藏。即使出现 bug,修复起来也比较简单。

不过这条原则只是高速我们,要保持代码简单,但是并没有给出特别明确的方法论,来指导如何开发出 “简单” 的代码。所以看着简单,但是不能落地。

接下来,为了能让这条原则落地,来进一步进行讲解。

代码行数越少就越“简单”吗?

我们先来看一个例子。下面的三段代码实现同一个功能:检查输入字符串 ipAddress 是否是合法的 IP 地址。

合法的 IP 地址由四个数字组成,并通过 “.” 进行分割。每组数字的取值范围是 0~255。第一组数字比较特殊,不能为 0。

对比下面的代码,你觉得哪段代码最符合 KISS 原则呢?如果让你实现,你选用哪种实现方式?

// 第一种实现方式:使用正则表达式
public boolean isValidIpAddress(String ipAddress) {if (StringUtils.isBlank(ipAddress)) { 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 ipAddress.matches(regex);
}// 第一种实现方式:使用现成的工具类
public boolean isValidIpAddress2(String ipAddress) {if (StringUtils.isBlank(ipAddress)) { return false; }String[] ipUnits = StringUtils.split(ipAddress, ".");if (ipUnits.length != 4) { return false; }for (int i = 0; i < 4; 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;
}// 第三种方式:不适用工具类
public boolean isValidIpAddress3(String ipAddress) {char[] ipChars = ipAddress.toCharArray();int length = ipChars.length;int ipUnitIntValue = -1;boolean isFirstUnit = true;int unitsCount = 0;for (int i = 0; i < length; i++) {char ch = ipChars[i];if (ch == '.') {if (ipUnitIntValue < 0 || ipUnitIntValue > 255) { return false; }if (isFirstUnit && ipUnitIntValue == 0) { return false; }if (isFirstUnit) { isFirstUnit = false; }ipUnitIntValue = -1;unitsCount++;continue;}if (ch < '0' || ch > '9') { return false; }if (ipUnitIntValue == -1) { ipUnitIntValue = 0; }ipUnitIntValue = ipUnitIntValue * 10 + ch - '0';}if (ipUnitIntValue < 0 || ipUnitIntValue > 255) { return false; }if (unitsCount != 3) { return false; }return true;
}

第一种实现方式,利用的是正则表达式,只用三行代码就把这个问题搞定了。它的代码行数最少,但是它不符合 KISS 原则。虽然代码行数少,看似简单,实际上去很复杂。

  • 一方面,正则表达式本身是比较复杂的,写出完全没有 bug 的正则表达式本身就比较有挑战性;
  • 另一方面,并不是每个程序员都精通正则表达式。对于不怎么懂正则表达式的同时来说,看懂并且维护这段正则表达式是比较困难的。

这种实现方式会导致代码的可读性和可维护性变差,所以,从 KISS 原则设计初衷上来讲,这种实现方式并不符合 KISS 原则。

第二种实现方式,利用了 StringUtilsInteger 类提供的一些现成的工具函数,来处理 IP 地址字符串。这三种实现方式。第三种实现方式,不使用任何工具函数,而是通过逐一处理 IP 地址中的字符,来判断是否合法。从代码行数上来说,这两种实现方式差不多。但是,第三种要比第二种更加有难度,更容易写出 BUG。从可读性上来说,第二种实现方式的代码逻辑更清晰、更好理解。所以,在这两种实现方式中,第二种实现方式更加 “简单”,更加符合 KISS 原则。

你可能会说,第三种实现方式虽然会有点复杂,但是性能比第二种实现方式高。从性能角度来说,选择第三章方式是不是更好些呢?

第三种方式性能高的原因
一般来说,工具类的功能都比较通用和全面,所以,在代码实现上,需要考虑和处理更多的细节,执行效率会有所影响。而第三种实现方式,完全是自己操作底层字符串,只针对 IP 地址这一种格式的数据输入来做处理,没有太多多余的函数调用和其他不必要的处理逻辑,所以,在执行效率上,这类定制化的处理代码方式肯定比通用的工具类要高些。

尽管第三章方式性能更高,但是我还是倾向于第二种实现方式。因为第三种实现方式实际上是一种过度优化。除非 isValidIpAddress() 函数是影响系统性能的瓶颈代码,否则,这样优化的投入产出比并不高,增加了代码的实现难度、牺牲代码的可读性,性能上的提升去并不明显。

代码逻辑复杂就违背 KISS 原则吗?

刚刚提到,并不是代码行数越少就越 “简单”,还要考虑逻辑复杂度、实现难度、代码的可读性等。那如果一段代码的逻辑太复杂、实现难度大、可读性也不好,是不是就一定违背 KISS 原则呢?我们先看看下面一段代码:

// KMP algorithm: a,b 分别是主串和格式串;n,m 分别是主串和模式串的长度。
public static int kmp(char[] a, int n, char[] b, int m) {int[] next = getNexts(b, m);int j = 0;for (int i = 0; i < n; ++i) {while (j > 0 && a[i] != b[j]) { // 一直找到a[i]和b[j]j = next[j - 1] + 1;}if (a[i] == b[j]) {++j;}if (j == m) { // 找到匹配模式串了return i - m + 1;}}return -1;
}// b表示模式串,
public static int[] getNexts(char[] b, int m) {int[] next = new int[m];next[0] = -1;int k = -1;for (int i = 0; i < m; i++) {while (k != -1 && b[k + 1] != b[i]) {k = next[k];}if (b[k + 1] == b[i]) {++k;}next[i] = k;}return next;
}

这段代码完全符合我们提到的逻辑复杂、实现难度大、可读性差的特点,但它不违反 KISS 原则。为什么这么说呢?

KMP 算法以快速高效著称。当我们需要处理长文本字符串匹配问题(几百 MB 大小文本内容的匹配),或者字符串是某个产品的核心功能,又或者字符串匹配算法是系统性能瓶颈的时候,我们就应该选择尽可能搞下的 KMP 算法。而 KMP 算法本身具有逻辑复杂、实现难度大、可读性差的特点。本身就复杂的问题,用复杂的方法解决,并不违背 KISS 原则。

不过,平时的项目开发中涉及的字符串匹配问题,大部分都是针对比较小的文本。在这种情况下,直接调用编程语言提供的现成的字符串匹配函数就足够了。如果非用 KMP 算法、BM 算法来实现字符串匹配,那就真的违背 KISS 原则了。也就是说,同样的代码,在某个业务场景下符合 KISS 原则,换一个应用场景可能就不满足了。

如何写出满足 KISS 原则的代码?

实际上,前面已经讲到了一些方法了。这里总结下:

  • 不要使用同时可能不懂的技术来实现代码。比如前面例子中的正则表达式,还有一些编程语言中过于高级的语法等。
  • 不要重复造轮子,要善于使用已有的工具类库。经验证明,自己去实现这些类库,出 BUG 的概率会高,维护的成本更高。
  • 不要过度优化。不要过度使用一些奇技淫巧(比如,位运算代替算术运算、复杂的条件语句代替 if-else、使用一些过于底层的函数)来优化代码,牺牲代码的可读性。

实际上,代码是否足够简单,是一个挺主观的评判。同样的代码,有的人觉得简单,有的人觉得不简单。所以,评判代码是否简单,还有一个很有效的间接方法,那就是 code review。如果在 code review 的时候,同事对你的代码有很多疑问,那就说明你的代码有可能不够 “简单”,需要优化啦。

我们在做开发的时候,一定不要过度设计,不要觉得简单的东西就没有技术含量。实际上,越是能用简单的方法解决复杂的问题,越能体现一个人的能力。

YAGNI 和 KISS 说的是一回事吗?

YAGNI 原则的英文全称是:You Ain’t Gonna Need It。翻译:你不需要它。

在软件开发中,它的意思是:

  • 不要去设计当前用不到的功能;
  • 不要去编写当前用不到的代码。

这条原则的核心思想是不要过度设计

比如,我们的系统暂时只用 Redis 存储配置信息,以后可能会用到 Zookeeper。根据 YAGNI 原则,在未用到 Zookeeper 之前,我们没必要提前编写这部分代码。当然,这并不是说我们就不需要考虑代码的扩展性。我们还是要预留好扩展点,等到需要的时候,再去实现 Zookeeper 存储配置信息这部分代码。

还有,我们不要在项目中提前引入不需要依赖的开发包。对于 Java 程序员来说,经常使用 Maven 或者 Gradle 来管理类库。有些同时为了避免开发中 Library 包缺失而频繁地修改 Maven 或者 Gradle 配置文件,提前往项目里引入大量常用的 library 包。实际上,这样的做法是违背 YAGNI 原则的。

从刚刚的分析可以看出,YAGNI 原则和 KISS 原则并非一回事。KISS 原则讲的是“如何做”的问题(尽量保持简单),而 YAGNI 原则说的是 “要不要做的问题”(当前不需要的就不要做)。

总结

KISS 原则是保持代码可读性和可维护性的重要手段。KISS 原则中的 “简单” 并不是以代码行数来考量的。代码行数越少并不代表代码越简单,还需要考虑代码的复杂度、实现难度、代码的可读性等。而且,本身就复杂的问题,用复杂的方法解决,并不违背 KISS 原则。除此之外,同样的代码,在某个业务场景下满足 KISS 原则,换一个场景就可能不满足了。

对于 KISS 原则,还总结了下面几条原则:

  • 不要使用同事可能不懂的技术来实现代码
  • 不要重复造轮子,要善于使用已有的工具类库
  • 不要过度优化

这篇关于设计模式学习笔记 - 设计原则 - 6.KISS原则和YAGNI原则的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/768277

相关文章

HarmonyOS学习(七)——UI(五)常用布局总结

自适应布局 1.1、线性布局(LinearLayout) 通过线性容器Row和Column实现线性布局。Column容器内的子组件按照垂直方向排列,Row组件中的子组件按照水平方向排列。 属性说明space通过space参数设置主轴上子组件的间距,达到各子组件在排列上的等间距效果alignItems设置子组件在交叉轴上的对齐方式,且在各类尺寸屏幕上表现一致,其中交叉轴为垂直时,取值为Vert

Ilya-AI分享的他在OpenAI学习到的15个提示工程技巧

Ilya(不是本人,claude AI)在社交媒体上分享了他在OpenAI学习到的15个Prompt撰写技巧。 以下是详细的内容: 提示精确化:在编写提示时,力求表达清晰准确。清楚地阐述任务需求和概念定义至关重要。例:不用"分析文本",而用"判断这段话的情感倾向:积极、消极还是中性"。 快速迭代:善于快速连续调整提示。熟练的提示工程师能够灵活地进行多轮优化。例:从"总结文章"到"用

不懂推荐算法也能设计推荐系统

本文以商业化应用推荐为例,告诉我们不懂推荐算法的产品,也能从产品侧出发, 设计出一款不错的推荐系统。 相信很多新手产品,看到算法二字,多是懵圈的。 什么排序算法、最短路径等都是相对传统的算法(注:传统是指科班出身的产品都会接触过)。但对于推荐算法,多数产品对着网上搜到的资源,都会无从下手。特别当某些推荐算法 和 “AI”扯上关系后,更是加大了理解的难度。 但,不了解推荐算法,就无法做推荐系

【前端学习】AntV G6-08 深入图形与图形分组、自定义节点、节点动画(下)

【课程链接】 AntV G6:深入图形与图形分组、自定义节点、节点动画(下)_哔哩哔哩_bilibili 本章十吾老师讲解了一个复杂的自定义节点中,应该怎样去计算和绘制图形,如何给一个图形制作不间断的动画,以及在鼠标事件之后产生动画。(有点难,需要好好理解) <!DOCTYPE html><html><head><meta charset="UTF-8"><title>06

学习hash总结

2014/1/29/   最近刚开始学hash,名字很陌生,但是hash的思想却很熟悉,以前早就做过此类的题,但是不知道这就是hash思想而已,说白了hash就是一个映射,往往灵活利用数组的下标来实现算法,hash的作用:1、判重;2、统计次数;

在JS中的设计模式的单例模式、策略模式、代理模式、原型模式浅讲

1. 单例模式(Singleton Pattern) 确保一个类只有一个实例,并提供一个全局访问点。 示例代码: class Singleton {constructor() {if (Singleton.instance) {return Singleton.instance;}Singleton.instance = this;this.data = [];}addData(value)

零基础学习Redis(10) -- zset类型命令使用

zset是有序集合,内部除了存储元素外,还会存储一个score,存储在zset中的元素会按照score的大小升序排列,不同元素的score可以重复,score相同的元素会按照元素的字典序排列。 1. zset常用命令 1.1 zadd  zadd key [NX | XX] [GT | LT]   [CH] [INCR] score member [score member ...]

【机器学习】高斯过程的基本概念和应用领域以及在python中的实例

引言 高斯过程(Gaussian Process,简称GP)是一种概率模型,用于描述一组随机变量的联合概率分布,其中任何一个有限维度的子集都具有高斯分布 文章目录 引言一、高斯过程1.1 基本定义1.1.1 随机过程1.1.2 高斯分布 1.2 高斯过程的特性1.2.1 联合高斯性1.2.2 均值函数1.2.3 协方差函数(或核函数) 1.3 核函数1.4 高斯过程回归(Gauss

【学习笔记】 陈强-机器学习-Python-Ch15 人工神经网络(1)sklearn

系列文章目录 监督学习:参数方法 【学习笔记】 陈强-机器学习-Python-Ch4 线性回归 【学习笔记】 陈强-机器学习-Python-Ch5 逻辑回归 【课后题练习】 陈强-机器学习-Python-Ch5 逻辑回归(SAheart.csv) 【学习笔记】 陈强-机器学习-Python-Ch6 多项逻辑回归 【学习笔记 及 课后题练习】 陈强-机器学习-Python-Ch7 判别分析 【学

系统架构师考试学习笔记第三篇——架构设计高级知识(20)通信系统架构设计理论与实践

本章知识考点:         第20课时主要学习通信系统架构设计的理论和工作中的实践。根据新版考试大纲,本课时知识点会涉及案例分析题(25分),而在历年考试中,案例题对该部分内容的考查并不多,虽在综合知识选择题目中经常考查,但分值也不高。本课时内容侧重于对知识点的记忆和理解,按照以往的出题规律,通信系统架构设计基础知识点多来源于教材内的基础网络设备、网络架构和教材外最新时事热点技术。本课时知识