java - 从库中删除弃用的功能

Question

假设我的 api 中有一个名为 foo 的方法。在我的 api 的下一个版本中，我想用 bar 替换这个方法。我将如何着手这样做？

几个选项是:

1) 只需删除 foo。在发行说明中，声明此方法已被替换为 bar。当客户尝试使用我的新库进行构建时，这会破坏客户，但谁在乎呢？他们只需要自己修复。

2) 将 foo 标记为已弃用，并在发行说明中声明 bar 应该是首选。调用已弃用的方法时记录警告。然后在下一个版本中，完全删除 foo。这为客户提供了一个小的警告窗口。

你会怎么做？

Answer 1

肯定会做 2。

上面的 1 不仅会影响编译时，而且如果您的库 jar 被最终用户替换，也会导致运行时错误。