链接到Javadoc中的外部URL?

类似:

/*** See {@linktourl http://google.com}*/
301582 次浏览

取自javadoc规范

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

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

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

/*** @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

很难从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";

Javadocs不提供任何外部链接的特殊工具,所以你应该只使用标准的html:

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

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

不要使用{@link ...}{@linkplain ...},因为这些是指向其他类和方法的javadocs的链接。