WindowBuilder是一款非常强大易用的java GUI设计工具,可以让程序像使用Visual Studio一样实现对UI的所见即所得(WYSWYG)设计。WindowBuilder原先是google开发的免费软件,现在已经贡献给eclipse.org。关于如何安装WindowsBuilder不是本文的重点,网上可以找到好多关于WindowBuilder安装的教程,我照着教程安装好WindowBuilder后发现代码中引用的SWT/JFace相关的类都没有JavaDoc文档支持。
因为安装WindowBuilder时是不包含SWT/JFace待第三库的JavaDoc的(SWing是JDK自带的,有源码支持),导致开发过程中要了解相关的类的说明就比较麻烦。如果要在eclipse中加入对SWT/JFace等第三库的JavaDoc和源码支持,有两个解决办法。
方法一:在线JavaDoc
以JFace为例,
如下图,鼠标右键点击你的项目属性,找到Java构建路径,找到org.eclipse.jface.xxxx.jar包,对JavaDoc位置点编辑,
如下图,将如下URL
http://help.eclipse.org/luna/nftopic/org.eclipse.platform.doc.isv/reference/api/
输入JavaDoc URL,点击验证,显示验证有效,就好了。
说明:我的eclipse版本是luna(4.4),如果是其他版本请将上面URL中的luna换成对应版本的名字
再重新启动eclipse,鼠标移动到相关的类上,就会自动显示JavaDoc内容
方法二:离线JavaDoc
方法一使用在线JavaDoc还是有缺点,对于网络情况不好的环境,获取在线文档就会比较吃力,而且没有源码支持。所以如果能有本地JavaDoc文档,还是首选。
但是eclipse并没有单独为SWT/JFace这些库提供单独的JavaDoc文档下载链接,不过解决的办法总是有的。
Eclipse SDK是eclipse旗下的一个project也是eclipse的基础构件,Eclipse SDK提供了完整的eclipse的所有文档和源(不仅限于SWT/JFace)。
下载Eclipse SDK
打开下面的链接
The Eclipse Project Downloads
http://archive.eclipse.org/eclipse/downloads/
根据你的eclipse版本找到相应的链接点击进去,然后下载对应操作系统的Eclipse SDK,大概近200MB。
在下载的zip包中,如下图找到org.eclipse.platform.doc.isv_xxxx.jar,把它单独提取出来。这就是eclipse所有插件的JavaDoc包。
以SWT为例,如下图设置JavaDoc就可以了。
Eclipse SDK中还包括了所有eclipse 插件的源码,所以如果你想查看源码也是可以的,
还以SWT为例,如下图在eclipse SDK的zip包中找到swt对应的源码包(名字包含source的为源码包)
将它单独提取出来,
然后如下图设置源码位置,
设置好之后,点击SWT的任意一个类,就可以查看源码了:
方法三:安装Eclipse SDK插件
方法二要手工设置好多jar的JavaDoc和Source位置。如果你觉得方法二还是太麻烦,那么还有一个更简单的办法,就是在线安装Eclipse SDK插件,
如下图,选择eclipse update site
勾选Eclipse SDK安装插件
安装好Eclipse SDK插件后,所有的eclipse SDK中包含的插件都有了source。
不过如果你需要JavaDoc还是需要手工设置了。如下图,在${eclipse安装目录}/plugins下就可以找到org.eclipse.platform.doc.isv_xxxx.jar,还是比方法二方便,不用从Eclipse SDK zip中提取了。
不过在我这里,在线安装Eclipse SDK插件是个很耗时的任务,我花了差不多两个小时的时间才把它安装好。真不想再装第二次。
参考资料:
http://*.com/questions/566877/how-to-get-javadoc-for-swt-and-jface-in-eclipse
http://*.com/questions/3700756/where-can-i-download-the-javadoc-for-swtonly