如何将Java方法声明或标记为已弃用？(How to declare or mark a Java method as deprecated?)

如何将Java方法声明或标记为已弃用？(How to declare or mark a Java method as deprecated?)

我想使我的一个方法“弃用”=不再使用了。

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

我该如何实现呢？

I would like to make one of my methods "deprecated" = not used anymore.

But still I would like to have it in my API. I just want to show "warning" to anyone using that method.

How can I achieve that?

最满意答案

使用@Deprecated方法。 不要忘记澄清javadoc字段：

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

Use @Deprecated on method. Don't forget about clarifying javadoc field:

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