首页/开发/代码质量与评审速查/手法:Change Function Declaration(调整函数声明)
重构手法62 条

手法:Change Function Declaration(调整函数声明)

为函数改名或改参数:改名表达新意图,加参数补充信息,删参数简化调用;迁移期可保留旧签名作为过渡(并标记废弃),调用点分批切换。

做法改名 / 增参 / 减参 / 调序
过渡旧签名转发 + @Deprecated
收尾全部调用切换后删除旧签名

过渡形态

过渡形态
@Deprecated
double circum(double radius) {
    return circumference(radius);
}

double circumference(double radius) {
    return 2 * Math.PI * radius;
}
公共库的签名变更走废弃周期:保留一个发布周期的旧签名,给出替代指引。

易错点

  • 删除公共方法前不检索外部引用:下游编译直接失败
  • 参数顺序调换未逐个检查调用点:类型兼容时静默传错

数据来源与参考

  • 《重构》第 2 版 · 第 6 章(Change Function Declaration)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