如何在 Eclipse 中智能地修复文档?
回到我的C#时代,我喜欢使用名为“GhostDoc”的Visual Studio扩展。现在我被用作Java开发人员,我正在使用Eclipse。我可以在没有推断文档的情况下生活,但我想做的是智能地“修复”我的文档。例如,假设我有以下方法:
/**
* Gets a collection of {@link Foo} objects
* @param bar The bar level
* @param baz The bazziness
*/
public Collection<Foo> getFoos(int bar, int baz)
{
// Do something cool
}
在后来的开发中,我意识到允许我的方法的使用者传入 qux 值会很有用。不仅如此,将其作为第一个参数是最有意义的。另外,我将让该方法抛出我超级有用的FooBarException。所以现在我的方法看起来像这样:
/**
* Gets a collection of {@link Foo} objects
* @param bar The bar level
* @param baz The bazziness
*/
public Collection<Foo> getFoos(String qux, int bar, int baz) throws FooBarException
{
// Do something cool
}
作为一名优秀的开发人员,我希望我的更改反映在我的JavaDoc中。在GhostDoc中,我可以点击我的文档快捷键,它会添加新的东西,而不会打扰旧的东西。在Eclipse中,它渲染了一组全新的JavaDoc,我必须做一堆复制意大利面。如何自动将新的 、和缺少的参数放入我的 JavaDoc 中,而不会丢失我当前拥有的 JavaDoc?@param
@exception
@returns