Java 弃用方法,并链接到其他库中的类

Java 弃用方法,并链接到其他库中的类,java,Java,我不推荐一个方法,因为我想在不同的库jar中使用不同类的方法,从而提供更多的标准化 我想写的是这样的: class MyClass { /** * @deprecated use {@link com.othercompany.theirmodule.TheirClass.bar() } */ @Deprecated void foo() { ... } 然而,类TheirClass完全属于另一个jar。我必须只为javadoc'deprecated'标记中的链接添加对其模块的依赖项吗?

我不推荐一个方法,因为我想在不同的库jar中使用不同类的方法,从而提供更多的标准化

我想写的是这样的:

class MyClass {

/**
 * @deprecated use {@link com.othercompany.theirmodule.TheirClass.bar() }
 */
@Deprecated
void foo() {
...
}
然而,类TheirClass完全属于另一个jar。我必须只为javadoc'deprecated'标记中的链接添加对其模块的依赖项吗?

@link是一个标记。它用于使用javadoc实用程序从源代码生成文档。现代IDE也使用它,例如IntelliJ IDEA中的Ctrl+Q在光标下显示关于类/方法的文档


但这只是一个评论。如果ThierClass不可见或没有这样的方法,IDE可能会用红色突出显示它,但这对于编译器来说不是错误。

不,您不需要将此依赖项添加到项目中。您可以添加一个依赖项,并使用它们的类作为您现在不推荐使用的方法的实现,假设两者工作相同。您还可以在一些库文档中添加一个超链接来替换您的文档,或者简单地提及完整的库标识符、它们的验证格式和类名,您的用户可以自己完成所需的步骤。谢谢。所以我只是添加了一个超链接。