Rich Ajax Platform，第 1 部分: 简介 (转摘)

Rich Ajax Platform，第 1 部分: 简介

基于 Eclipse 开发模式的 Web 2.0

文档选项

打印本页

将此页作为电子邮件发送

样例代码

级别： 中级

Chris Aniszczyk ([e-mail]), 软件工程师, IBM　
Benjamin Muskalla ([e-mail]), 软件工程师, Innoopract Informationssysteme GmbH

2007 年 12 月 03 日

作为一种使基于 Web 的应用程序更加生动的方法，Asynchronous JavaScript + XML (Ajax) 和 Web 2.0 的概念已经在开发社区中广泛应用。富 Ajax 平台 (RAP) 是一种使用 Eclipse 开发模型来构建启用 Ajax 的 Web 应用的方式。本文将介绍 RAP，说明如何设置 RAP 开发环境，提供一些演示以及一些易于理解的示例。

RAP 项目旨在使开发人员能够使用 Eclipse 开发模型构建富 Internet 应用程序。“Eclipse 开发模型” 的确切含义是什么？RAP 允许开发人员使用丰富的 Java™ 库和 Eclipse API 构建基于浏览器的 Ajax 应用程序。它通过提供 SWT、JFace 和 Eclipse Workbench 的基于 Web 的实现来提供此项功能。本文的目的在于通过一些简单示例介绍 RAP。

请访问 Ajax 技术资源中心，这是有关 Ajax 编程模型信息的一站式中心，包括很多文档、教程、论坛、blog、wiki 和新闻。任何 Ajax 的新信息都能在这里找到。 订阅 Ajax 相关文章和教程的 RSS 提要

设置两个步骤

RAP 的设置非常简单，只需要执行两个步骤：下载 RAP 并配置 Eclipse 以使用 RAP。

第 1 步：下载 RAP

从 Eclipse.org 获得 RAP。建议您获取最新的稳定里程碑版本。对于本文，我们使用的是 1.0 发行版。下载了包含 RAP 目标平台的归档文件后，将其解压缩到所选目录中（参见图 1）。此目录十分重要，因为这将是您在下一步中设置目标平台时使用的目录。

图 1. RAP 目标

第 2 步：设置目标平台

Eclipse Plug-in Development Environment (PDE) 将使用目标平台的概念。目标平台只是由一组表示待开发内容（也就是目标）的插件组成的。默认情况下，目标平台被设为针对当前运行的 Eclipse 实例。这意味着当前开发的插件应当运行在当前运行的实例中。目标平台的灵活之处在于它可以被更改。例如，您可以将目标平台设为针对 Eclipse V3.2 安装或者甚至其他产品的运行时（这种技巧使您不管开发什么内容都可以使用最新的 Eclipse）。

在本例中，我们以 RAP 平台为目标，因为我们要针对它进行开发。为此，需要将目标平台首选项 (Window > Preferences... > Plug-in Development > Target Platform) 设为第 1 步中 RAP 插件的解压缩目录（参见图 2）。

图 2. 将 RAP 设为目标平台

现在您已经正确设置了目标平台，可以开发 RAP 应用程序了。但是在开始查看代码之前，让我们先来看一个简单演示，了解 RAP 可以做什么并熟悉如何启动基于 RAP 的应用程序。

RAP 与 Google Web Toolkit 的比较
Google Web Toolkit (GWT) 和 RAP 的相似之处在于它们都允许使用 Java 来编写富 Internet 应用程序的代码。最大的差别在于 GWT 运行在客户机上，而 RAP 主要运行在服务器上。由于 RAP 运行在服务器上，因此允许您访问丰富的 Java API 并允许通过 OSGi 使用著名的 Eclipse 插件模型。另一种思路是用 Eclipse 术语考虑两者的差别：GWT 类似一个独立的 SWT 应用程序（即，只是一个小部件工具包），而 RAP 为 Web 应用程序启用了一种 RCP 样式的方法。



回页首

演示

体验 RAP 的第一步是查看一个演示。要与 RAP 交互，需要创建一个启动配置来启动 RAP。为此，需要打开 Run 对话框 (Run > Open Run Dialog...) 并创建一个新的 OSGi 框架启动配置。完成后，需要确保这些 VM 参数已设置：-Dorg.osgi.service.http.port=8000 -Dosgi.noShutdown=true（参见图 3）。这些参数将使 RAP 可以在端口 8000 上启动并阻止 Eclipse 在 RAP 启动后立即关闭。

图 3. RAP 启动配置

最后，可以启动浏览器并指向 http://localhost:8000/rap?startup=controls 来查看控件演示（参见图 4）。该演示基于 SWT Examples 集合中著名的 ControlExample。

图 4. RAP 控件演示






回页首

示例应用程序

