ජාවාඩොක් ප්රලේඛනයේ ink ලින්ක් කොටසේ සිට සාමාන්ය ආකෘතිය :
උදාහරණ
එකම පන්තියේ ක්රමය:
/** See also {@link #myMethod(String)}. */
void foo() { ... }
එකම පන්තියේ හෝ ආනයනය කළ වෙනත් පන්තියක ක්රමය :
/** 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() { ... }
ඔබේ ප්රශ්නයේදී මෙන් ක්රම ඇමතුම් දාමයකි . මෙම පංතියෙන් පිටත ක්රම සඳහා සබැඳි සඳහා ලේබල් නියම කළ යුතුය, නැතහොත් අපට ලැබේ 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()
ලේබල
ස්වයංක්රීය ප්රතිනිර්මාණය ලේබල් වලට බලපාන්නේ නැත. ක්රමය, පන්තිය හෝ පැකේජය නැවත නම් කිරීම මෙයට ඇතුළත් ය; සහ ක්රම අත්සන වෙනස් කිරීම.
එබැවින්, පෙරනිමියට වඩා වෙනස් පෙළක් අවශ්ය නම් පමණක් ලේබලයක් සපයන්න .
උදාහරණයක් ලෙස, ඔබට මිනිස් භාෂාවෙන් කේතයට සම්බන්ධ විය හැකිය:
/** You can also {@linkplain #getFoo() get the current foo}. */
void setFoo( Foo foo ) { ... }
නැතහොත් "ක්රම ඇමතුම් දාමයක්" යටතේ ඉහත පෙන්වා ඇති පරිදි පෙරනිමියට වඩා වෙනස් පෙළක් සහිත කේත නියැදියකින් ඔබට සම්බන්ධ විය හැකිය. කෙසේ වෙතත්, API පරිණාමය වෙමින් තිබියදී මෙය බිඳෙන සුළු විය හැකිය.
මකාදැමීම සහ # මතක තබා ගන්න
ක්රම අත්සනට පරාමිතිගත කළ වර්ග තිබේ නම්, javadoc inklink හි එම වර්ග මකාදැමීම භාවිතා කරන්න. උදාහරණයක් වශයෙන්:
int bar( Collection<Integer> receiver ) { ... }
/** See also {@link #bar(Collection)}. */
void foo() { ... }