Eclipse RCP+Spring建胖客户端Web程序

　摘要 Eclipse丰富的客户端平台（RCP）正在快速地成为构建胖客户端应用程序的框架选择。本文将向你详细介绍如何利用Eclipse RCP进行Spring Web开发。

　　一. 引言

　　尽管Web 2.0和丰富的因特网应用程序(RIA)如今极为风行，但是，当你真正需要胖客户端功能时构建一个丰富的Web前端可能并不真正满足你的要求。 字串1

　　但是，如果你确实想避开所谓RIA狂热而选择一种实际的胖客户端解决方案的话，那么你该怎样做呢？回答是：你可以选择一种丰富的客户端平台(RCP)来为你处理大多数的工作。实质上，这种RCP概念为Java桌面应用程序世界提供了一种新型的框架。

　　一个RCP提供了一个应用程序的框架/外壳，还有一组基于模块的API，你能够基于这一外壳来构建自己的应用程序。这个RCP负责实现所有的繁重任务，例如添加菜单，工具条，不同的视图等等，而你就不必再重复工作。

　　本文将引导你详细地构建一个胖客户端接口以连接到在上一篇文章中构建的服务器上。你将基于Eclipse丰富的客户端平台来构建胖客户端，然后把Eclipse RCP与Spring集成到一起。 字串1

　　【准备工作】 字串9

　　?Eclipse 3.1.2 字串1

　　?MyEclipse 4.1.1 字串6

　　?Java SE 5 字串1

　　?一个Servlet容器或J2EE服务器(本文使用的是Tomcat 5.5+)

　　?Spring 1.2+

　　二. 为什么使用Eclipse RCP？ 字串5

　　如今已经有越来越多的应用程序基于Eclipse RCP进行开发（当然，还有Eclipse厚实的开发背景），所以，我们可以安全地假定，与任何其它框架相比，这种框架已经得到更为广泛的测试。 字串3

　　下面，让我们开始。 字串9

　　（一） 创建一个新的Eclipse插件工程

字串1

　　请按照下列步骤为你的丰富的客户端应用程序创建一个新的Eclipse插件工程：

　　1. 在Eclipse中创建一个新的插件工程，并命名工程为EclipseTradeClient。把这个插件的应用目标定位在Eclipse 3.1版本，并且确保点选了"Create an OSGi bundle manifest"(见图1)，并点击Next。

字串6

字串7

图1."New Plug-in Project"对话框在Eclipse中创建一个新的插件工程EclipseTradeClient。

字串7

　　2. 在"Plug-in Content"屏幕上，保持默认设置，但是确保选择了"Yes"-创建一个丰富的客户端应用程序(见图2)，并点击Next。

字串7

字串3

图2.在"Plug-in Content"屏幕选择创建一个丰富的客户端应用程序。 字串6

　　?至于模板，选择"RCP application with a view"，并点击Next。 字串1

　　?填写显示如图3的RCP应用程序属性，并点击Finish。之后，你将被提示转到"Plug-in Development"视图下，并点击Yes。 字串2

字串2

图3.RCP插件工程向导最后的结果屏幕 字串7

　　?现在，你已经创建了你的工程，再打开plugin.xml。你将看到如下图4所示的屏幕快照。 字串7

字串1

图4.Plugin.XML概要 字串2

　　如果你是Eclipse插件开发的新手，你可能经常需要使用底部的plugin.xml选项卡。正如你从Overview选项卡中所看到的，你可以运行/调试你的Eclipse丰富的客户端应用程序。

字串5

　　?展开EclipseTradeClient/src/eclipseTradeClient包来观察Eclipse的RCP向导为你创建的类。在Eclipse编辑器中，点击"All Extensions"选项卡并且展开每一个顶级的结点，如图5所示。 字串1

字串8

图5.Eclipse生成的类及所有的扩展 字串1

