如何将Java方法声明或标记为已弃用?

我想让我的一个方法“不赞成”=不再使用。

但我仍然想在我的API中使用它。 我只是想向使用该方法的任何人显示“警告”。

我怎样才能做到这一点?


在方法上使用@Deprecated。 不要忘记澄清javadoc领域:

/**
 * Does some thing in old style.
 *
 * @deprecated use {@link #new()} instead.  
 */
@Deprecated
public void old() {
// ...
}

使用@Deprecated注释和@deprecated JavaDoc标签。

@deprecated JavaDoc标记用于文档目的。

@Deprecated注释指示编译器该方法已被弃用。 Sun / Oracles关于这个主题的文件中提到:

使用@Deprecated注释来弃用类,方法或字段可确保所有编译器在代码使用该程序元素时发出警告。 相反,不能保证所有的编译器总是发出基于@deprecated Javadoc标签的警告,尽管目前Sun编译器这样做。 其他编译器可能不会发出这样的警告。 因此,使用@Deprecated注释来生成警告更依赖于@deprecated Javadoc标签。

您可以在如何以及何时弃用API中找到完整的文档


有两件事你可以做:

  • @Deprecated注释添加到方法中
  • @deprecated标记添加到方法的javadoc
  • 你应该两个

    引用关于这个主题的java文档:

    从J2SE 5.0开始,通过使用@Deprecated注释来弃用类,方法或字段。 另外,你可以使用@deprecated Javadoc标签告诉开发者使用什么。

    使用注释会导致Java编译器在使用不推荐使用的类,方法或字段时生成警告。 如果不推荐使用的编译单元使用已弃用的类,方法或字段,则编译器会抑制弃用警告。 这使您可以构建传统API而不会产生警告。

    强烈建议您使用带有适当注释的Javadoc @deprecated标签,以解释如何使用新的API。 这可确保开发人员将具有从旧API到新API的可行迁移路径

    链接地址: http://www.djcxy.com/p/13283.html

    上一篇: How to declare or mark a Java method as deprecated?

    下一篇: Static Classes In Java