Réponses:
Cela crée un en-tête "Voir aussi" contenant le lien, à savoir:
/**
* @see <a href="http://google.com">http://google.com</a>
*/
rendra comme:
Voir aussi:
http://google.com
alors que ceci:
/**
* See <a href="http://google.com">http://google.com</a>
*/
créera un lien en ligne:
Voir http://google.com
<a href="http://google.com" target="_top">http://google.com</a>.
La raison de l'ajout de target = "_ top" est due au fait que certains des fichiers html javadoc générés utilisent des cadres, et vous voulez probablement que la navigation affecte la page entière plutôt que juste le cadre actuel.
Tiré de la spécification javadoc
@see <a href="URL#value">label</a>
: Ajoute un lien tel que défini par URL#value
. L' URL#value
URL est une URL relative ou absolue. L'outil Javadoc le distingue des autres cas en recherchant un symbole inférieur à ( <
) comme premier caractère.
Par exemple : @see <a href="http://www.google.com">Google</a>
Les Javadocs n'offrent aucun outil spécial pour les liens externes, vous devez donc simplement utiliser du HTML standard:
See <a href="http://groversmill.com/">Grover's Mill</a> for a history of the
Martian invasion.
ou
@see <a href="http://groversmill.com/">Grover's Mill</a> for a history of
the Martian invasion.
N'utilisez pas {@link ...}
ou {@linkplain ...}
parce que ce sont des liens vers les javadocs d'autres classes et méthodes.
Utilisez simplement un lien HTML avec un élément a comme
<a href="URL#value">label</a>
Difficile de trouver une réponse claire sur le site Oracle. Ce qui suit est 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";
<a>
balise html avec le {@link ...}
?
<a>
.
{@link package.class#member label}
@see
balise vient après les balises@param
/@return
et avant les balises@since
/@serial
/@deprecated
.