　　请注意一下你的Application类，Perspective类和View类的扩展入口。既然Eclipse的丰富的客户端平台包括plugin.xml文件，所以你可以简单地添加新的组件-通过"Extensions"选项卡中的"Add..."按钮来添加它们。 字串1

　　（二） 重构默认的View类

　　如你所见，Eclipse向导为你创建了一个称为View的类。并不是很有用，对吗？请使用如下步骤来重构默认的视图类：

　　1. 让我们重命名它-右击Package Explorer中的View.java。转到Refactor->Rename，输入新名为ExplorerView并且点击Preview。在随后弹出的面板上，你会看到Perspective类被重构-使用ExplorerView.ID来代替View.ID(见图6)。点击OK。

字串8

字串2

图6.为ExplorerView重构View类 字串7

　　2. 遗憾的是，Eclipse的重构能力有点弱-特别与IntelliJ作比较的话。对于象这样的重构来说，IntelliJ将不仅按期望对类加以改变，而且它会把重构应用于你的.xml文件！这是非常有用的特征，特别是在一种Spring/Hibernate/XML配置操作比例极大的情况下。 字串8

　　你必须手工地更新对plugin.xml的重构。打开plugin.xml，并且点击plugin.xml选项卡。找到相应于View的扩展，并且作如下更新： 字串1

　　name="ExplorerView"
　　class="eclipseTradeClient.ExplorerView"
　　id="EclipseTradeClient.explorerView"> 字串9

　　此后，进行保存（见图7）。

图7.进一步重构-手工更新Plugin.XML 字串2

　　3. 对于这种简单的重构，情况就是这样，对吗？是的；但遗憾的是，你还没有结束。打开类ExplorerView，改变静态变量ID-把它初始化为EclipseTradeClient.explorerView。这相应于你刚才在plugin.xml中设置的ID。 字串9

　　4. 最后，你完成重构。现在，让我们测试一下是否一切改动正常。切换回编辑器中的plugin.xml，并且点击"Overview"选项卡。点击"Launch an Eclipse application"，这应该导致如图8所示结果。 字串6

图8.启动Eclipse Trade Client程序 字串8

　　5. 现在让我们改变结点的名字。打开类ExplorerView。找到内部类ViewContentProvider，并且改变方法"Object getElements(Object parent)"，让其返回一个字符串数组（｛"Watch List"，"Order History"｝）。

字串6

　　三. 把Spring Remoting添加到你的应用程序 字串4

　　下面，我们把Spring添加到你的Eclipse丰富的客户端以便它向前一篇文章中的StockTradeServer工程发出请求。 字串7

　　首先，当开发Eclipse插件/RCP应用程序时，添加第三方库的推荐的方法是通过另外一个插件。这样做以后，你就不需要把这些第三方jars添加到你创建的每个工程。而是，你仅建立你的插件/RCP工程和第三方库工程之间的某种依赖性。首先，我们假定你熟悉Eclipse的classloader。要点是，你必须采取一些额外的步骤来确保你的类在插件依赖性之间能够彼此找到对方： 字串7

　　1. 在Eclipse中创建一个新的插件工程。并命名这个新工程为SpringClient。然后，设置如下值：

字串5

　　ID = SpringClient
　　Class = springClient.SpringClientPlugin

　　在填充Plug-in属性后，点击Finish。对于SpringClient插件工程，你不需要任何模板，因为其主要目的是存储Spring库和任何Spring相关的服务类。 字串6

　　2. 在你的解压的spring-framework-1.2.8发行包中，你会找到下列jar文件： 字串1

　　?spring-aop.jar-在文件夹dist下

字串9

　　?spring-beans.jar-在文件夹dist下 字串9

　　?spring-context.jar-在文件夹dist下 字串7

　　?spring-core.jar-在文件夹dist下

　　?spring-remoting.jar-在文件夹dist下 字串2

　　?commons-logging.jar-在文件夹lib\jakarta-commons下 字串5