我们将查看两个示例，它们都是基于 PDE 所提供的一些 Rich Client Platform (RCP) 模板。

Hello World 示例

传统的编程示例通常都是 Hello World 示例。我们首先将说明运行简单 RAP 应用程序的方法。

图 5. RAP 版 Hello World

RAP 版与 RCP 版的主要差别在于插件依赖性和应用程序入口点。如果查看插件清单（参见清单 1），我们可以看到具有不同的依赖性。

清单 1. RAP Hello World 依赖性 (MANIFEST.MF)

                Manifest-Version: 1.0Bundle-ManifestVersion: 2Bundle-Name: Helloworld Plug-inBundle-SymbolicName: rap.helloworld; singleton:=trueBundle-Version: 1.0.0Bundle-Activator: rap.helloworld.ActivatorRequire-Bundle: org.eclipse.rap.uiEclipse-LazyStart: true

注意到对 org.eclipse.rap.ui 的依赖性了么？那是类似于 RCP 库中的标准 org.eclipse.ui 插件的 RAP 插件。如果熟悉 OSGi 和 Import-Package 文件头，则根本无需依赖于特定的插件；您可以只依赖需要的包。这十分重要，因为您可以用一种既能在 RAP 中工作又能在 RCP 中工作的方法来构造代码。例如，如果查看 RAP（参见清单 2）和 RCP（参见清单 3）中的工作区顾问程序 (workbench advisor) 代码，则会看到相似的代码和导入包。

清单 2. RCP 工作区顾问程序

                import org.eclipse.swt.graphics.Point;import org.eclipse.ui.application.ActionBarAdvisor;import org.eclipse.ui.application.IActionBarConfigurer;import org.eclipse.ui.application.IWorkbenchWindowConfigurer;import org.eclipse.ui.application.WorkbenchWindowAdvisor;public class ApplicationWorkbenchWindowAdvisor extends WorkbenchWindowAdvisor {    public ApplicationWorkbenchWindowAdvisor(IWorkbenchWindowConfigurer configurer) {        super(configurer);    }    public ActionBarAdvisor createActionBarAdvisor(IActionBarConfigurer configurer) {        return new ApplicationActionBarAdvisor(configurer);    }        public void preWindowOpen() {        IWorkbenchWindowConfigurer configurer = getWindowConfigurer();        configurer.setInitialSize(new Point(400, 300));        configurer.setShowCoolBar(false);        configurer.setShowStatusLine(false);        configurer.setTitle("Hello RCP");    }}    

清单 3. RAP 工作区顾问程序

                import org.eclipse.swt.graphics.Point;import org.eclipse.ui.application.ActionBarAdvisor;import org.eclipse.ui.application.IActionBarConfigurer;import org.eclipse.ui.application.IWorkbenchWindowConfigurer;import org.eclipse.ui.application.WorkbenchWindowAdvisor;public class ApplicationWorkbenchWindowAdvisor extends WorkbenchWindowAdvisor {    public ApplicationWorkbenchWindowAdvisor(IWorkbenchWindowConfigurer configurer) {        super(configurer);    }    public ActionBarAdvisor createActionBarAdvisor(IActionBarConfigurer configurer) {        return new ApplicationActionBarAdvisor(configurer);    }        public void preWindowOpen() {        IWorkbenchWindowConfigurer configurer = getWindowConfigurer();        configurer.setInitialSize(new Point(400, 300));        configurer.setShowCoolBar(false);        configurer.setShowStatusLine(false);        configurer.setTitle("Hello RAP");    }}    

RAP 与 RCP 应用程序之间的另一个主要差别是入口点（类似于 Java 语言中的 main(String[] args) 方法）。在 RCP 中，我们有用于定义 IApplication（注意，对于早于 Eclipse V3.3 的版本，此接口被称为 IPlatformRunnable）的 org.eclipse.core.runtime.applications 扩展点。RAP 中与 RCP 应用程序等效的是 org.eclipse.rap.ui.entrypoint 扩展点，该扩展点将定义 IEntryPoint。如果查看 RCP 上下文（参见清单 4）和 RAP 上下文（参见清单 5）中的典型入口点代码，您会发现存在相似之处。在两个例子中，我们都将创建一个视图和工作区以运行工作区顾问程序。

