第二部分:理论六

第二部分:理论六

理论六

如何理解“KISS 原则”?

  • KISS 原则的英文描述有好几个版本,比如:Keep It Simple and Stupid,翻译成中文就是:尽量保持简单。
  • 代码的可读性和可维护性是衡量代码质量非常重要的两个标准。而KISS 原则就是保持代码可读和可维护的重要手段。

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

  • 比如,检查输入的字符串是否是合法的IP地址。
  • 第一种实现方式: 使用正则表达式。
    • 代码行数最少,只有三行代码
    • 但并不是最符合KISS原则的
    • 因为使用正则表达式本身就比较复杂,bug率高
    • 并不是每个程序员都精通正则表达式,会导致代码的可读性和可维护性变差
  • 第二种实现方式: 使用现成的工具类,实现方式更加“简单”,更加符合 KISS 原则。
  • 第三种实现方式: 不使用任何工具类
    • 代码行数和第二种差不多
    • 比第二种有难度,容易出bug
    • 可读性差
    • 完全是自己操作底层字符,没有多余函数调用和不必要的处理逻辑,性能更高些
    • 但除非第二种方法调用的工具类成为性能瓶颈代码,第三种实际上是一种过度优化,牺牲了代码的可读性和实现难度,投入产出比不高

检查输入的字符串ipAddress 是否是合法的 IP 地址:

// 第一种实现方式: 使用正则表达式
public boolean isValidIpAddressV1(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 isValidIpAddressV2(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 isValidIpAddressV3(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 c = ipChars[i];
		if (c == '.') {
			if (ipUnitIntValue < 0 || ipUnitIntValue > 255) return false;
			if (isFirstUnit && ipUnitIntValue == 0) return false;
			if (isFirstUnit) isFirstUnit = false;
			ipUnitIntValue = -1;
			unitsCount++;
			continue;
		}
		if (c < '0' || c > '9') {
			return false;
		}
		if (ipUnitIntValue == -1) ipUnitIntValue = 0;
		ipUnitIntValue = ipUnitIntValue * 10 + (c - '0');
	}
	if (ipUnitIntValue < 0 || ipUnitIntValue > 255) return false;
	if (unitsCount != 3) return false;
	return true;
}

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

  • 比如,KMP 字符串匹配算法,是一个查找字符串匹配的算法,具体什么法没看懂
  • KMP 算法本身具有逻辑复杂、实现难度大、可读性差的特点。本身就复杂的问题,用复杂的方法解决,并不违背 KISS 原则。
  • 不过,平时的项目开发中涉及的字符串匹配问题,大部分都是针对比较小的文本,直接调用编程语言提供的现成的字符串匹配函数就足够了,如果非得用复杂的KMP算法,那真的违背KISS原则了

KMP 字符串匹配算法:

// 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 表示模式串,m 表示模式串的长度
private static int[] getNexts(char[] b, int m) {
	int[] next = new int[m];
	next[0] = -1;
	int k = -1;
	for (int i = 1; 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 原则的代码?

  • 不要使用同事可能不懂的技术来实现代码。比如前面例子中的正则表达式,还有一些编程语言中过于高级的语法等。
  • 不要重复造轮子,要善于使用已经有的工具类库。经验证明,自己去实现这些类库,出 bug 的概率会更高,维护的成本也比较高。
  • 不要过度优化。不要过度使用一些奇技淫巧(比如,位运算代替算术运算、复杂的条件语句代替 if-else、使用一些过于底层的函数等)来优化代码,牺牲代码的可读性。
  • 评判代码是否简单,还有一个很有效的间接方法,那就是 code review。
  • 一定不要过度设计,不要觉得简单的东西就没有技术含量。

YAGNI 跟 KISS 说的是一回事吗?

  • YAGNI 原则的英文全称是:You Ain’t Gonna Need It。直译就是:你不会需要它。
  • 这条原则的核心思想就是:不要做过度设计。
  • 比如,我们的系统暂时只用 Redis 存储配置信息,以后可能会用到 ZooKeeper。根据 YAGNI 原则,在未用到 ZooKeeper 之前,我们没必要提前编写这部分代码。当然,这并不是说我们就不需要考虑代码的扩展性。
  • 再比如,我们不要在项目中提前引入不需要依赖的开发包。
  • KISS 原则讲的是“如何做”的问题(尽量保持简单),而 YAGNI 原则说的是“要不要做”的问题(当前不需要的就不要做)。
posted @ 2021-10-04 13:04  起床睡觉  阅读(47)  评论(0编辑  收藏  举报