[计算机软件及应用]Elipse插件开发手册

Elipse插件开发手册Elipse开发指南 目 录第1章 第6章 SWT概述191.1 SWT简介191.1.1 使用用向导建立一个SWT/JFace Java项目211.1.2 导入SWT的原生库231.1.3 新建一个SWT类文件241.1.4 在主窗口加入一个文本框组件271.1.5 运行HelloWorld.java29第2章 第7章 SWT/JFace的事件模型312.1 事件的四种写法312.1.1 匿名内部类写法312.1.2 命名内部类写法322.1.3 外部类写法332.1.4 实现监听接口的写法332.1.5 总结342.2 7.2 常用事件介绍352.3 在事件代码中如何访问类中的变量352.3.1 访问类中的变量的三种方法352.3.2 Java中变量的称法和说明372.4 本章小结37第3章 第9章 Eclipse的J2EE开发383.1 WEB环境的搭建（V0010）383.1.1 下载CVS版本注意事项383.1.2 Tomcat的下载与安装393.1.3 Lomboz的下载与安装423.1.4 Lomboz的环境设置453.1.5 JSP的HelloWorld463.1.6 如何不必发布就可以在IE上显示WEB修改效果513.1.7 配置Tomcat的数据库连接池53第4章 第17章 Eclipse插件开发起步574.1 Eclipse插件开发简介574.2 插件的Hello World58第5章 第18章常用插件扩展点68第6章 第21章 项目打包与发行726.1 应用程序项目的打包与发行726.1.1 简介726.1.2 7.1.2 打包的具体操作步骤726.1.3 7.1.3 其他得到JAR包的方式806.1.4 7.1.4 让用户电脑不必安装JRE环境846.1.5 7.1.5 更进一步的完善84第7章 插件项目实战篇977.1 前期准备工作977.2 面向对象分析和数据表创建（版本V0010）977.2.1 8.2.1 界面效果及实现功能977.2.2 8.2.2 面向对象的分析与设计98Eclipse开发指南的最终目录 出版日期估计是45月份第1章 Eclipse简介 . 8 1.1 Eclipse的历史 . 8 1.2 Eclipse的体系结构 . 8 1.3 优秀的图形API：SWT/JFace. 9 1.4 开放式、可扩展的IDE. 10 1.5 全中文化的帮助文件 . 10 1.6 Eclipse是开放源代码的 . 11 1.7 本章小结 . 11第2章 安装Eclipse及多国语言包 . 12 2.1 安装JDK. 12 2.2 安装Eclipse. 12 2.3 Eclipse多国语言包的安装 . 14 2.4 本章小结 . 16第3章 安装SWT Designer 17 3.1 下载 . 17 3.2 安装 . 17 3.3 注册激活 . 18 3.4 其他常用插件 . 20 3.5 本章小结 . 21第4章 Eclipse的集成开发环境 . 22 4.1 Eclipse界面简介 . 22 4.2 创建Java项目并运行 . 23 4.3 自定义注释及代码格式化 . 27 4.3.1 自定义注释 . 27 4.3.2 代码格式化 . 29 4.3.3 实践建议 . 30 4.4 使用Eclipse的重构功能 . 30 4.5 任务标记 . 31 4.5.1 任务标记的设定 . 31 4.5.2 过滤任务标记 . 32 4.6 在编程时随意查看JDK、Eclipse源代码 . 33 4.6.1 查看JDK源代码 . 33 4.6.2 查看Eclipse的源代码 . 34 4.7 在代码中搜索 . 36 4.8 打开类型层次结构 . 37 4.9 调试器的使用 . 38 4.10 常用快捷键 . 39 4.11 本章小结 . 40第5章 Eclipse中CVS的使用 . 41 5.1 CVS简介 . 41 5.2 CVS服务器端的安装与配置 . 41 5.3 CVS客户端的配置 . 43 5.4 文件提交与更新的方法 . 48 5.4.1 CVS和VSS的不同之处 . 48 5.4.2 文件的提交和更新 . 48 5.4.3 解决文件提交的冲突 . 50 5.4.4 如何忽略掉不想提交的文件 . 51 5.4.5 实践建议 . 52 5.5 在CVS上为软件打包一个版本 . 52 5.6 将项目替换成CVS上的其他版本 . 53 5.7 修改过去版本的BUG. 54 5.8 本章小结 . 55第6章 SWT概述 . 56 6.1 SWT简介 . 56 6.2 SWT中的包 . 56 6.3 用SWT Designer写一个Hello World. 57 6.4 关于SWT/JFace例程的说明 . 64 6.5 实践建议 . 65 6.6 本章小结 . 65第7章 SWT/JFace的事件模型 . 66 7.1 事件的四种写法 . 66 7.2 常用事件介绍 . 68 7.3 在事件代码中如何访问类中的变量 . 68 7.3.1 访问类中的变量的三种方法 . 68 7.3.2 Java中变量的称法和说明 . 69 7.4 本章小结 . 70第8章 SWT常用组件 . 71 8.1 按钮、复选框、单选框（Button类） . 71 8.2 组件的常用方法 . 72 8.3 标签（Label类） . 73 8.4 文本框（Text类） . 74 8.5 下拉框（Combo类） . 76 8.6 列表框（List类） . 78 8.7 本章小结 . 79第9章 容器类 . 80 9.1 面板（Composite类） . 80 9.2 分组框（Group类） . 80 9.3 选项卡（TabFolder类、TabItem类） . 81 9.4 分割窗（SashForm类） . 83 9.5 带滚动条的面板（ScrolledComposite类） . 84 9.6 本章小结 . 86第10章 布局管理器 . 87 10.1 布局管理器简介 . 87 10.2 充满式（FillLayout类） . 87 10.3 行列式（RowLayout类） . 89 10.4 网格式（GridLayout类） . 92 10.5 堆栈式（StackLayout类） . 98 10.6 表格式（FormLayout类） . 100 10.7 布局的综合实例 . 103 10.8 本章小结 . 108第11章 其他SWT组件 . 109 11.1 工具栏（ToolBar类、ToolItem类、ViewForm类） . 109 11.2 动态工具栏（CoolBar类、CoolItem类） . 110 11.3 菜单（Menu类，MenuItem类） . 113 11.4 滑动条（Slider类）、刻度条（Scale类）、进度条（ProgressBar类） . 115 11.5 画布（Canvas类） . 116 11.6 表格（Table类） . 118 11.7 树（Tree类） . 119 11.8 表格型树（TableTree类） . 120 11.9 本章小结 . 122第12章 图像 . 123 12.1 图像（Image类） . 123 12.2 图像（Image类）存在的问题 . 124 12.3 图像描述符（ImageDescriptor类） . 124 12.4 图像注册表（ImageRegistry类） . 125 12.5 本章小结 . 126第13章 SWT的线程 . 127 13.1 SWT线程简介 . 127 13.2 一个SWT线程的实例 . 127 13.3 对11.4节进度条实例的改进 . 131 13.4 本章小结 . 133第14章 表格（TableViewer类） . 134 14.1 前言 . 134 14.2 让数据在TableViewer中显示出来 . 134 14.3 TableViewer响应鼠标事件 . 140 14.4 加上右键菜单(Action类、ActionGroup类、MenuManager类) 141 14.5 TableViewer排序（ViewerSorter类） . 143 14.6 加上工具栏（ToolBarManager类） . 145 14.7 创建一个带复选框的TableViewer（CheckboxTableViewer类） . 149 14.8 单击修改表格单元格值（CellEditor类、ICellModifier接口） . 151 14.9 其他使用技巧 . 154 14.10 本章小结 . 155第15章 树（TreeViewer类）和列表（ListViewer类） . 156 15.1 树简介 . 156 15.2 前期准备：实例所用数据模型说明 . 156 15.3 让数据在树中显示出来 . 158 15.4 给树加上右键菜单及取得结点的值 . 163 15.5 树结点的展开、收缩、新增、删除、修改 . 164 15.6 ListViewer简介 . 168 15.7 ListViewer的实例 . 168 15.8 ListViewer常用方法 . 169 15.9 本章小结 . 169第16章 对话框 . 170 16.1 对话框（Dialog类） . 170 16.1.1 对话框简介 . 170 16.1.2 信息提示框（MessageDialog类） . 171 16.1.3 输入值对话框（InputDialog类） . 172 16.1.4 自定义对话框（Dialog类） . 173 16.1.5 对话框的设置与取值 . 177 16.1.6 带提示栏的对话框（TitleAreaDialog类） . 178 16.2 向导式对话框（WizardDialog类） . 179 16.2.1 向导式对话框简介 . 179 16.2.2 向导式对话框实例 . 180 16.2.3 向导式对话框使用的注意事项 . 184 16.3 进度条对话框（ProgressMonitorDialog类） . 185 16.3.1 进度条对话框简介 . 185 16.3.2 进度条对话框实例 . 185 16.4 其他类型对话框 . 187 16.4.1 信息提示框（MessageBox类） . 187 16.4.2 颜色选择对话框（ColorDialog类） . 188 16.4.3 字体选择对话框（FontDialog类） . 188 16.4.4 打印设置对话框（PrintDialog类） . 189 16.4.5 目录选择对话框（DirectoryDialog类） . 193 16.4.6 文件选择对话框（FileDialog类） . 193 16.5 本章小结 . 195第17章 Eclipse插件开发起步 . 196 17.1 Eclipse插件开发概述 . 196 17.2 插件的Hello World. 196 17.2.1 使用向导一步步创建HelloWorld. 196 17.2.2 以空白项目为基础创建HelloWorld. 199 17.3 本章小节 . 203第18章 常用插件扩展点 . 204 18.1 加入透视图（perspectives） . 204 18.2 在透视图中加入视图 (views) 206 18.3 在视图之间实现事件监听 . 208 18.4 给视图加下拉菜单和按钮 . 210 18.5 加入编辑器(editors) 212 18.6 编辑器类（EditorPart）方法使用说明 . 216 18.7 加入首选项 (preferencePages) 219 18.8 加入帮助(toc) 224 18.9 弹出信息式的帮助（contexts） . 226 18.10 本章小结 . 228第19章 Eclipse插件的国际化 . 229 19.1 国际化简介 . 229 19.2 为国际化创建一个插件的“段项目” . 229 19.3 类程序的国际化 . 231 19.4 plugin.xml的国际化 . 236 19.5 其他XML文件的国际化 . 237 19.6 使用“外部化字符串”向导 . 238 19.7 本章小结 . 240第20章 报表：用POI与Excel交互 . 241 20.1 POI概述 . 241 20.1.1 POI简介 . 241 20.1.2 POI的下载与安装 . 241 20.2 将数据导出成Excel的实例 . 244 20.2.1 创建一个空白的Excel文件 . 244 20.2.2 往Excel单元格中写入信息 . 244 20.2.3 中文化的问题 . 245 20.3 使用式样 . 246 20.3.1 日期式样及文字对齐式样 . 246 20.3.2 边框式样 . 247 20.3.3 背景色及底纹式样 . 248 20.3.4 合并单元格 . 248 20.3.5 字体式样 . 249 20.4 更多的用法 . 249 20.4.1 设置页眉页脚 . 249 20.4.2 冻结和分割窗 . 250 20.4.3 浮动文字框及在表中画图 . 250 20.4.4 设置打印的范围 . 251 20.4.5 读取及修改Excel 251 20.5 本章小结 . 252第21章 项目打包与发行 . 253 21.1 应用程序项目的打包与发行 . 253 21.1.1 简介 . 253 21.1.2 打包的具体操作步骤 . 253 21.1.3 其他得到JAR包的方式 . 257 21.1.4 使用第三方插件对项目打包 . 258 21.1.5 让用户电脑不必安装JRE环境 . 260 21.1.6 更进一步的完善 . 260 21.1.7 打包的其他说明 . 262 21.2 插件项目的打包与发行 . 263 21.2.1 简介 . 263 21.2.2 打包的具体操作步骤 . 263 21.2.3 测试打包效果 . 265 21.3 用Ant来打包 . 266 21.4 本章小结 . 271第22章 插件项目实战篇 . 272 22.1 前期准备工作 . 272 22.1.1 软件开发过程 . 272 22.1.2 本章项目开发环境的选择 . 273 22.1.3 安装MySQL. 276 22.1.4 在Eclipse插件中连接MySQL数据库（版本V0001） . 279 22.1.5 解决Java的中文问题 . 284 22.1.6 对字符集设置的测试结果 . 286 22.2 面向对象分析和数据表创建（版本V0010） . 292 22.2.1 界面效果及实现功能 . 292 22.2.2 面向对象的分析与设计 . 293 22.2.3 创建数据表 . 301 22.2.4 给数据表插入数据 . 305 22.3 创建项目的主界面框架 . 306 22.3.1 前言 . 306 22.3.2 创建透视图及主功能视图（版本V0020） . 307 22.3.3 创建“功能导航器视图”的树（版本V0020） . 310 22.3.4 创建项目的图像注册表（版本V0030） . 314 22.4 用户登录、退出功能的实现（版本V0040） . 317 22.4.1 实现方案 . 317 22.4.2 界面部份的源代码 . 318 22.4.3 数据库部份的源代码 . 323 22.4.4 小结 . 328 22.5 “档案管理”编辑器的实现 . 328 22.5.1 前言 . 328 22.5.2 编辑器的创建与排序、翻页功能的实现（版本V0050） . 328 22.5.3 实现删除用户功能（版本V0060） . 339 22.5.4 实现新增用户功能（版本V0060） . 341 22.5.5 实现修改用户的功能（版本V0070） . 353 22.6 “成绩管理”编辑器的实现（版本V0080） . 359 22.6.1 前言 . 359 22.6.2 单击结点打开视图 . 359 22.6.3 实现搜索视图SearchView. 360 22.6.4 实现“成绩管理”编辑器 . 364 22.7 让软件适应多种数据库（版本V0090） . 366 22.7.1 前言 . 366 22.7.2 解决方案 . 367 22.7.3 具体实现的源代码 . 367 22.8 首选项的实现（版本V0100） . 369 22.8.1 前言 . 369 22.8.2 首选项的源代码 . 369 22.8.3 将程序中的设置值改成取之于首选项的设置 . 374 22.9 本章小结 . 374第23章 WEB环境的搭建（V0010） . 375 23.1 前言 . 375 23.2 Tomcat的下载与安装 . 376 23.3 Lomboz的下载与安装 . 379 23.4 Lomboz的环境设置 . 381 23.5 JSP的HelloWorld. 382 23.6 如何不必发布就可以在IE上显示WEB修改效果 . 386 23.7 配置Tomcat的数据库连接池 . 388 23.8 本章小结 . 390第24章 一个纯JSPJavaBean实例（V0020） . 391 24.1 JavaBean的环境配置 . 391 24.2 创建JavaBean及数据库层 . 391 24.3 编写前台的JSP文件 . 393 24.4 本章小结 . 398第25章 在Eclipse中使用Struts. 400 25.1 前言 . 400 25.2 Struts的下载及安装（V0030） . 400 25.3 Struts入门实例（V0030） . 402 25.3.1 Struts原理简介 . 402 25.3.2 用户登录实例 . 404 25.4 让Dreamweaver支持struts标签 . 410 25.5 struts-config.xml再深入 . 412 25.5.1 页面转发 . 412 25.5.2 项之动态ActionForm. 413 25.5.3 项 . 413 25.5.4 使用DispatchAction类 . 414 25.5.5 使用多个struts-config.xml配置文件 . 415 25.6 验证的多种方法（V0040） . 416 25.6.1 方法一 . 416 25.6.2 方法二 . 416 25.7 使用更多的struts标签 . 423 25.7.1 获知更多的标签 . 423 25.7.2 表单类标签 . 423 25.7.3 其他说明 . 425 25.8 本章小结 . 425第26章 在Eclipse中使用Hibernate. 426 26.1 前言 . 426 26.2 Hibernate的下载和安装（V0050） . 427 26.3 一个简单的Hibernate实例（V0050） . 431 26.4 继续深入使用Hibernate（V0060） . 435 26.5 实现用户的修改、删除功能（V0070） . 440 26.6 解决Tomcat的中文问题（V0070） . 446 26.7 Hibernate的自动生成工具 . 447 26.8 本章小结 . 452第1章 第6章 SWT概述在这一章里将把SWT和AWT/SWING做了简单的比较，并以一个HelloWorld的Java应用程序（Application）作为起步，让读者可以快速建立对SWT/JFace的感性认识。在这一章里所有的例子都是以Java应用程序方式来写的，之所以如此，是因为Java应用程序代码简洁，且可以独立运行，便于讲解和示范。当然，这些例子的代码方法同样适用于Eclipse的插件开发，SWT/JFace在Java应用程序和Eclipse插件开发中的使用是没有太多区别的。1.1 SWT简介2003年，笔者对SWT/JFace（英文全称：Standard Widget Toolkit）还是仅有耳闻，知道在AWT/Swing之外，又有了一个新的图形API包，听说还很不错，当时书店里根本没有相关资料，只能在网上找到一些零星的文章来了解。2004年前，笔者还极少用Java来写GUI程序（GUI全称：Graphical User Interfaces，图形用户界面），主要的工作都是用JSP来写网页。用JAVA来开发大型的GUI程序实在很困难的事，大都丑陋又笨重（慢），SUN在GUI方向上的失败是公认的事实。失败关键之处在于Java的图形API包AWT/SWING在速度和外观上都不能让人满意，外观总是和同操作系统平台下的其他软件格格不入，对机器配置的需求也似乎永无止境。2004年初，笔者有幸参与到一个用Eclipse插件方式来开发的软件项目中，该软件使用到了SWT/JFace，那界面实在是太酷太漂亮了，让人为之耳目一新，而且界面响应速度极快，这真的是用Java开发的吗？当时竟然有点不敢相信。无疑，SWT/JFace象一股清新的风吹入了Java的GUI开发领域，为这个沉闷的领域带来了勃勃生机。虽然SUN不接纳SWT/JFace作为Java中的一种图形API标准，但它虽然借着Eclipse的优异表现，以不可阻挡之势向前发展着。终于可以用SWT轻松的开发出高效率的GUI程序，且拥有标准的Windows外观，Eclipse软件就是基于SWT/JFace构建的，大家看看Eclipse3.0就知道SWT有多么的棒。图6.1 SWT、JFace、GUI程序三者关系示意图如上图6.1，为了方便开发SWT程序，在SWT基础上又创建了一个更易用、功能强大的图形包“JFace”。然而，JFace并不能完全覆盖SWT的所有功能，所以编程时SWT、JFace都会要用到，但是一般来说，能用JFace的组件就最好不要用SWT的。6.2 SWT中的包SWT是Eclipse图形API的基础，本节将简单介绍一下SWT中所包含的子包。1、org.eclipse.swt.widgets最常用的组件基本都在此包中，如Button、Text、Label、Combo等。其中两个最重要的组件当数Shell和Composite：Shell相当于应用程序的主窗口；Composite相当于SWING中的Panel对象，是容纳组件的容器。2、org.eclipse.swt.layout主要的界面布局方式在此包中。SWT对组件的布局也采用了AWT/SWING中的Layout和Layout Data结合的方式。3、org.eclipse.swt.custom对一些基本图形组件的扩展在此包中，比如其中的CLabel就是对标准Label组件的扩展，在CLabel上可以同时加入文字和图片。在此包中还有一个新的布局方式StackLayout。4、org.eclipse.swt.eventSWT采用了和AWT/SWING一样的事件模型，在包中可以找到事件监听类和相应的事件对象。比如，鼠标事件监听器MouseListener，MouseMoveListener等，及对应的事件对象MouseEvent。5、org.eclipse.swt.graphics此包中包含针对图片、光标、字体或绘图API。比如，可通过Image类调用系统中不同类型的图片文件。6、org.eclipse.swt.ole.win32对不同平台，SWT有一些针对性的API。例如，在Windows平台，可以通过此包很容易的调用OLE组件，这使得SWT程序也可以内嵌IE浏览器或Word、Excel等程序。此外还有org.eclipse.swt.dnd、org.eclipse.swt.printing、org.eclipse.swt.program、org.eclipse.swt.accessibility、org.eclipse.swt.browser、org.eclipse.swt.awt等包，在此不一一介绍了。这些包一般很少用到，只需要稍微了解一下就行了，不必深究。6.3 用SWT Designer写一个Hello WorldSWT Designer是优秀的SWT/JFace开发辅助工具，本书大都SWT/JFace的例子都是使用它来生成代码后，再进行修改而成。当然，SWT Designer并非是阅读和运行这些例子的必须条件。本节将用SWT Designer来写出第一个基于SWT的HelloWorld程序，以此给读者演示在开发中是如何使用SWT Designer的。1.1.1 使用用向导建立一个SWT/JFace Java项目（1）选择主菜单“文件新建项目”，弹出如下图6.2所示窗口。图6.2 新建项目窗口（2）选择“Designer”下的“SWT/JFace Java Project”项，单击“下一步”，弹出如下图6.3所示窗口。图6.3创建Java项目窗口（3）填写项目名称“myswt”，项目布局选择第二个，单击“完成”。这时如果打开“java”透视图，可以看到多了一个名为“myswt”的项目，下方还排列着很多库引用，如下图6.4所示窗口。图6.4 “java”透视图注：（1）其实写SWT程序也不是一定要重新建立这样一个新的项目，原来老的“myproject”项目依然可以继续使用的，但必须将SWT、JFace包及一些相关的包引用到Java构建路径中，手工一步步做这个工作太过于繁锁。有一个简单的方法：借助SWT Designer新建项目时保存在.classpath文件中的库引用，将其复制粘贴到myproject的.classpath中即可。（2）当编写Java程序时，笔者认为“Java”透视图要比默认的“资源”透视图好用，主要是因为前者的包显示不是树状的，用起来较方便。但选择哪一种透视图，还是要看各人的习惯和喜好。本书以后的所讲内容将统一使用“Java”透视图。1.1.2 导入SWT的原生库想要运行Java应用程序，必须将SWT的原生包导入到项目中，否则该项目在运行程序时会报异常“java.lang.UnsatisfiedLinkError: no swt-win32-3063 in java.library.path”，并弹出图6.5所示的错误提示框。图6.5 未导入SWT原生包时产生的错误提示框导入SWT原生包的步骤如下：（1）右键单击项目名“myswt”，在弹出菜单中选择“导入”，则会弹出如图6.6所示窗口。图6.6导入窗口（2）选择“文件系统”后单击“下一步”，转到如图6.7所示窗口图6.7选择导入文件（3）通过“浏览”按钮找到SWT原生库的路径（也可以直接输入路径文字），路径为“C:eclipsepluginsorg.eclipse.swt.win32_3.0.1oswin32x86”。然后将“swt-win32-3063.dll”选上，单击“完成”，导入SWT原生包的设置结束。1.1.3 新建一个SWT类文件参阅“4.2节 创建Java项目并运行”所讲方法，新建一个类文件。（1）在“Java”透视图的“包资源管理器”中，右键单击“com.swtdesigner”包，在弹出菜单中选择“新建其他”，弹出如图6