Вы найдете много информации о JavaDoc на странице справки JavaDoc Tool , включая информацию о

{@link package.class # member label}

тег (который вы ищете):

Например, вот комментарий, который ссылается на метод getComponentAt (int, int):

Use the {@link #getComponentAt(int, int) getComponentAt} method.

Другие полезные ссылки о JavaDoc:

• Технология JavaDoc
• Как написать комментарии к Doc для инструмента Javadoc

Общий формат из раздела @link документации javadoc :

Примеры

Метод в том же classе:

 /** See also {@link #myMethod(String)}. */ void foo() { ... } 

Метод в другом classе, либо в том же пакете, либо импортирован:

 /** See also {@link MyOtherClass#myMethod(String)}. */ void foo() { ... } 

Метод в другом пакете и не импортируется:

 /** See also {@link com.mypackage.YetAnotherClass#myMethod(String)}. */ void foo() { ... } 

Ярлык, связанный с методом, в виде простого текста, а не кода:

 /** See also this {@linkplain #myMethod(String) implementation}. */ void foo() { ... } 

Цепочка методов вызывает, как в вашем вопросе. Мы должны указывать метки для ссылок на методы вне этого classа, или мы получаем getFoo().Foo.getBar().Bar.getBaz() . Но эти ярлыки могут быть хрупкими; см. «Ярлыки» ниже.

 /** * A convenience method, equivalent to * {@link #getFoo()}.{@link Foo#getBar() getBar()}.{@link Bar#getBaz() getBaz()}. * @return baz */ public Baz fooBarBaz() 

Этикетки

Автоматический рефакторинг может не влиять на метки. Это включает переименование метода, classа или пакета; и изменение сигнатуры метода.

Поэтому дайте ярлык только в том случае, если вам нужен другой текст, чем по умолчанию.

Например, вы можете ссылаться на человеческий язык на код:

 /** You can also {@linkplain #getFoo() get the current foo}. */ void setFoo( Foo foo ) { ... } 

Или вы можете ссылаться на образец кода с текстом, отличным от значения по умолчанию, как показано выше в разделе «Цепь вызовов методов». Однако это может быть хрупким, в то время как API-интерфейсы развиваются.

Тип стирания и # члена

Если сигнатура метода включает параметризованные типы, используйте стирание этих типов в javadoc @link. Например:

 int bar( Collection receiver ) { ... } /** See also {@link #bar(Collection)}. */ void foo() { ... } 

вы можете использовать @see для этого:

образец:

 interface View { /** * @return true: have read contact and call log permissions, else otherwise * @see #requestReadContactAndCallLogPermissions() */ boolean haveReadContactAndCallLogPermissions(); /** * if not have permissions, request to user for allow * @see #haveReadContactAndCallLogPermissions() */ void requestReadContactAndCallLogPermissions(); }