2011-09-12 121 views
12

我正在研究一個經常重構以改進它的應用程序。現在,如果我們重命名某個類以更好地捕獲其意圖,則除非使用鏈接({@link ClassName})來引用該類,否則所有提及該類的文檔都不會自動更新。使JavaDoc對重構具有魯棒性

然而,JavaDoc原則聲明應該「在經濟上使用內聯鏈接」,因爲鏈接突出並引起讀者的注意,這是我認爲合理的。你也不能鏈接到方法的參數。

JavaDoc中有沒有另外一種方法可以使評論更具魯棒性以重構我不知道的是什麼?

+2

你是如何重構的?在Eclipse中重命名時,可以選擇搜索註釋。 –

+0

是的,我使用Eclipse,我記得曾經見過。然而,我沒有得到選擇(使用Ctrl + Alt + R),並且我無法找到設置中的任何內容來改變它。無論如何,這將工作多數時間,但它當然可能是模糊的。 – alexsb

+5

IntelliJ通過註釋,字符串和文件搜索來查找要重命名的內容。它還提供了重命名字段,變量和參數..我假設Eclipse也是如此。 –

回答

5

使用eclipse進行重構時,您也可以在xml文件等內容中搜索字符串引用。

按Shift-Alt-R 兩次獲取對話框。 (在Mac上是Option-Command-R 兩次

+0

謝謝!這不是我真正想要的,但我想這是我最好的解決方案。 – alexsb

+0

我想,現在是Alt + Shift + R。 –

+0

兩者都不會{@link}搜索 – Gangnus