　　?log4j-1.2.13.jar-在文件夹lib\log4j下 字串3

　　然后，把它们全部复制到你的SpringClient根目录下。 字串5

　　3. 在Eclipse的包资源管理器中，右击SpringClient以打开工程属性。选择"Java Build Path"，点击"Libraries"选项卡，并且把刚才你通过按钮"Add JARs"添加的所有的那些jar文件加入。请确保你也导入了这些库！点击"Order and Export"选项卡，并且检查所有的库(见图9)。通过这样做，你就可以确保，当你创建对SpringClient的一种工作依赖性时，spring和log jars也是可用的。此后，点击OK。 字串4

图9.输出第三方库 字串1

　　4. 现在，你要修改SpringClient的manifest。在包资源管理器中，展开SpringClient->META-INF并且打开MANIFEST.MF。点击"Runtime"选项卡并且点击Classpath部分的"Add"。全选Spring jars和logging jars并且点击OK。现在，在"Exported Packages"节中，点击Add。选择所有的包以便导出，并点击OK(见图10)。 字串3

字串1

图10.把第三方库添加到插件Classpath并导出包 字串2

　　我以前提及过，Eclipse的classloader经常引起问题。为了补救这一点，你可以点击MANIFEST.MF选项卡并且添加下面一行：

字串3

　　Eclipse-BuddyPolicy: registered

字串5

　　5. 现在，让我们添加spring配置文件。在Package Explorer中，转到src目录，创建一个新文件applicationContext.xml，并且加入下列内容： 字串8

字串9

　　在src目录下，另外创建一个新文件beanRefFactory.xml并且加入下列内容： 字串4

字串6

　　不必感到惊讶，这些配置文件与你对stocktradeserver工程进行单元测试时使用的spring配置文件是相同的，除了你重命名了applicationContext.xml以外。

字串5

　　6. 为了简化问题，你可以把类从stocktradeserver工程复制到SpringClient的src目录下。在SpringClient的src目录下面，创建包stephenlum.services.stock和stephenlum.services.stock.dto。 字串4

　　如果你还没有准备好，你可以下载本文源码或参考我的前一篇文章并且复制stephenlum.services.stock下的类StockService.java。然后，复制在stephenlum.services.stock.dto下的类StockDTO.java(见图11)。 字串1

图11.完成上面操作后的Package Explorer看上去的样子

字串6

　　7. 把代码添加到类SpringClientPlugin以装载Spring的应用程序上下文。注意，你要把该代码添加到构造器中。下面是新的SpringClientPlugin类： 字串3

package springClient;
import org.eclipse.jface.resource.ImageDescriptor;
import org.eclipse.ui.plugin.AbstractUIPlugin;
import org.osgi.framework.BundleContext;
import org.springframework.beans.factory.BeanFactory;
import org.springframework.beans.factory.access.BeanFactoryLocator;
import org.springframework.beans.factory.access.BeanFactoryReference;
import org.springframework.beans.factory.access.SingletonBeanFactoryLocator;
/**
*应用于桌面的主插件类。
*/
public class SpringClientPlugin extends AbstractUIPlugin {
　private BeanFactory beanFactory;
　//共享实例.
　private static SpringClientPlugin plugin;
　/**
　*构造器.
　*/
　public SpringClientPlugin() {
　　plugin = this;

　　BeanFactoryLocator beanFactoryLocator = SingletonBeanFactoryLocator.getInstance();
　　BeanFactoryReference beanFactoryReference = beanFactoryLocator.useBeanFactory("ctx");
　　beanFactory = beanFactoryReference.getFactory();
　}
　/**
　*在插件激活时调用这个方法
　*/
　public void start(BundleContext context) throws Exception {
　　super.start(context);
　}
　/**
　*当停止插件时，调用这个方法
　*/
　public void stop(BundleContext context) throws Exception {
　　super.stop(context);
　　plugin = null;
　}
　/**
　*返回共享实例.
　*/
　public static SpringClientPlugin getDefault() {
　　return plugin;
　} 字串7
　/**
　*返回在给定的插件相对路径下的图像文件的一个图像描述符
　* @param path-路径
　* @返回图像描述符
　*/
　public static ImageDescriptor getImageDescriptor(String path) {
　　return AbstractUIPlugin.imageDescriptorFromPlugin("SpringClient"， path);
　}
　public BeanFactory getBeanFactory() {
　　return beanFactory;
　}
}

