¿Vincular a una URL externa en Javadoc?

Question

Algo así como:

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

Answer 1

Esto crea un "Vea también" la partida que contiene el enlace, es decir:

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

rendirá como:

Ver también:
                      http://google.com

mientras que esto:

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

creará un enlace en línea:

Ver http://google.com

Answer 2

Tomado del javadoc spec

@see <a href="URL#value">label</a>: añade un enlace definido por URL#value. El URL#value es una URL relativa o absoluta. La herramienta Javadoc distingue esto de otros casos al buscar un símbolo menor que (<) como primer carácter.

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

Answer 3

sólo tiene que utilizar un enlace HTML con un elemento como un

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

Answer 4

Es difícil encontrar una respuesta clara desde el sitio de Oracle. Lo siguiente es de 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 no ofrecen ninguna herramienta especial para los enlaces externos, por lo que sólo debe usar HTML estándar:

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

o

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

Don' t use {@link ...} o {@linkplain ...} porque estos son para enlaces a los javadocs de otras clases y métodos.