使用eclipse時引入javadoc與source

作用

憑藉eclipse可以實現方便地查看所引用的第三方jar包的源碼與幫助文檔,這樣不僅可以提高開發效率,也有助於我們的學習進步。

方法

該網址所提供的方法值得推薦:http://blog.csdn.net/cjjky/article/details/6535426
在該方法的基礎上,有以下要注意的地方:

源碼不必解壓導入

對於所找到的相應jar包的源碼,是不需要解壓後纔可以導入查看的。在Project Explorer視圖下,找到所使用的jar包,右鍵單擊,選擇最後一項Properties,在打開的對話框中,左側第一項即爲選擇附加源碼,直接選擇.zip源碼即可,當然也可以選擇.jar格式源碼或解壓後的folder。右側三個選擇按鈕功能分別爲:
Workspace:直接從該workspace下選擇包含源碼的foler或.zip/.jar文件;
External File:從外界選擇包含源碼的.zip/.jar文件;
External Folder:從外界選擇包含源碼的folder。
左側第二項即爲選擇所依附的javadoc,第一種方式是Javadoc URL,既可以直接輸入URL,通過聯網查看api,也可以通過點擊Browse來選擇幫助文檔(API)。下面的Validate按鈕用來測試api文檔是否可用。需要注意的是,對於檢測完成後彈出的對話框,右側的Open in Browser所反映的結果是不正確的,也就是說即使設置是成功的,但在外界的瀏覽器中是無法打開的,這一點大家不必介意。第二種方式是Javadoc in archive,這裏是用來選擇.zip/.jar格式的幫助文檔的,而下面的兩項所代表的僅僅是絕對路徑與相對路徑的不同,大家不必介意,只要找到對應的.zip/.jar文件即可。設置完成後,即可在Eclipse中直接查看第三方jar包的源碼與api,點擊相應的類或方法,按下快捷鍵F1,即可打開help視圖,查看api。

一定要找對需要設置javadoc與source的jar包

我剛開始設置的時候,總是沒有反應,查看設置的路徑是完全正確的,最後才反應過來。我對於第三方的.jar包,首先拷到了lib文件夾下,這時,已經在Web App Libraries中生成了相應的jar包,是不需要再去Build Path的,而我卻又進行了Build Path,這在Android中是必須的,但在Java EE中是不必的。進行了Build Path之後,在Libraries下又會出現重複的jar包,但這些jar包是不會被使用的,而我則在對不會被使用的jar包進行着source與javadoc的設置,所以總是不成功。這就提醒大家一下,以防犯我一樣的錯誤,浪費時間。
就是這樣了,希望對大家有幫助!

補充:
要導入jdk的javadoc與source,針對rt.jar包進行導入即可。
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章