清单 4. RCP 应用程序入口点 (org.eclipse.core.runtime.applications)

                public class Application implements IApplication {public Object start(IApplicationContext context) throws Exception {Display display = PlatformUI.createDisplay();try {int returnCode = PlatformUI.createAndRunWorkbench(display, new ApplicationWorkbenchAdvisor());if (returnCode == PlatformUI.RETURN_RESTART)return IApplication.EXIT_RESTART;elsereturn IApplication.EXIT_OK;} finally {display.dispose();}}public void stop() {final IWorkbench workbench = PlatformUI.getWorkbench();if (workbench == null)return;final Display display = workbench.getDisplay();display.syncExec(new Runnable() {public void run() {if (!display.isDisposed())workbench.close();}});}    

清单 5. RAP 应用程序入口点 (org.eclipse.rap.ui.entrypoint)

                public class Application implements IEntryPoint {public Display createUI() {Display display = PlatformUI.createDisplay();PlatformUI.createAndRunWorkbench( display, new ApplicationWorkbenchAdvisor() );return display;}}

RCP 邮件示例

著名的 RCP 邮件 示例（参见图 6）在经过少量更改后能够在 RAP 环境内运行（参见图 7）。此示例表明视图、透视图、编辑器等工作区概念可以在 RAP 中使用（有关概念映射，请参见表 1）。您可以获得邮件示例和先前示例的 源代码 进行修改。

表 1. 比较 RAP 与 RCP
RAP RCP OSGi（服务器端） OSGi Standard Widget Toolkit (SWT) RAP Widget Toolkit (RWT) JFace JFace 工作区 Web 工作区

图 6. RCP 邮件示例



图 7. RAP 邮件示例






回页首

结束语

本文通过几个简单的示例和演示介绍了 RAP。RAP 允许在 Eclipse 中重用您现有的技能并创建富 Internet 应用程序。RAP 还使您可以用能够在台式机 (RCP) 和浏览器 (RAP) 之间重用的方法构造代码。实质上，RAP 现在将把 Eclipse 引入到浏览器和 Web 2.0 阵营中。

回页首

下载

描述 名字 大小 下载方法 样例代码 os-eclipse-richajax.zip 52KB HTTP 关于下载方法的信息

参考资料

学习

• 您可以参阅本文在 developerWorks 全球站点上的 英文原文。
  
  
• 在 Eclipse.org 查阅关于富 Ajax 平台 (RAP) 的更多信息。
  
  
• 查阅 RAP 维基 了解新功能和高级用例。
  
  
• 查阅 “Eclipse 推荐读物列表”。
  
  
• 浏览 developerWorks 上的全部 Eclipse 文章和Eclipse 教程。
  
  
• 您是 Eclipse 新用户？阅读 developerWorks 文章 “Eclipse 平台入门” 以了解它的起源和架构，以及如何用插件扩展 Eclipse。
  
  
• 查阅 IBM developerWorks 的 Eclipse 项目资源 扩展 Eclipse 技巧。
  
  
• 收听针对软件开发人员的有趣访谈和讨论，一定要访问 developerWorks podcast。
  
  
• 要获得关于 Eclipse 平台的介绍性文章，请参阅 “Eclipse 平台入门”。
  
  
• 随时关注 developerWorks 的 技术事件和网络广播。
  
  
• 查看免费的 developerWorks On demand demo 观看并了解 IBM 及开源技术和产品功能。
  
  
• 查阅最近将在全球举办的面向 IBM 开放源码开发人员的研讨会、交易展览、网络广播和其他 活动。
  
  
• 访问 developerWorks 开放源码专区，获得丰富的 how-to 信息、工具和项目更新，帮助您用开放源码技术进行开发，并与 IBM 产品结合使用。
  
  

获得产品和技术

• 在 IBM alphaWorks 中查阅最新的 Eclipse 技术下载。
  
  
• 从 Eclipse Foundation 下载 Eclipse Platform 和其他项目。
  
  
• 下载 IBM 产品评估版本，并开始使用 DB2®、Lotus®、Rational®、Tivoli® 和 WebSphere® 的应用程序开发工具和中间件产品。
  
  
• 使用 IBM 试用软件 改进您的下一个开发项目，这些软件可以通过下载或从 DVD 中获得。

讨论

• Eclipse Platform 新闻组 应当是讨论关于 Eclipse 的问题的第一站（选择此链接将启动默认的 Usenet 新闻阅读器应用程序并打开 eclipse.platform）。
  
  
• Eclipse 新闻组 中有很多参考资料适用于对使用和扩展 Eclipse 感兴趣的人员。
  
  
• 参与 developerWorks blog 并加入 developerWorks 社区。
  
  

作者简介

Chris Aniszczyk 是 IBM Lotus 的软件工程师，专门从事 OSGi 相关开发工作。他是开放源码的忠实拥护者，目前在开发 Gentoo Linux 发行版，他还是一些 Eclipse 项目（PDE、ECF、EMFT）的参与者。他十分 乐意与您讨论 关于开放源码和 Eclipse 方面的问题。

Benjamin Muskalla 在位于卡尔斯鲁厄的 Innoopract Informationssysteme 中担任软件开发人员兼顾问。他是富 Ajax 平台 (RAP) 项目的提交者，主要负责工作区实现。他也是 Eclipse Platform