使JavaDoc对重构具有鲁棒性

我正在研究一个经常重构以改进它的应用程序。现在，如果我们重命名某个类以更好地捕获其意图，则除非使用链接（{@link ClassName}）来引用该类，否则所有提及该类的文档都不会自动更新。使JavaDoc对重构具有鲁棒性

然而，JavaDoc原则声明应该“在经济上使用内联链接”，因为链接突出并引起读者的注意，这是我认为合理的。你也不能链接到方法的参数。

JavaDoc中有没有另外一种方法可以使评论更具鲁棒性以重构我不知道的是什么？

2011-09-12 alexsb

你是如何重构的？在Eclipse中重命名时，可以选择搜索注释。 –

是的，我使用Eclipse，我记得曾经见过。然而，我没有得到选择（使用Ctrl + Alt + R），并且我无法找到设置中的任何内容来改变它。无论如何，这将工作多数时间，但它当然可能是模糊的。 – alexsb

IntelliJ通过注释，字符串和文件搜索来查找要重命名的内容。它还提供了重命名字段，变量和参数..我假设Eclipse也是如此。 –

使用eclipse进行重构时，您也可以在xml文件等内容中搜索字符串引用。

按Shift-Alt-R 两次获取对话框。（在Mac上是Option-Command-R 两次）

2011-09-12 21:55:41 Pat

谢谢！这不是我真正想要的，但我想这是我最好的解决方案。 – alexsb

我想，现在是Alt + Shift + R。 –

两者都不会{@link}搜索 – Gangnus

回答