如何在Eclipse中重构Javadoc源代码注释？

Question

在对某个方法进行更改后，我发现手动重构紧接在该方法调用之前的Javadoc源代码注释非常烦人。有没有办法让Eclipse自动为您完成这项工作？

- Tyler

---

我想知道如何重构非代码的东西。更严肃地说，你所说的“一些变更”具体指的是什么，你希望自动完成哪些变更？ - millimoose

假设我删除或添加一个参数，或者更改返回类型，很容易想象会对方法进行哪些更改，这将使javadoc“过时”，需要进行“重构”。 - Tyler

更难想象的是，Eclipse可以自动编写有意义的注释的更改。当然，Eclipse可以为新参数添加占位符，但程序员仍然需要自己编写描述。 - meriton

你可能想要做的不仅仅是改变签名，最好的方式是询问澄清而不是做出假设。（作为推论，最好一开始就表达清楚，而不是期望别人能够理解你的想法。） - millimoose

Answer 1

我认为让Eclipse根据你在方法签名中所做的更改自动更新Java Doc的唯一方法是通过Eclipse自己的菜单功能进行更改：

Refactor ---> Change Method Signature 

如果您在这里更改方法签名，您会自动更新Javadoc注释，否则您需要删除整个javadoc注释并重新输入以重新创建它：

/** + <HIT ENTER>  

- aleroot

Answer 2

此外，再次按下Alt-Shift-J会重新生成Java文档。这是我通常的做法。

- Thom

Answer 3

Google的CodePro Analytix插件可以帮助你在Eclipse中完成这项任务。详情请参见此处。

- Sri Sankaran