百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 编程字典 > 正文

DRY原则的一个简单实践

toyiye 2024-06-21 12:39 9 浏览 0 评论

DRY 是软件开发的原则之一,其目的主要是为了避免代码重复,指导开发者尽量以抽象的思维去解决重复,基本上是,当您发现自己一遍又一遍地编写相同的代码时,可能会有更好的方法。

实际案例

让我们先看一个例子,看看这个例子是否可以改进,以及如何通过重构来避免代码重复。

这里有一个简单的Report类,该类接收一些数据并通过控制台以格式化的方式直接输出。

我们这里使用php的一个代码片段来举例,相信大家对代码的结构和想要完成的工作都不难理解,所以为了大家更容易理解,我只对一些下面用到的php函数定义做一个解释:

1. echo() 函数输出一个或多个字符串

2. ucwords()函数把字符串中每个单词的首字符转换为大写。

3. strtolower() 函数把字符串转换为小写。

4. file_put_contents() 函数把一个字符串写入文件中。

5. floor() 函数向下舍入为最接近的整数。

class Report

{

public function show(array $data)

{

echo "Report: " . ucwords(strtolower($data["name"])) . "\n";

echo "Product: " . ucwords(strtolower($data["product"])) . "\n";

echo "Start date: " . date("Y/m/d", $data["startDate"]) . "\n";

echo "End date: " . date("Y/m/d", $data["endDate"]) . "\n";

echo "Total: " . $data["total"] . "\n";

echo "Average x day: " . floor($data["total"] / 365) . "\n";

echo "Average x week: " . floor($data["total"] / 52) . "\n";

}

}

可以看到,上面的代码完成目标是没有任何问题的。

这时我们对Report类提出一个新的需求:把所有字符串也可以保存到文件中。

我们经过一通复制和粘贴上面的代码,新建一个名为saveToFile的函数,就可以很快的完成这个需求,代码如下:

class Report

{

public function show(array $data)

{

echo "Report: " . ucwords(strtolower($data["name"])) . "\n";

echo "Product: " . ucwords(strtolower($data["product"])) . "\n";

echo "Start date: " . date("Y/m/d", $data["startDate"]) . "\n";

echo "End date: " . date("Y/m/d", $data["endDate"]) . "\n";

echo "Total: " . $data["total"] . "\n";

echo "Average x day: " . floor($data["total"] / 365) . "\n";

echo "Average x week: " . floor($data["total"] / 52) . "\n";

echo "Average x month: " . floor($data["total"] / 12) . "\n";

}

public function saveToFile(array $data)

{

$report = '';

$report .= "Report: " . ucwords(strtolower($data["name"])) . "\n";

$report .= "Product: " . ucwords(strtolower($data["product"])) . "\n";

$report .= "Start date: " . date("Y/m/d", $data["startDate"]) . "\n";

$report .= "End date: " . date("Y/m/d", $data["endDate"]) . "\n";

$report .= "Total: " . $data["total"] . "\n";

$report .= "Average x day: " . floor($data["total"] / 365) . "\n";

$report .= "Average x week: " . floor($data["total"] / 52) . "\n";

$report .= "Average x month: " . floor($data["total"] / 12) . "\n";

file_put_contents("./report.txt", $report);

}

}

那么,上面的代码能够满足我们提出的需求吗?答案当然"是的"。但是从技术角度来看,这段代码似乎是有些问题的,它的重复代码到处都是。无论是对代码阅读及后期维护来讲,这都是一场噩梦。

所以我们需要进行一些重构,抽象能抽象的方法,让冗繁的代码变得更简洁。

首先,我们对Report类进行功能上的抽象,生成报告并输出一共可以分为两个功能,一个只负责创建Report,一个只负责如何处理Report,那么让我们开始重构吧。

class Report

{

public function show(array $data)

{

echo $this->createReport($data);

}

public function saveToFile(array $data)

{

file_put_contents("./report.txt", $this->createReport($data));

}

private function createReport(array $data): string

{

$report = '';

$report .= "Report: " . ucwords(strtolower($data["name"])) . "\n";

$report .= "Product: " . ucwords(strtolower($data["product"])) . "\n";

$report .= "Start date: " . date("Y/m/d", $data["startDate"]) . "\n";

$report .= "End date: " . date("Y/m/d", $data["endDate"]) . "\n";

$report .= "Total: " . $data["total"] . "\n";

$report .= "Average x day: " . floor($data["total"] / 365) . "\n";

$report .= "Average x week: " . floor($data["total"] / 52) . "\n";

$report .= "Average x month: " . floor($data["total"] / 12) . "\n";

return $report;

}

}

现在看起来更清楚一些,对吗?

下面我们还有函数使用重复的问题要解决,例如,Report和Products的名称函数使用重复:

$report .= "Report: " . ucwords(strtolower($data["name"])) . "\n";

$report .= "Product: " . ucwords(strtolower($data["product"])) . "\n";

我们可以将这些转换抽象为一个新的函数:

private function normalizeName($name): string

{

return ucwords(strtolower($name));

}

另一个重复:日期格式。

$report .= "Start date: " . date("Y/m/d", $data["startDate"]) . "\n";

$report .= "End date: " . date("Y/m/d", $data["endDate"]) . "\n";

让我们将其抽象为:

private function formatDate($date): string

{

return date("Y/m/d", $date);

}

最后一个:平均值计算。

$report .= "Average x day: " . floor($data["total"] / 365) . "\n";

$report .= "Average x week: " . floor($data["total"] / 52) . "\n";

$report .= "Average x month: " . floor($data["total"] / 12) . "\n";

尽管计算结果并不完全相同,但执行的操作大家是一致的,所以可以抽象为如下:

