链接到 Javadoc 中的外部 URL？

Question

就像是：

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

Answer 1

这将创建一个包含链接的“另请参阅”标题，即：

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

将呈现为：

也可以看看：
http://google.com

而这：

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

将创建一个内嵌链接：

请参阅http://google.com

Answer 2

取自javadoc 规范

@see <a href="URL#value">label</a> ：添加URL#value定义的链接。 URL#value是相对或绝对 URL。 Javadoc 工具通过查找小于号 ( < ) 作为第一个字符来将其与其他情况区分开来。

例如： @see <a href="http://www.google.com">Google</a>

Answer 3

Javadocs 不提供任何用于外部链接的特殊工具，因此您应该只使用标准的 html：

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

要么

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

不要使用{@link ...}或{@linkplain ...}因为它们用于链接到其他类和方法的 javadoc。

Answer 4

只需使用带有a元素的HTML链接即可

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

Answer 5

很难从 Oracle 网站上找到明确的答案。 以下来自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";