java - 弃用覆盖方法

Question

我在 Eclipse IDE 中发现了一些奇怪的东西。假设我有以下类(class):

public class Super {
    @Deprecated
    public void doNotUseThisMethod() {
        // do magic
    }
}

public class Sub extends Super{
    @Override
    public void doNotUseThisMethod() {
        // why is this not deprecated?
    }
}

当然，覆盖已弃用的方法应该会导致警告(因为不使用它的原因相同)。仍然在 Eclipse Luna 和 Mars 的全新工作区中，上面的代码根本不会产生警告。而且我也找不到任何方法来启用它。

我找到了 this bug对于接口(interface)(我知道如果 Super 是一个接口(interface)，就不应该有警告)这意味着曾经有一个警告。

那到底发生了什么？是否有任何理由覆盖已弃用的方法不应导致警告？我可以做些什么来再次启用此功能吗？

Answer 1

JLS 在这一点上非常清楚(因为它在大多数方面都是如此)。

A program element annotated @Deprecated is one that programmers are discouraged from using, typically because it is dangerous, or because a better alternative exists.

A Java compiler must produce a deprecation warning when a type, method, field, or constructor whose declaration is annotated with @Deprecated is used (overridden, invoked, or referenced by name) in a construct which is explicitly or implicitly declared, unless:

• The use is within an entity that is itself annotated with the annotation @Deprecated; or

• The use is within an entity that is annotated to suppress the warning with the annotation @SuppressWarnings("deprecation"); or

• The use and declaration are both within the same outermost class.

(https://docs.oracle.com/javase/specs/jls/se8/html/jls-9.html#jls-9.6.4.6)

要完全符合 JLS，Eclipse 必须用警告标记您的 doNotUseThisMethod()。似乎它曾经这样做过，很久以前，但在 2003 年 bug 48335出现了，并且该警告受到偏好的影响。如错误评论中所述，默认设置为“已禁用”。 (默认值应该“启用”以与 JLS 远程兼容。请随时提交错误以更改它。)我没有进行详尽的搜索，但由于您看到的行为与此一致，我我要大胆地说这就是它从那以后一直保持的样子。

既然是首选项，您可以更改它。只需转到“窗口 -> 首选项”，然后选择“Java -> 编译器 -> 错误/警告”。向下滚动到“已弃用和受限的 API”，然后选中“信号覆盖或实现已弃用的方法”旁边的框。右侧稍上方有一个下拉菜单，您可以在其中选择“错误”、“警告”或“忽略”。选择您喜欢的那个。

该设置仅影响您的本地 IDE。

要让您的整个团队使用该设置，您需要设置项目特定设置。在同一个首选项屏幕上，右上角有一个指向“配置项目特定设置”的链接。单击它，选择要为其设置首选项的项目，然后执行与上述相同的操作。这将在项目的“.settings”文件夹中创建一个名为“org.eclipse.jdt.core.prefs”的文件。 (您无法在 Package Explorer 中看到它们。您需要在 Navigator View 中查看它们。)创建后，您可以将它们添加到您的源代码管理中，它们将应用于您团队中从事该工作的每个人项目。

是的，您必须为每个项目都这样做。