如何使用@和{符号内部格式化Javadoc中的代码片段?

yeg*_*256 35 java javadoc

这就是我想要做的:

/**
 * <pre>
 * {@code
 * &#64;XmlRootElement
 * public final class Page &#123;
 * &#125;
 * }
 * </pre>
 */
Run Code Online (Sandbox Code Playgroud)

我希望它的格式如下:

@XmlRootElement
public final class Page {
}
Run Code Online (Sandbox Code Playgroud)

但是我得到了:

&#64;XmlRootElement
public final class Page &#123;
&#125;
Run Code Online (Sandbox Code Playgroud)

与真正的符号替换这些HTML实体(@,{,})导致的Javadoc警告,绝对不正确的格式.什么是变通方法?

yeg*_*256 38

这就是它最终对我有用的方式:

/**
 * <pre>
 * &#64;XmlRootElement
 * public final class Page {
 * }
 * </pre>
 */
Run Code Online (Sandbox Code Playgroud)


Pat*_*ick 29

<pre>
<code>
{@literal@}Override
public String toString() {
    return "blah";
}
</code>
</pre>
Run Code Online (Sandbox Code Playgroud)

这适合我.


Ale*_*exR 7

用你的代码片段包装<pre><code></code></pre>.这些是特殊的HTML标记,可以让您忘记转义特殊字符.

  • 呵呵."pre"或"code"的定义中没有任何内容可以转义特殊字符.它们只改变字体和空格解释.(另外,在HTML浏览器获取它们之前,`@`和`{`可能会被Javadoc解释.) (5认同)