使用Eclipse 富客户端平台和Rational Application Developer V6创建EJB 客户端（一）
引言
最近几年来，作为编写交互式开发环境（IDE）工具的框架 —— Eclipse 平台的流行程度显著增长。关于 Eclipse 3.0 版本，同样的技术已经扩展为支持富客户端的开发，给予 Java™ 开发者使用有自身感观的可扩展平台编写富客户端代码的能力。
开发富客户端的平台通称 Eclipse Rich Client Platform. （RCP）。为什么着重强调富客户端呢？在 n-tiered 体系结构的这几年来，很明显开发给予终端用户丰富的使用浏览器方面经验的应用程序比较困难。基于浏览器的应用程序常常设法通过将 JavaScript. 与 HTML 结合起来模拟某种可用性。然而，很明显对于应用程序来说，寻求更丰富的经验比使用更丰富的客户端技术平台要好。同样，Eclipse RCP 给予了开发者创建可扩展客户端应用程序的能力，并且这些可扩展客户端应用程序仍然可以加入到 n-tiered 体系结构中。Eclipse RCP 启用了下一代富客户端，并且是富客户端平台（例如 IBM Workplace Client 技术）的基础。
IBM Rational Application Developer V6 （以前是 IBM WebSphere® Studio Application Developer）是基于 Eclipse 3.0 平台的。这个版本使 J2EE 开发者可以创建与 J2EE 应用程序进行交互的富客户端应用程序。在这篇文章中，我们将使用 Rational Application Developer（以下称之为 Application Developer）中的 Eclipse 3.0 功能构建 Eclipse RCP 客户端，它们调用了配置于 Application Developer 的 WebSphere Application Server 测试环境中的 EJB 组件。
为了构建 Eclipse RCP 应用程序，它调用了运行于 WebSphere Application Server V6 内部的企业 bean，我们将会遵循的一般步骤包括：
安装适合于 WebSphere Application Server 的 IBM Application Client。当向工作站部署 Java 客户端时，您需要使用 WebSphere 客户软件恰当地与运行在 WebSphere Application Server 中的远程 enterprise bean 进行交互。我们在这一步演示配置的过程。
使用 Application Developer 中的 J2EE™ 透视图在 WebSphere Application Server 中部署温度转换器 EJB 应用，它包括了 WebSphere Application Server 完整功能版来测试您的应用程序。通过 Application Developer，您可以与缺省的 WebSphere Application Server 实例进行通信，调出管理控制台并且部署应用程序（您将无需为了这一演示将 Enterprise Archive（EAR）导入您的工作区）。（为了方便起见我们使用 Application Developer；如果您正在使用单独的 WebSphere Application Server，步骤是相同的）
使用 Eclipse 插件开发环境构建 RCP 客户端。我们将会配置 Eclipse 插件启动器来与 WebSphere Application Server Java 瘦客户端进行交互，它仅仅是带服务器扩展的 IBM JDK，需要与 WebSphere Application Server 进行通信。我们在整个 J2EE Application Client Container 中选择这样做是因为它提供了更为简易的配置。
导出 RCP 应用程序并且作为独立应用程序来运行。您需要了解如何配置您的插件相关性和 JRE 才能使用 WebSphere Application Server 瘦客户端。
为了进行这个练习，您需要：
Rational Application Developer V6 (或 Eclipse 3)
WebSphere Application Server V6 （通过一些略微的改变，您也可以使用 Eclipse 3 和 WebSphere Application Server V5）
适合于 WebSphere Application Server 的 IBM Application Client（已包括 WebSphere Application Server V6 在内）
包括在本文之内的 下载文件 。这些指令假设将下载文件解压缩到 C:/ 的根目录下。
设置 J2EE 应用程序
首先我们需要做的是安装适合于 WebSphere Application Server 的 IBM Application Client，它已经包括在 WebSphere Application Server V6（如果您没有客户端，您可以将您的配置改变为针对 Application Developer 测试环境中的服务器 JDK）中，并且接下来将应用程序部署到正在运行的 WebSphere Application Server：
J2EE 应用程序客户端是通过使用安装向导界面来安装的。在运行您的 WebSphere 安装的开始界面之后，选择 IBM Client for IBM WebSphere Application Server。
跟随向导，我们将其安装到 C:/WebSphere6ND/AppClient directory 上。下载 ZIP 文件中的 Windows® 批处理（BAT）文件使用了这个类路径；如果您选择了另一个目录，您就必须修改批处理文件转而引用新的目录。图 1 展示了向导的第三个界面您所选择的目录。
图 1. 安装向导
我们同样选择了典型安装，并且输入了 localhost 作为主机名，如图 2 所示。
图 2. 安装向导
接下来我们将会使用 Application Developer 把 EAR 部署到 WebSphere Application Server。（这完全是为了便于构建及测试源于同一工作区的插件；您同样可以只是在独立的 WebSphere Application Server 实例中配置应用程序，随着与它进行对话的已配置的 Eclipse。）
使用 Start 菜单打开 Application Developer 以及找到到正如 C:/RCPEJBClient/workspace 的工作区，（图 3）。
图 3. 工作区启动器
关闭默认的 Welcome 页面（图 4）。
图 4. Rational SDP Welcome 页面
如果您无法在那里缺省地找到自己，就切换到 Switch to the J2EE 透视图 。
在底部的框中寻找 Servers 视图并且右键单击 WebSphere Application Server v6.0 （图 5）。在这一点上，Application Developer 将会检验 WebSphere Application Server 的缺省实例是否正在运行。
图 5. Servers 选项卡
状态应该恢复到 "Stopped"。右键单击服务器并且选择 Start （图 6）。（您同样可以通过寻找 /runtimes/profiles/default/bin 启动服务器以及执行 startserver server1）。
图 6. 启动服务器
当启动了服务器，您就能够通过右键单击服务器及选择 Run administrative console （或打开浏览器并且访问 http://localhost:9060/admin）运行管理控制台，如图 7 中所示。
图 7. 运行管理控制台
以任意用户标识登陆（图 8）。
图 8. 运行管理控制台
展开 Applications 节并且选择 Install New Application （图 9）。
图 9. 安装新的应用程序
找到 C:/RCPEJBClient，选择 TemperatureEAR.ear 并且接下来选择 Next （图 10）。TemeratureEAR 应用程序是将温度由摄氏温度转换成华氏温度的简单方法（尽管可能不是很精确）。
图 10. 安装新的应用程序
在绑定页面中（图 11），保留缺省值并且选择 Next。
图 11. 安装新的应用程序
在下一个页面中，应用程序开发流程的第一步，选择 Deploy enterprise beans 然后接下来进入 Step 7 Summary （图 12）。
图 12. 安装新的应用程序
在第七步的对话框中，选择 Finish （图 13）。安装需要一分钟或两分钟（图 14）。
图 13. 安装新的应用程序
Figure 14. 安装新应用程序的消息
当安装结束时，选择 Save to Master Configuration （图 15）。
图 15. 保存到主配置库
在保存的对话框中，选择 Save （图 16）。
图 16. 保存到主配置库
现在，我们将会启动应用程序。从 Applications 菜单中，选择Enterprise Applications （图 17）。
Figure 17. 企业应用程序
选择 TemperatureEAR 然后接下来选择 Start （图 18）。
Figure 18. 企业应用程序
状态栏中的相应图标应该表明了已经启动了应用程序（图 19）。
图 19. 企业应用程序
管理控制台的注销（图 20）。
图 20. 管理控制台的注销
创建 RCP 客户端
我们现在已经为创建 RCP 客户端应用程序做好了准备，我们将会通过使用 Plug-in 向导将其用作简单的插件。当创建 RCP 应用程序时，随着对复用性的关注您应该常常创建若干插件。例如，您可以重写该实例来创建关于 J2EE 相关性的单点插件，另一种视图组件，以及 RCP Shell 的一种。这样使得不同的插件可以重用，例如，J2EE 代码。然而，我们将只能拥有这一运用的唯一插件，从根本上限制了这篇文章的作用域。
创建插件项目
为了在 Application Developer 中创建插件项目，从 J2EE Perspective 中选择File => New => Other （图 21）。
图 21. 创建新的插件项目
在 New Project 向导中，查明选择了 Show All Wizards 。扩展 Plug-in Development 然后选择 Plug-in Project （图 22）。
图 22. New Project 向导
在这一点上，为了插件的发展您也许会获得启用插件的提示（图 23）。如果是这样的话，选择 OK。
图 23. 确认插件的启动
在 Create a new plug-in project 的对话框中（图 24），命名该项目：com.ibm.issw.temperature.form。这是一种很普通的插件命名约定。确定您选择的选项如图 24 所示：
因为您正在添加 Java 代码所以您的插件项目将也会是 Java 项目。
在 Eclipse 3.0 中，您希望使用清单文件设置您的运行时相关性，我们选择使用清单文件。
选择 Next。
图 24. 创建新的插件项目
在下一个对话框中，如图 25 所示植入插件数据，接下来选择 Next。
图 25. 创建新的插件项目
我们将会使用模板构建插件。以后我们将会构建关于视图的插件，选择 Plug-in with a view 然后接下来选择 Next （图 26）。
图 26. 创建新的插件项目
在下一个对话框中，我们将会定义关于 View 类的信息。完全按照图 27 所示输入信息，接下来选择 Next。
图 27. 调整视图设置
最后，在 View Features 对话框中（图 28），撤销对所有功能的选择。（我们将会导入我们自己的视图类。）选择 Finish。
图 28. 调整视图设置
档要求我们切换至 Plug-in Development Perspective 的时候（图 29），选择 Yes。
图 29. 确认 Perspective 切换
导入 J2EE JAR 和 EJB client JAR
现在我们将会把两个 JAR 导入我们的新插件中：
j2ee.jar —— 插件与 EJB 客户端 API 进行交互，并且因此在您的类路径中您需要 j2ee.jar。
EJB client JAR —— 包含了所需的客户端接口以及生成了代理服务器和恰当连接运行 enterprise beans 的分支线。
在 Application Developer 中，右键单击插件项目并且选择 Import （图 30）。
图 30. 导入 JAR
选择 File System然后接下来选择 Next（图 31）。
图 31. 导入 JAR
存在若干个您能够获得 j2ee.jar的地方。因为 RCP 将使用运行时的 IBM Application Client for WebSphere Application Server，所以最好使用 JAR，您可以在 /lib 中找到它，如图 32 所示。确定 j2ee.jar 是唯一的选择。（如果您的插件使用其它的 WebSphere API，例如 WebSphere 程序设计模型扩展，您便会同样需要将其导入。否则，您无需导入其它 WebSphere 运行时 JAR；在运行期间，已生成的 EJB 代理服务器代码以及客户端容器代码装载 WebSphere 瘦客户端类库加载器中的类。）如果您没有安装客户端软件，您就能够从 /runtimes/base_v6/lib or /lib 中获得 j2ee.jar。
图 32. 导入 JAR
接下来，我们需要导入 EJB 客户端 JAR，它是需要远程调用 EJB 的代码的专用 JAR 文件。该文件包括了 EJB 客户端接口和已生成的 RMI/IIOP 代码。（如果您正在构建自己的 EJB 应用程序，您可以在 Application Developer 中通过右键单击您的 EJB 项目并且选择 Create EJB Client Jar 生成客户端 JAR）对于这一运用，download file 中提供了 EJB 客户端 JAR。使用文件系统选项导入 JAR 文件，如前所述，转到 C:/RCPEJBClient然后选择 TemperatureEJBClient.jar。（图 33）
图 33. 导入 JAR
现在我们的插件项目应该包含两个 JAR 文件，如图 34 所示。
Figure 34. 导入的 JAR
现在我们需要设置工作区中构建时和编译时类路径。这将会使得插件代码既在 Eclipse IDE 内部又在自动构建过程中成功地进行编译。构建时类路径信息在插件配置编辑器的 Build Section 中更新。选择 Build 选项卡，如图 35 所示。
图 35. Build 部分
定位到 Binary Build 部分（图 36）并且选择如图所示的 JAR 文件。如果您选择执行插件的二进制构建，JAR 需要包括在 Build 之内。对于这一运用，为了运行 Eclipse RCP 应用程序我们将会手动复制插件。
图 36. Binary Build 部分
至于成功编译的代码，您需要将 JAR 添加到编译时类路径上。您可以通过将 JAR 添加到 Build 部分底部的 Extra Classpath Entries 中完成这一内容（图 37）。这样会更新 Eclipse 中的 Project Build Path。
图 37. Extra Classpath Entries
构建页面的变化更新了 build.properties 文件。您可以通过选择 build.properties 选项卡浏览该文件。
至于您查找 J2EE 和 EJB 客户端运行时代码的插件代码，它需要添加到插件的运行时类路径。通过插件配置编辑器才能够完成，编辑器已默认的方式打开。（如果不是这样，双击 plug-in.xml 打开。）选择 Runtime 选项卡，并且在运行时程序库部分，选择 Add 按钮（图 37）然后添加您刚刚导入的 JAR。
图 38. 添加运行时程序库
运行时对话框更新了插件的 MANIFEST.MF 文件。与 J2EE 应用程序很相似，清单定义了运行时类路径。您可以通过定位到 MANIFEST.MF 选项卡查看清单。
对于沙漠中的旅行者，最可怕的不是眼前无尽的荒漠，而是心中没有绿洲。
