如何处理库中的函数弃用?

2024-01-06

我正在开发一个 Java 库,并想从中删除一些函数。我这样做的原因是公共 API 和设计清理。有些对象具有设置器,但应该是不可变的,某些功能已通过不同的方法实现得更好/更清晰,等等。

我已将这些方法标记为“已弃用”,并希望最终删除它们。目前我正在考虑在几次冲刺(两周的开发周期)后删除这些。

是否有关于删除冗余公共代码的“最佳实践”?


设置一个日期并在@deprecated 标签中公布。删除的时间取决于您的代码拥有的用户数量、您与他们的联系程度以及更改的原因。

如果您有数千名用户并且您几乎不与他们交谈,那么时间框架可能应该在几十年范围内:-)

如果您的用户是您的 10 名同事,并且您每天都会见到他们,那么时间范围很容易就在几周范围内。

/**
 * @deprecated
 * This method will be removed after Halloween!
 * @see #newLocationForFunctionality
 */
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)

如何处理库中的函数弃用? 的相关文章

随机推荐