Yanıtlar:
Bu bağlantıyı içeren bir "Ayrıca Bkz" başlığı oluşturur, yani:
/**
* @see <a href="http://google.com">http://google.com</a>
*/
şu şekilde oluşturulur:
Ayrıca Bkz:
http://google.com
oysa bu:
/**
* See <a href="http://google.com">http://google.com</a>
*/
satır içi bağlantı oluşturur:
Http://google.com adresine bakın
<a href="http://google.com" target="_top">http://google.com</a>.
target = "_ top" eklemenin nedeni, oluşturulan javadoc html dosyalarından bazılarının çerçeveleri kullanması ve muhtemelen gezinmenin sadece geçerli çerçeve yerine tüm sayfayı etkilemesini istemenizdir.
Javadoc Spec'ten Alınan
@see <a href="URL#value">label</a>
: İle tanımlandığı gibi bir bağlantı ekler URL#value
. URL#value
Bir akraba veya mutlak bir URL. Javadoc aracı <
, ilk karakter olarak daha küçük bir sembol ( ) arayarak bunu diğer durumlardan ayırır .
Örneğin : @see <a href="http://www.google.com">Google</a>
Javadocs harici bağlantılar için özel bir araç sunmaz, bu yüzden sadece standart html kullanmalısınız:
See <a href="http://groversmill.com/">Grover's Mill</a> for a history of the
Martian invasion.
veya
@see <a href="http://groversmill.com/">Grover's Mill</a> for a history of
the Martian invasion.
Kullanmayın {@link ...}
veya {@linkplain ...}
çünkü bunlar diğer sınıfların ve yöntemlerin javadoklarına bağlantılar içindir.
Bunun gibi a elementli bir HTML bağlantısı kullanın
<a href="URL#value">label</a>
Oracle sitesinden net bir cevap bulmak zor. Aşağıdakiler şöyledir javax.ws.rs.core.HttpHeaders.java
:
/**
* See {@link <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.1">HTTP/1.1 documentation</a>}.
*/
public static final String ACCEPT = "Accept";
/**
* See {@link <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.2">HTTP/1.1 documentation</a>}.
*/
public static final String ACCEPT_CHARSET = "Accept-Charset";
<a>
Html etiketini ile kaydırmanın önemi nedir {@link ...}
?
<a>
.
{@link package.class#member label}
@see
etiketi geliyor sonra@param
/@return
etiketleri ve öncesi@since
/@serial
/@deprecated
etiketleri.