代码坏味道与重构之过长参数列表

发布于:2023-01-04 ⋅ 阅读:(177) ⋅ 点赞:(0)

1. 为什么过长参数列表是坏味道

过长参数列表是指函数入参过多或存在不必要的参数。它往往意味着函数功能不单一,抽象不合理,代码的封装性不够好,可能会引发以下问题:

  • 增加了函数的使用成本,过长的参数列表让使用者感到迷惑。好的函数,函数签名应该尽可能的简单。通常来说,函数参数越少,函数的使用成本越低。

  • 增加了函数的维护成本,函数签名不稳定,不易维护

2. 重构过长参数列表的目标

每一个函数都可以被当做一个 API,一个好的 API 应该:

  • 使用简单

  • 功能单一明确

  • 入参尽可能的简单,降低使用和维护成本。

建议函数参数不要超过5个,函数参数增加一个,函数的使用成本和维护成本就增加一级。

写函数时,充分思考抽像,合理封装,设计出优雅的 API(函数)。

简而言之,如非必要,勿增参数

当然,我们也不能极端,为了减少参数,为了封装,就直接传整个大对象进去,导致被调用对象与大对象的依赖关系,暴露了一些不该暴露给这个函数的信息,违背了最小知道原则

因此,我们是否要用对象替换参数,需要综合考虑依赖方向,最小知道原则、参数可维护性、API 的使用成本,权衡替换后的收益和代价,再做出决定。

3. 重构过长参数列表的技巧

场景 处理方式
某些入参可以通过其他参数查询得到 查询取代参数
某几个入参是一个对象的部分字段 保持对象完整性
某几个参数存在关联性 封装对象,引入参数对象
函数逻辑是针对某个入参对象属性的加工 移动函数至合适的类
某些入参被用作控制代码逻辑的标记 移除标记参数

快捷键操作:

操作 快捷键
删除无用入参 Alt + Del/Alt + Enter
添加入参 Ctrl + F6/Alt +Enter
提取参数对象 Ctrl + Alt + Shift + T -> Parameter Object
鼠标右键 -> refactor -> Parameter Object
抽取方法 Ctrl + Alt + M
内联方法 Ctrl + Alt + N
移动方法 F6
本文含有隐藏内容,请 开通VIP 后查看

网站公告

今日签到

点亮在社区的每一天
去签到