3

我正在使用apidoc将我的 API 文档从 Github 中的平面文本文件移动到 Javadoc 注释。

因此,我已经有了想要用 javadoc 语法编写的 API 输出示例。我需要*在每行的开头添加一点而不是手动输入它们,因为它们很多。是否可以在 Eclipse 中做到这一点?我在任何地方都找不到它。

例子 :

我想转

{
  "firstResult" : 1,
  "limit" : 30,
  "totalCount" : 2,
  "value" : [ 
    {
      "firstname" : "John",
      "name" : "Doe",
    }, 
    {
      "firstname" : "Johnny",
      "name" : "Doe"
    } 
  ]
}

进入

/**
 * {
 * "firstResult" : 1,
 * "limit" : 30,
 * "totalCount" : 2,
 * "value" : [ 
 *   {
 *     "firstname" : "John",
 *     "name" : "Doe",
 *   }, 
 *   {
 *     "firstname" : "Johnny",
 *     "name" : "Doe"
 *   } 
 * ]
 * }
 */
4

1 回答 1

2

自 1.4 以来的每个 Java 版本中,前导星号都是可选的。

如果你想要它们的外观,这是一种方法。不幸的是,它需要几个步骤。

首先,粘贴您的文本。出于本示例的目的,我们假设只有这四行:

{
  "firstResult" : 1,
  "limit" : 30
}

现在,在顶部添加/** <pre>. 在底部,添加</pre> */. 标签可防止自动换行在创建 javadoc 和Source>Format期间<pre>破坏缩进和换行符。(如果您经常这样做,请考虑先粘贴所有页眉,然后粘贴所有页脚。)

/** <pre>
{
  "firstResult" : 1,
  "limit" : 30
}
</pre> */

现在,使用Source>Format或其快捷键Shift-Control-F格式化文本。(如果您不想格式化整个文件,请先选择您的评论。)

/**
 * <pre>
 *  {
 *    "firstResult" : 1,
 *    "limit" : 30
 *  }
 * </pre>
 */
于 2015-06-25T21:45:05.853 回答