已剪辑自: https://mp.weixin.qq.com/s/uo4tnsEnpULAruayZHcKAw

随着我们工程化经验的增加,不知不觉的我们就会关心到这个问题,模块化,模块设计就显现出来,那到底什么是模块化呢?

这不叫模块化!

我相信在很多时候,我们刚开始从零开始接手一个项目的时候,编码之前总想着要实现什么的功能需要的模块,然后要程序模块化,这种思想是值得认同的,但往往我们并没有做到真正的模块化。

例如在一个需要很多外设接口,一般需要硬件初始化,相关配置,中断服务程序,输入输出,逻辑处理等功能,我们的做法可能就是把代码分布到多个文件和目录里面,然后把这些目录或者文件取名xxxModule

甚至把这些目录分放在不同的仓库目录里面,结果随着编码的增加,发现好多小功能都重复了,或者本可以写在一起的函数并没有放在一起,导致我们的代码思想不是很流畅,这样做会误导我们,甚至整个项目实现的思路。

究其原因这是因为我们其实并不理解什么叫做模块,而仅仅是肤浅的把代码切割开来,分放在不同的位置,虽然这确实达到了部分模块化的目的,但是也会制造一些不必要的麻烦。

什么是真正的模块化?

真正的模块化,并不是简单文本意义上的,而是与逻辑相关的有逻辑意义的。一个模块应该像一个集成电路芯片,我们能见到能使用的都很清晰,它定义了良好的输入和输出。

模块是可能分开地被编写的单位。这使他们可再用和允许广泛人员同时协作、编写及研究不同的模块。

实际上,编程语言已经为我们提供了一种很好的模块化方法,它的名字叫做函数。每一个函数都有明确的输入(参数)和输出(返回值),同一个文件里可以包含多个函数,所以你其实根本不需要把代码分开在多个文件或者目录里面,同样可以完成代码的模块化。

按照函数这个原则,我可以把代码全都写在同一个文件里,却仍然是非常模块化的代码,是不是觉得与之前的想法不一样?

是的,软件编程模块是一套一致而互相有紧密关联的软件组织,每个模块完成一个特定的子功能,所有的模块按某种方法组装起来,成为一个整体,完成整个系统所要求的功能,这就是真正的模块化。

怎么模块化?

我们知道了模块化的原则与道理之后,就可以按照这个思路去开发项目了,想要达到很好的模块化,你需要做到以下几点。我们从实现角度来说。

避免写太长的函数

一眼望去,如果一个函数的代码你电脑一页都看不完,那肯定是冗长了或者不符合模块化编程了。不需要滚屏就可以看得到全部的函数内容,那对我们的理解也有帮助。

一般来说一个函数最好不要超过40行代码(当然这个不是死规定,只是一个经验建议而已),如果写的函数太大了,就应该把它拆分成几个更小的函数。

也许你会说到,这很难办到,逻辑很多或者很多判断条件的时候,40行往往不够吧,那么其实我们也需要考虑到函数里面一些复杂的部分,是不是可以提取出来,单独写一个小函数,再从原来的函数里面调用。

另外函数层级也不要太多,比如一个函数长成这样:

 1void function(void* para)2{3    if (getOS().equals("MacOS")) {4        a();5        if(getOS().equals("AndroidOS")){6            b();7            if(getOS().equals("flymeOS")){8              c();9            }
10        }
11    }
12}

我们看到这个函数由于很多的判断,函数层级已经超过4层了,这其实对我们的理解很不利,另一方面,一些逻辑变化也会导致我们的更改很麻烦,费脑子。

每个函数只做一件简单的事情

有些人喜欢写一些通用函数,一般我都放在publicModule里面,既可以实现这个工又可以实现那个功能,它的内部依据某些变量或者是某些条件,来选择这个函数所要实现的小功能。

比如,写出这样的函数:

 1void function() {2  if (getOS().equals("MacOS")) {3    a();4  } else {5    b();6  }78  c();9
10  if (getOS().equals("MacOS")) {
11    d();
12  } else {
13    e();
14  }
15}

这个函数,是想表达根据系统是否为MacOS,从而来做不同的事情。从这个函数可以很容易的看出,其实只有函数c()是两种系统共有的,而其它的函数a(), b(), d(), e()都属于不同的分支。

但是这种复用的写法其实是很不利的。如果一个函数可能实现2个功能,并且它们之间共同点少于它们的不同点,那我们最好就写两个不同的函数,否则这个函数的逻辑就不会很清晰,容易出现错误。