　　8. 最后，添加依赖性以实现工程EclipseTradeClient依赖于你的新插件工程SpringClient。在工程EclipseTradeClient中，打开plugin.xml并且点击"Dependencies"选项卡。在"Required Plug-ins"节中，点击Add，选择"SpringClient(1.0.0)"，并且点击OK(见图12)。

字串4

图12.把SpringClient添加为一个要求的插件 字串3

　　现在，你必须在EclipseTradeClient manifest文件中添加与Eclipse的伙伴策略相关的内容。在文件plugin.xml中，点击MANIFEST.MF选项卡并且添加下列入口：

字串7

　　Eclipse-RegisterBuddy: SpringClient 字串6

　　四. 创建一个新的WatchListView

　　现在，你可以开始创建你自己的视图类了。首先，你要创建一个WatchListView，它将向应用程序服务器的StockDataService发出一个请求： 字串5

　　1. 在plugin.xml中，转到extensions选项卡。

　　2. 在All Extensions树中选择org.eclipse.ui.views，然后点击Add。

字串3

　　3. 随后出现一个新的对话框窗口。在Extension Points树中滚动并且选择org.eclipse.ui.views。在相应于org.eclipse.ui.views的可用模板中，选择SampleView，然后点击Next(见图13)。 字串1

图13.新的扩展对话框

字串4

　　4. 在"Main View Settings"窗口中，填写如下内容： 字串3

Java Package Name = eclipseTradeClient.views.watchlist
View Class Name = WatchListView
View Name = Watch List View
View Category ID = EclipseTradeClient
View Category Name = WatchList Category 字串1

　　让"Table Viewer"保持选择状态并且点选"Add the view to the resource perspective checked"(见图14)。点击Next。 字串4

字串8

图14.针对于Watch List视图设置"Main View Settings" 字串4

　　5. 在"View Features"下，保持默认设置并且点击Finish。 字串7

　　6. 现在，你会在plugin.xml的"All Extensions"选项卡中看到新的"View and Category"。 字串2

　　7. 现在，你可以开始编写你的Watch List视图了。这个观察列表是一个表格，因此首先要为此表实现接口ITableLabelProvider。在包eclipseTradeClient.views.watchlist下创建一个新类WatchListTableLabelProvider。你可以把一个ITableLabelProvider当作是JFace的等价物-Swing中的TableCellRenderer。下面是WatchListTableLabelProvider的代码部分： 字串2

package eclipseTradeClient.views.watchlist;
import java.text.NumberFormat;
import org.eclipse.jface.viewers.ITableLabelProvider;
import org.eclipse.jface.viewers.LabelProvider;
import org.eclipse.swt.graphics.Image;
import stephenlum.services.stock.dto.StockDTO;
public class WatchListTableLabelProvider extends LabelProvider implements
ITableLabelProvider {
　private static NumberFormat numberFormat = NumberFormat.getInstance();
　public Image getColumnImage(Object element， int columnIndex) {
　　return null;
　}
　public String getColumnText(Object element， int columnIndex) {
　　if (element != null) {
　　　switch (columnIndex) {
　　　　case 0:
　　　　　return ((StockDTO) element).getTickerSymbol();

字串1

　　　　case 1:
　　　　　return ((StockDTO) element).getLastTrade().toString();
　　　　case 2:
　　　　　return numberFormat.format(((StockDTO) element).getVolume());
　　　　case 3:
　　　　　return ((StockDTO) element).getDaysRange();
　　　　case 4:
　　　　　return numberFormat.format(((StockDTO) element).getAvgVol());
　　　　case 5:
　　　　　return ((StockDTO) element).getDaysRange();
　　　　case 6:
　　　　　return ((StockDTO) element).getFiftyTwoWeekRange();
　　　　case 7:
　　　　　return ((StockDTO) element).getMarketCap();
　　　}
　　}
　　return "";
　}
}

