我是GhostDoc在 Visual Studio 中自动生成注释的忠实粉丝,所以我正在寻找一个插件,它可以在 Eclipse 中对我的 Java 代码执行相同的工作。有什么建议吗?
5 回答
您可以查看作者的 JAutodoc ( http://jautodoc.sourceforge.net/ )
:
JAutodoc 是一个 Eclipse 插件,用于自动将 Javadoc 和文件头添加到您的源代码中。它可以选择使用 Javadoc 和文件头的 Velocity 模板从元素名称生成初始注释。
这是我发现的最接近 GhostDoc 的一个。
它基本上相当于 Javadoc,可以在 eclipse 中使用快捷方式生成:
ALT+ Shift+J
(当您在希望为其添加 javadoc 的 Java 函数中时)
从那里,如果你真的想要 XML 格式,你可以尝试使用 JELDoclet
GhostDoc 有一个很好的额外功能,它通过解析方法名称并将其作为骨架文档提供来推断方法的功能描述。例如,在名为 GetDocumentName() 的方法上使用 GhostDoc 可能会返回短语“获取文档名称”。虽然这几乎没有比方法名称提供的更多信息,但它添加了以前不存在的方法文档。有些人可能会争辩说这几乎没有用。我反对,因为它支持从源代码生成文档(例如,对于像 NDoc 或 SandCastle 这样的工具)。
在我看来,GhostDoc 相对于 eclipse 的“生成元素注释”的最大好处是它鼓励程序员通过添加一种极其快速和可靠的方式来开始添加文档注释。程序员可以接受推断的文本(适用于 50 - 80% 的情况),或者在此基础上扩展更复杂的方法。对于不熟悉如何使用文档注释的初级程序员来说,这可以快速缩短学习曲线并鼓励良好的编程实践。
Javadoc 不像我朋友的 GhostDoc。Javadoc 仅创建结构,因此可以从头开始编写文档。GhostDoc 实际上是根据 Method/Property 名称来填充信息的。
例子:
/// <summary>
/// Gets the user from id.
/// </summary>
/// <param name="id">The id.</param>
/// <returns></returns>
private string GetUserFromId(string id);
JAutoDoc是迄今为止我发现的最接近的,但它不像 GhostDoc 那样神奇。
从未使用过 GhostDoc,所以不确定它提供了哪些额外功能,但如果它是关于基于名称、参数、返回类型等生成类型和方法注释,那么 eclipse 内置了它,因此不需要扩展。