不要害怕,函数简单点不丢人,我们不需要炫技。

好了,根据上面的说法,这个函数可以改写成两个函数:

1void funMacOS() {
2  a();
3  c();
4  d();
5}

1void funOther() {
2  b();
3  c();
4  e();
5}

如果我们发现两件事情大部分内容相同,只有少数不同,也就是说共同点大于它们的不同点,那就更简单了,我们可以把相同的部分提取出去,做成一个辅助函数

比如,如果有个函数是这样:

 1void function() {23  a();4  b()5  c();67  if (getOS().equals("MacOS")) {8    d();9  } else {
10    e();
11  }
12}

其中函数a(),b(),c()都是一样的,只有函数d()、e()根据系统有所不同。那么你可以把函数a(),b(),c()提取出去,代码如下:

1void preFun() {
2  a();
3  b()
4  c();
5}

然后分别写两个函数:

1void funMacOS() {
2  preFun();
3  d();
4}

1void funOther() {
2  preFun();
3  e();
4}

这样更改之后,是不是清晰了很多,我们既共享了代码,避免冗余,又做到了每个函数只做一件简单的事情。这样的代码,逻辑就更加清晰了。

工具函数

是的,我再说一遍,每个函数只做一件简单的事情。但是有些时候在我们的工程代码中,我们可能会发现其实里面有很多的重复。

所以一些常用的代码,不管它有多短或者多么的简单,都可以提取出去做成函数,例如有些帮助函数也许就只有2行,但是我们把它封装成一个函数的话,就能大大简化主要函数里面的逻辑。

也许你可能会说,这些函数调用会增加代码开销,但随着硬件发展以及技术变革,这已经是一种过时的观念了。

现代的很多编译器都能自动的把小的函数内联(inline)到调用它的地方,所以根本不会产生函数调用,也就不会产生任何多余的开销。

那么我可以使用宏来代替工具函数?一行代码搞定了,比如

1#define FillAndSendTxOptions( TRANSSEQ, ADDR, ID, LEN, TxO ) { \
2afStatus_t stat;                                    \
3ZDP_TxOptions = (TxO);                              \
4stat = fillAndSend( (TRANSSEQ), (ADDR), (ID), (LEN) );          \
5ZDP_TxOptions = AF_TX_OPTIONS_NONE;                 \
6return stat;                                        \
7}

同样,这也许也过时了,我不想让宏(macro)来背这个锅,在早期的C语言编译器里,只有宏是静态内联的,所以使用宏是为了达到内联的目的。

然而能否内联,其实并不是宏与函数的根本区别,这里我不细说了,只要记住:应该尽量避免使用宏

为了内联而使用宏,其实是滥用了宏,这会引起各种各样的麻烦,比如使程序难以理解,难以调试,容易出错等等。

尽量使用局部变量和参数

我们应该尽量避免使用全局变量和类成员(class member)来传递信息,举个例子:

 1class A {2   String x;34   void findX() {5       ...6       x = ...;7   }89   void fun() {
10       findX();
11       ...
12       print(x);
13   }
14}

首先,使用函数findX(),把一个值写入成员x。然后,调用x的值。这样,x就变成了findX和print之间的数据通道。

由于x属于class A,这样程序就失去了模块化的结构,与我们所说的模块化意义不符了。两个函数依赖于成员x,就不再有明确的输入和输出,而是依赖全局的数据。

函数findX和fun不再能够离开class A而存在,具有依赖性,并且由于类成员还有可能被其他代码改变,这样就会导致代码变得复杂难以理解,函数的正确性也难以保证。

如果使用局部变量和参数来传递信息,那么这两个函数就不需要依赖于某一个class,不易出错,代码如下:

1String findX() {
2    ...
3    x = ...;
4    return x;
5 }
6 void foo() {
7   String x = findX();
8   print(x);
9 }

总结

模块化是指解决一个复杂问题时,自顶向下,逐层把系统划分成若干模块的过程,深入理解模块化,什么是真正的模块化,那么我们才能够事半功倍。

