2013-10-08 70 views
0

我使用maven生成我的項目的Javadoc(使用javadoc:javadoc目標)。 我還配置了Javadoc位置我的項目的屬性到maven生成Javadoc的文件夾。然後,通過選擇「在瀏覽器中打開附加的Javadoc」,我可以輕鬆地從Eclipse Javadoc視圖中看到一個類的完整Javadoc。在Eclipse中保存生成javadoc

但是,每次我做的文檔中的一些變化的時間,我需要明確地重新使用Maven的文檔,以前我可以看到在瀏覽器中的文檔更新。

有沒有一種方法可以指示Eclipse在保存文件時自動生成Javadoc文件?

我知道這可能不是一個好主意,當不專注於編寫文檔時,因爲它可能會減慢一點Eclipse。但是,當我的主要任務是編寫文檔時,這種意義上的一些自動化將不勝感激。我想正確的解決方案通過更新只保存文件的文檔(而不是觸發整個Javadoc生成過程),但我不知道這樣的事情是否可能。

+0

你會發現這個有用 http://stackoverflow.com/questions/2632425/how-do-i-start-maven-compile-goal-on-save -in-eclipse – edio

回答

1

如果您使用的Maven Integration for Eclipse (m2e),你可以建立一個plugin execution filter使M2E知道你渴望在Eclipse中也執行特定的插件運行。你會希望有插件在後臺運行:

 <execute > 
     <runOnIncremental>true</runOnIncremental> 
     </execute > 

這一切的另一面是,它會運行整個的Javadoc執行每次保存的東西,增量在這個意義上誤導。它可能阻塞你的Eclipse,而不僅僅是「一點點」,就像你在更新的問題中所說的那樣。每個比絕對平凡的插件執行都要仔細審查。

一個真正的增量解決方案將不是來自Maven的,因爲它沒有爲待建項目只有部分的意義。相反,您需要Eclipse直接執行此操作。我認爲Java編譯也會發生同樣的情況:它是由Eclipse本身逐步完成的。但根據Javadoc常見問題:

A9。我可以通過不同的Javadoc運行增量構建文檔嗎?

基本上沒有(...)

我們稱之爲增量構建和正在考慮在將來的版本。

但沒有什麼是不可能的:)

+0

lol我喜歡在執行過濾器鏈接中的評論:「使用這個作爲最後的手段,並確保你知道你在做什麼。」正如你所說,在每次保存時觸發整個Javadoc生成過程將會減慢Eclipse的速度。然後,一個可用的解決方案可能會通過生成僅更改文件的Javadoc來傳遞。我剛剛更新了這個問題。感謝您的反饋! – Sergio

+0

@Sergio我已經更新了我的答案:) –