使用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包進行匯入即可。