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