设计原则 --- 函数的设计

函数命名和职责

• 从使用者的角度去命名函数, 使用常用的好理解的词汇
• 函数的命名要描述函数的功能, 即使会导致函数名字过长
• 比如这个集成测试函数:
  public async Task Upload_File_InPiece_Should_Download_The_Full_FIle()

• 单一职责: 一个函数只负责一件事情.
• 复杂度: 一个函数通常长度不应超过100行. 如果一个函数过长或者出现复杂逻辑或者圈复杂度过高的情况, 则需要将相关逻辑封装成独立的函数.
• 不要在一个函数中使用空行或者注释将代码分为不同的部分, 因为这代表着函数功能不单一, 如下:

public void Method {
// 一些注释解释下面的代码
.......

// 一些注释解释下面的代码
......
}

函数参数和返回值

• 函数的参数不应过多, 通常最多为五个或者六个
• 要注意对参数的合法性进行检查, 比如判断是否为空等
• 函数的参数应该尽可能的大, 也就是尽可能的abstract

• public void LoopDataStructure (IEnumerable myDataStructure) 在C#中Collection的很多数据结构都实现了IEnumerable这个接口, 这样大部分数据结构都可以使用这个方法
• public void LoopList (List list) 将参数声明成List可以保证Java中的ArrayList和LinkedList都可以使用这个方法.
• 要注意函数的参数是pass by value还是pass by reference. Java和C#的reference type传递的是reference值, 也就是在方法中对参数的修改也会改变外面的值, 具体见: Java 基础 — Java变量储存机制及参数传递

• 函数的返回值应该尽可能的小, 比如返回LinkedList而不是List, 这样的好处是, :
  List list = createList()