private function calculateAverage(array $data, $period): string

{

return floor($data["total"] / $period);

}

所以,经过了一番重构,最终的Report类变为了如下:

class Report

{

public function show(array $data)

{

echo $this->createReport($data);

}

public function saveToFile(array $data)

{

file_put_contents("./report.txt", $this->createReport($data));

}

private function createReport(array $data)

{

$report = '';

$report .= "Report: " . $this->normalizeName($data["name"]) . "\n";

$report .= "Product: " . $this->normalizeName($data["product"]) . "\n";

$report .= "Start date: " . $this->formatDate($data["startDate"]) . "\n";

$report .= "End date: " . $this->formatDate($data["endDate"]) . "\n";

$report .= "Total: " . $data["total"] . "\n";

$report .= "Average x day: " . $this->calculateAverage($data, 365) . "\n";

$report .= "Average x week: " . $this->calculateAverage($data, 52) . "\n";

$report .= "Average x month: " . $this->calculateAverage($data, 12) . "\n";

return $report;

}

private function formatDate($date): string

{

return date("Y/m/d", $date);

}

private function calculateAverage(array $data, $period): string

{

return floor($data["total"] / $period);

}

private function normalizeName($name): string

{

return ucwords(strtolower($name));

}

}

这是一个简单的例子,实际情况可能比这要更加复杂的多,但我仅想通过这个实例向大家说明一个问题,那就是避免重复代码的重要性及我们如何通过重构去处理重复代码。

有时候重复一次相同的代码可能没问题,但是当第三次??我们写出相同的代码时,那就说明是时候重构你的代码了。

结论:

请记住DRY原则,并随时抱着不要重复自己代码的想法去完成开发工作。

相关推荐

为何越来越多的编程语言使用JSON(为什么编程)

JSON是JavascriptObjectNotation的缩写,意思是Javascript对象表示法,是一种易于人类阅读和对编程友好的文本数据传递方法,是JavaScript语言规范定义的一个子...

何时在数据库中使用 JSON(数据库用json格式存储)

在本文中,您将了解何时应考虑将JSON数据类型添加到表中以及何时应避免使用它们。每天?分享?最新?软件?开发?,Devops,敏捷?,测试?以及?项目?管理?最新?,最热门?的?文章?,每天?花?...

MySQL 从零开始:05 数据类型(mysql数据类型有哪些,并举例)

前面的讲解中已经接触到了表的创建,表的创建是对字段的声明,比如:上述语句声明了字段的名称、类型、所占空间、默认值和是否可以为空等信息。其中的int、varchar、char和decimal都...

JSON对象花样进阶(json格式对象)

一、引言在现代Web开发中,JSON(JavaScriptObjectNotation)已经成为数据交换的标准格式。无论是从前端向后端发送数据,还是从后端接收数据,JSON都是不可或缺的一部分。...

深入理解 JSON 和 Form-data(json和formdata提交区别)

在讨论现代网络开发与API设计的语境下,理解客户端和服务器间如何有效且可靠地交换数据变得尤为关键。这里,特别值得关注的是两种主流数据格式:...

JSON 语法(json 语法 priority)

JSON语法是JavaScript语法的子集。JSON语法规则JSON语法是JavaScript对象表示法语法的子集。数据在名称/值对中数据由逗号分隔花括号保存对象方括号保存数组JS...

JSON语法详解(json的语法规则)

JSON语法规则JSON语法是JavaScript对象表示法语法的子集。数据在名称/值对中数据由逗号分隔大括号保存对象中括号保存数组注意:json的key是字符串,且必须是双引号,不能是单引号...

MySQL JSON数据类型操作(mysql的json)

概述mysql自5.7.8版本开始,就支持了json结构的数据存储和查询,这表明了mysql也在不断的学习和增加nosql数据库的有点。但mysql毕竟是关系型数据库,在处理json这种非结构化的数据...

JSON的数据模式(json数据格式示例)

像XML模式一样,JSON数据格式也有Schema,这是一个基于JSON格式的规范。JSON模式也以JSON格式编写。它用于验证JSON数据。JSON模式示例以下代码显示了基本的JSON模式。{"...

前端学习——JSON格式详解(后端json格式)

JSON(JavaScriptObjectNotation)是一种轻量级的数据交换格式。易于人阅读和编写。同时也易于机器解析和生成。它基于JavaScriptProgrammingLa...

什么是 JSON:详解 JSON 及其优势(什么叫json)

现在程序员还有谁不知道JSON吗?无论对于前端还是后端,JSON都是一种常见的数据格式。那么JSON到底是什么呢?JSON的定义...

PostgreSQL JSON 类型:处理结构化数据

PostgreSQL提供JSON类型,以存储结构化数据。JSON是一种开放的数据格式,可用于存储各种类型的值。什么是JSON类型?JSON类型表示JSON(JavaScriptO...

JavaScript:JSON、三种包装类(javascript 包)

JOSN:我们希望可以将一个对象在不同的语言中进行传递,以达到通信的目的,最佳方式就是将一个对象转换为字符串的形式JSON(JavaScriptObjectNotation)-JS的对象表示法...

Python数据分析 只要1分钟 教你玩转JSON 全程干货

Json简介:Json,全名JavaScriptObjectNotation,JSON(JavaScriptObjectNotation(记号、标记))是一种轻量级的数据交换格式。它基于J...

比较一下JSON与XML两种数据格式?(json和xml哪个好)

JSON(JavaScriptObjectNotation)和XML(eXtensibleMarkupLanguage)是在日常开发中比较常用的两种数据格式,它们主要的作用就是用来进行数据的传...

取消回复欢迎 发表评论:

请填写验证码