Javadoc 是否具有等效于<！[CDATA[ ... ]]>?

html java xml cdata javadoc

2022-09-01 13:35:45

不幸的是，HTML 中没有 CDATA。

这很遗憾，因为它非常适合添加包含XML的注释，因此您不必转义<并>，例如：javadoc

/**<![CDATA[ This parses <complexType name=""> ]]>*/

但是，可以识别 CDATA 部分，并为您将其转换为 HTML。例如：javadoc

This parses &lt;complexType name=""&gt;

或者它可以使用比 CDATA 更简单的语法。因为它是可扩展的，所以可能有人添加了此功能;或者也许已经把它埋在里面的某个地方了...有人知道吗？javadocjavadoc

答案 1

您可以使用 JavaDoc 的标记：@code/** This parses {@code <complexType name="">} */

答案 2

扩展@Fabian的答案，我同时使用和.下面是一个以 XML 作为源代码的示例：<pre>{@code ...}

/*Outputs data from a result set to an XML
 * with following structure:
 * <pre>
 * {@code
 * <row>
 *  <FIELD1>gregh</FIELD1>
 *  <FIELD2>487</FIELD2>
 *  <!-- etc. -->
 * </row>
 * <!-- more rows-->
 * }
 * </pre>
 */

<pre>允许您在多行上编写代码并保留其结构。

使用 Eclipse 3.6.1 进行了测试。