　　8. 最后，你把你的WatchListView添加到Perspective类。在Package Explorer中打开类Perspective并且作如下修改以便WatchListView将出现于该页面的底部： 字串9

package eclipseTradeClient;
import org.eclipse.ui.IPageLayout;
import org.eclipse.ui.IPerspectiveFactory;
import org.eclipse.ui.IFolderLayout;
import eclipseTradeClient.views.WatchListView;
public class Perspective implements IPerspectiveFactory {
　public void createInitialLayout(IPageLayout layout) {
　　String editorArea = layout.getEditorArea();
　　layout.setEditorAreaVisible(false);
　　layout.setFixed(false);
　　layout.addStandaloneView(ExplorerView.ID，
　　　　false，
　　　　IPageLayout.LEFT，
　　　　0.25f，
　　　　editorArea);
　　IFolderLayout topLeft = layout.createFolder("TOP"，
　　　　IPageLayout.TOP，
　　　　0.50f，
　　　　editorArea);

　　layout.addView(WatchListView.ID，IPageLayout.BOTTOM， 0.25f，editorArea);
　}
} 字串7

　　9. 现在，你可以在类WatchListView中进行添加。我尽量保持模板生成的代码不动以便于你可以自由地添加你的代码。实质上，你是在添加一个表格-它将显示包含在一个类StockDTO实例中的所有信息。因此，表格中的列也是基于StockDTO的成员。我已经重命名了两个生成的Action-现在action1能够从stocktradeserver中取回股票的列表并且在表格中显示它们，而action2从表格中删除所有元素（请参考源码中的列表1.eclipseTradeClient.views.watchlist）。 字串9

　　五. 运行应用程序 字串1

　　现在，你可以运行你的应用程序了。如果还没有准备好的话，你可以把stocktradeserver工程按如下步骤导入到Eclipse：

　　1. 在Eclipse中，点击工具栏按钮"Deploy MyEclipse J2EE project to Server"(见图15)。 字串2

字串6

图15.发布MyEclipse J2EE服务器按钮 字串6

　　确保在列表下的工程是stocktradeserver。点击Add，选择Tomcat 5作为你的服务器，并且点击Finish。当你看到一条消息"Successfully deployed"时，点击OK(见图16)。 字串8

图16.StockTradeServer被成功发布 字串7

　　现在，启动Tomcat服务器(见图17)。Tomcat应该会成功地启动。

字串3

字串2

图17.通过MyEclipse插件启动Tomcat

字串3

　　2. 启动"Eclipse Rich Client"。打开EclipseTradeClient's plugin.xml文件，点击"Overview"选项卡，并且点击"Launch an Eclipse application"。当应用程序启动时，按下图18中的红色按钮以得到一个股票列表。这一行为将使用Spring HttpInvoker从应用程序服务器取回股票列表。你可以按下红色圆圈右边的按钮来清除股票列表(见图18)。 字串2

字串4

图18.EclipseTradeClient成功运行 字串5

　　一切顺利！你已经成功构建了一个小型的Eclipse丰富的客户端程序并且使用Spring remoting技术把它连接到一个应用程序服务器上。

字串3

　　六. 小结 字串9

　　总之，基于Eclipse RCP构建你的胖客户端程序将会大大减少构建这种程序的GUI框架所需的繁重代码。另外，通过把Spring remoting用作客户端/服务器通讯机制还允许你轻松地实现协议的切换，同时还提供其它所有在服务器端的Spring优点。 字串5