过长参数列表是指函数入参过多或存在不必要的参数。它往往意味着函数功能不单一,抽象不合理,代码的封装性不够好,可能会引发以下问题:
增加了函数的使用成本,过长的参数列表让使用者感到迷惑。好的函数,函数签名应该尽可能的简单。通常来说,函数参数越少,函数的使用成本越低。
增加了函数的维护成本,函数签名不稳定,不易维护
每一个函数都可以被当做一个 API,一个好的 API 应该:
使用简单
功能单一明确
入参尽可能的简单,降低使用和维护成本。
建议函数参数不要超过5个,函数参数增加一个,函数的使用成本和维护成本就增加一级。
写函数时,充分思考抽像,合理封装,设计出优雅的 API(函数)。
简而言之,如非必要,勿增参数。
当然,我们也不能极端,为了减少参数,为了封装,就直接传整个大对象进去,导致被调用对象与大对象的依赖关系,暴露了一些不该暴露给这个函数的信息,违背了最小知道原则。
因此,我们是否要用对象替换参数,需要综合考虑依赖方向,最小知道原则、参数可维护性、API 的使用成本,权衡替换后的收益和代价,再做出决定。
| 场景 | 处理方式 |
|---|---|
| 某些入参可以通过其他参数查询得到 | 查询取代参数 |
| 某几个入参是一个对象的部分字段 | 保持对象完整性 |
| 某几个参数存在关联性 | 封装对象,引入参数对象 |
| 函数逻辑是针对某个入参对象属性的加工 | 移动函数至合适的类 |
| 某些入参被用作控制代码逻辑的标记 | 移除标记参数 |
快捷键操作:
| 操作 | 快捷键 |
|---|---|
| 删除无用入参 | Alt + Del/Alt + Enter |
| 添加入参 | Ctrl + F6/Alt +Enter |
| 提取参数对象 | Ctrl + Alt + Shift + T -> Parameter Object 鼠标右键 -> refactor -> Parameter Object |
| 抽取方法 | Ctrl + Alt + M |
| 内联方法 | Ctrl + Alt + N |
| 移动方法 | F6 |