Eclipse - 如何在类/方法的注释部分创建表？

Question

我想使用<\tbody>,<\tr>并<\td>在方法的注释部分创建一个表：

<tbody>
<tr>
    <td>personId</td>
    <td>y</td>
    <td>identifiant</td>
    <td>C16</td>
    <td>String</td>
</tr>
<tr>
    <td>lastName</td>
    <td>n</td>
    <td>nom</td>
    <td>C32</td>
    <td>String</td>
</tr>
</tbody>

不幸的是它不起作用，因为我在 Java 文档中没有看到表格，只有以下内容：

personId y identifiant C16 String lastName n nom C32 String

我应该怎么办 ？该<\table>标签不是 Eclipse 提议的，如果我使用它，它不会改变任何东西。如果重要的话，我正在使用 eclipse Neon。

Answer 1

作为替代变体，使用<pre></pre>标签来呈现降价表

/**
 * Description
 * <pre>
 | Key   |    Value    |
 |-------|-------------|
 | 1     | Value1      |
 | 2     | Value2      |
 *</pre>
 */

生成：

Answer 2

首先，您应该table在之前指定元素tbody以符合元素table：

允许的内容

按此顺序：

• 一个可选的标题元素，

• 零个或多个 colgroup 元素，

• 可选的 head 元素，

• 以下任一情况：

  • 零个或多个 tbody 元素

  • 一个或多个 tr 元素

• 可选的 tfoot 元素

其次，您不需要 Eclipse 向导或工具来使用 HTML 标记记录 Javadoc。
只需在 javadoc 注释中写入您的 HTML 内容：

/**
<table><tbody>
<tr>
    <td>personId</td>
    <td>y</td>
    <td>identifiant</td>
    <td>C16</td>
    <td>String</td>
</tr>
<tr>
    <td>lastName</td>
    <td>n</td>
    <td>nom</td>
    <td>C32</td>
    <td>String</td>
</tr>
</tbody></table>
 */
public void foo(){
  ...
}

它应该在 javadoc 视图或生成中以表格方式显示它：

无效 foo()

personId y 标识符 C16 字符串

姓氏 n 名义 C32 字符串