真正的模块化编程原来是这样的!相关推荐

  1. (转)Javascript模块化编程(一):模块的写法

    转自 ruanyifeng 系列目录: Javascript模块化编程(一):模块的写法 Javascript模块化编程(二):AMD规范 Javascript模块化编程(三):Require.js的 ...

  2. Javascript模块化编程(一):模块的写法

    随着网站逐渐变成"互联网应用程序",嵌入网页的Javascript代码越来越庞大,越来越复杂. 网页越来越像桌面程序,需要一个团队分工协作.进度管理.单元测试等等......开发者 ...

  3. keil c语言模块化编程,keil C模块化编程总结

    昨晚看了下模块化编程的东西,把自己的工程整了整,可惜没成功.今早发神经似的起床敲代码,很快就发现了错误,原来是条件宏定义的头文件名忘改了,汗!!! 整理下模块化编程的要点,感谢以下三位UP主的帖子: ...

  4. Javascript模块化编程:AMD规范

    一.模块的规范 先想一想,为什么模块很重要? 因为有了模块,我们就可以更方便地使用别人的代码,想要什么功能,就加载什么模块. 但是,这样做有一个前提,那就是大家必须以同样的方式编写模块,否则你有你的写 ...

  5. 模块化编程AMDCommonJS

    为什么要模块化编程 如果JS也可以像类似python,Java使用import,引入我们想要的模块,想要什么模块,就加载什么模块,可以给前端编程带来更多的便捷,结构更加清晰明了.但是,这样做有一个前提 ...

  6. 嵌入式编程之模块化编程

    原文出处:http://blog.csdn.net/wanruoqingkong/article/details/24286625 当你在一个项目小组做一个相对较复杂的工程时,意味着你不再独自单干.你 ...

  7. Python的模块化编程

    我们首先以一个例子来介绍模块化编程的应用场景,有这样一个名为requirements.py的python3文件,其中两个函数的作用是分别以不同的顺序来打印一个字符串: def example1():a ...

  8. Javascript模块化编程require.js的用法

    JS模块化工具requirejs教程(一):初识requirejs http://www.runoob.com/w3cnote/requirejs-tutorial-1.html JS模块化工具req ...

  9. C语言模块化编程的例子

    以往写C语言程序都是一个文件里面写个几十.几百行,在练算法的时候还可以,现在搞开发需要模块化编程,所谓模块化编程,就是指一个程序包含多个源文件(.c 文件和 .h 文件),每个 .c 文件可以被称为一 ...

  10. Web前端进阶之JavaScript模块化编程知识

    JavaScript是前端三要素之一,也是很多初学Web前端的人遭遇的第一条拦路虎.很多同学表示JavaScript涵盖的知识点太多太复杂.应用也是五花八门完全摸不着头脑.但只要我们一点一点由基础到进 ...

最新文章

  1. C语言实现djikstra算法(附完整源码)
  2. Python的注释方式
  3. PHP header的一些用法
  4. 【白皮书分享】直播社会价值白皮书-字节跳动.pdf(附下载链接)
  5. 分布式理论(3):Paxos Made Simple
  6. 分解原理_原理篇 | 推荐系统之矩阵分解模型
  7. vscode中微信小程序的代码智能提示
  8. autocad2007二维图画法_AutoCAD2007中文版机械制图教程
  9. python操作腾讯文档_Python调用腾讯云接口
  10. 计算机远程控制安全吗,远程控制电脑危险吗?向日葵远程控制软件安全吗?
  11. 计算机科学与技术的心理测试考试,考试中的心理测评是什么?
  12. Wrong namespace. Expected 'cn.itheima.dao.CustomerMapping' 错误
  13. C#入门学习笔记(基于刘铁锰老师C#入门2014教学视频)【2】
  14. 克隆系统安装安全软件避免重复ID 方法
  15. 二进制“<”:“const _Ty”不定义该运算符或到预定义运算符可接收的类型的转换
  16. 08——驾校科目一考试——布局按钮
  17. 爱死磕8月28日市场分析,涨停!两天已18个点!
  18. 微信公众号前端开发,学习路线图必不可少
  19. 尚医通_第12章_用户平台首页数据
  20. 好压报错“启动参数错误,程序即将退出”

热门文章

  1. 百家讲坛 汉代风云人物之吕后
  2. Windows10安装深度Linux,可能是最漂亮的国产Linux,windows下安装深度操作系统步骤...
  3. 写一个函数,判断一个字符串是否为回文联
  4. python入门指南推文_GitHub - Hiufan/codeparkshare: Python初学者(零基础学习Python、Python入门)书籍、视频、资料、社区推荐...
  5. 鬼谷子训诫:遇横逆之来而不怒、遭变故之起而不惊、当非常之谤而不辩
  6. vue 微信(企业微信)获取openId
  7. 离散点连成曲线(三次样条插值)
  8. javamail阅读回执_使用阅读回执可能会让您变得更好
  9. 7款超适用的PC软件,实用强大,让您秒变大师兄
  10. 建议收藏!最有效率的python数据分析入门书单