aem*_*999 1159

这将创建一个包含链接的"另请参见"标题,即:

/**
 * @see <a href="http://google.com">http://google.com</a>
 */
Run Code Online (Sandbox Code Playgroud)

将呈现为:

另请参阅:http :
           //google.com


而这个:

/**
 * See <a href="http://google.com">http://google.com</a>
 */
Run Code Online (Sandbox Code Playgroud)

将创建一个内嵌链接:

请参阅http://google.com

  • 如果有人有兴趣,因为我只需查阅:根据[Javadoc规范](http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#orderoftags) @ see`标签来自*@ param` /`@ return`标签后*和*之前的`@ since` /`@ serial` /`@ deprecated`标签. (56认同)
  • 我建议`<a rel="nofollow noreferrer" href="http://google.com" target="_top"> http://google.com </a>.添加target ="_ top"的原因是因为某些生成的javadoc html文件使用框架,您可能希望导航影响整个页面而不仅仅是当前框架. (18认同)
  • 以防万一,Intellij 13似乎不支持这个标签.它确实支持内联链接.标签不知何故被弃用了吗? (6认同)
  • 为什么将URL链接添加到javadoc是如此复杂?谁认为HTML是个好主意.../facepalm (4认同)
  • 如果您收到类似"警告 - 标记\ @see:缺少最终'>':"的警告,请确保在同一\ @see指令中没有两个超链接.相反,每个@see使用一个链接. (3认同)
  • 作为@Timo 评论的后续:Intelij 2019.1 现在可以正确显示“另见”条目 (3认同)
  • 这太……1997年了! (3认同)
  • 如果其他人像我一样跛脚,并在几个小时内搜索内联版本和另一个版本之间的区别:在'看'之前注意'@';) (2认同)

Aar*_*ron 184

取自javadoc规范

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

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

  • @see不需要.javadocs可以用html标签格式化,所以它只需要"a"标签. (25认同)
  • @GabrielLlamas是的,但最初的问题暗示这就是它的使用方式.知道它特别是_does_在see-also字段中工作是很有用的,这是很多人都想要它的地方. (5认同)

小智 31

Javadocs不为外部链接提供任何特殊工具,因此您应该使用标准html:

See <a href="http://groversmill.com/">Grover's Mill</a> for a history of the
Martian invasion.
Run Code Online (Sandbox Code Playgroud)

要么

@see <a href="http://groversmill.com/">Grover's Mill</a> for a history of 
the Martian invasion.
Run Code Online (Sandbox Code Playgroud)

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


Dr.*_*kel 13

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

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