Verlinkung zu einer externen URL in Javadoc?

Question

Etwas wie:

/** 
* See {@linktourl http://google.com} 
*/ 

Answer 1

Dies schafft ein "Siehe auch" Überschrift mit dem Link, das heißt:

/** 
* @see <a href="http://google.com">http://google.com</a> 
*/ 

machen wird als:

Siehe auch:
                      http://google.com

während dies:

/** 
* See <a href="http://google.com">http://google.com</a> 
*/ 

wird eine Inline-Link erstellen:

Siehe http://google.com

Answer 2

vom

javadoc spec Genommen

@see <a href="URL#value">label</a>: Fügt einen Link, wie durch URL#value definiert. Die URL#value ist eine relative oder absolute URL. Das Javadoc-Werkzeug unterscheidet dies von anderen Fällen, indem nach einem Kleiner-als-Zeichen (<) als dem ersten Zeichen gesucht wird.

Zum Beispiel: @see <a href="http://www.google.com">Google</a>

Answer 3

nur einen HTML-Link mit einem a-Elemente wie

<a href="URL#value">label</a>

Answer 4

verwenden Fest eine klare Antwort von der Oracle-Website zu finden. Das Folgende ist aus 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"; 

Answer 5

Javadocs bieten keine speziellen Werkzeuge für externe Links, so dass Sie nur Standard-HTML verwenden sollten:

See <a href="http://groversmill.com/">Grover's Mill</a> for a history of the 
Martian invasion. 

oder

@see <a href="http://groversmill.com/">Grover's Mill</a> for a history of 
the Martian invasion. 

Don‘ t verwenden Sie {@link ...} oder {@linkplain ...}, weil diese Links zu den Javadocs anderer Klassen und Methoden sind.