使用 WebSphere Application Server Community Edition Server 的 Eclipse 插件

使用 Eclipse 框架在 Community Edition 上开发、部署和测试应用程序

简介： 使用 IBM® WebSphere® Application Server Community EditionV1.0.1.1 的 Eclipse 插件，开发人员可以为 Community Edition 服务器开发和部署 J2EE®应用程序，并对其进行调试。本文将逐步说明如何使用 Eclipse 框架将 J2EE 应用程序快速部署到 Community Edition并对其进行测试（从设置环境到部署和调试应用程序）。

标记本文！

发布日期： 2006 年 5 月 23 日
级别： 初级
访问情况 170 次浏览
建议: 0 (添加评论)

引言

IBM WebSphere Application Server Community Edition（以下称为 CommunityEdition）是构建于 Apache Geronimo 之上的 Java™ 2 Platform Enterprise Edition(J2EE) 应用服务器（Apache Geronimo 是 Apache Software Foundation创建的开放源代码应用服务器）。Eclipse 是一个集成开发环境（integrated developmentenvironment，IDE），由开源社区开发，可方便而经济地进行软件开发和部署。Eclipse 插件工具可提供 ApacheGeronimo 与 Web Tools Platform (WTP) 项目间的集成。该工具是基于 Apache Geronimo devtools 子项目构建的。

通过使用 Eclipse 插件，可以执行服务器的基本管理工作，还可以为 Community Edition 服务器开发和部署 J2EE应用程序并进行测试。此外，如果希望开发可移植 J2EE 应用程序，以便方便地部署到任何其他应用服务器，可以使用该插件中包含的 J2EE分析功能。本文和 Tim Francis 的文章 Create, deploy, and debug Apache Geronimo applications 一起，提供了适用于 WebSphere Application Server Community Edition V1.0.1.1 的最新具体信息。

回页首

下载和安装

先决条件

由于 Eclipse 插件工具依赖于 Eclipse 和 Web Tools Platform (WTP)，因此您需要在安装此插件工具前安装以下软件：

• WTP Project V1.0.1 SDK 的必备软件：
• Eclipse V3.1.2 SDK
• The Eclipse Modeling Framework (EMF) V2.1.2 SDK
• The Graphical Editing Framework (GEF) V3.1.1 SDK
• The Java EMF Model (JEM) V1.1.0.1 SDK
• WTP v1.0.1 SDK

如果尚未安装上述任何组件，可以改为下载 WTP All-In-One Bundle，该软件包中包含所有必需的组件。

该插件工具还要求在建议的平台上安装 Community Edition 服务器，并建议安装 32 位 Java 2 StandardEdition (J2SE) SDK；仅有 J2SE Java Runtime Environment (JRE) 并不够。有关Community Edition 和该插件工具的建议平台和 Java 环境，请参阅产品文档（请参见参考资料）。

下载和安装

Eclipse 插件工具可以从产品网站免费下载。要下载的文件是 wasce_eclipse_plugin zip 文件。

在尝试安装该插件工具前，请安装上述所有必备软件。该插件工具的安装较为简单：直接将 wasce_eclipse_plugin zip 文件的内容解压缩到 Eclipse 主目录即可。

回页首

基本服务器管理

请按照以下管理步骤开始使用 Eclipse 插件：

1. 启动 Eclipse：

   1. 要在安装了 Eclipse 插件工具后首次启动该工具，请打开命令提示符，并导航到 eclipse_home 目录，其中 eclipse_home 是您的 Eclipse 安装目录。

   2. 在命令行键入 eclipse -clean，以启动 Eclipse。-clean 选项将确保对新插件工具进行识别。在 Eclipse 的后续启动中并不需要使用此选项。

2. 切换到 J2EE 透视图，该透视图是使用 Eclipse 框架开发 J2EE 应用程序的首选透视图。如果尚未进入 J2EE 透视图，请选择 Windows => Open Perspective => Other...，然后在 Select Perspective 面板选择 J2EE，并单击 OK。

3. 在服务器上执行任何部署或测试活动前，必须定义一个新服务器和服务器运行时，这两个都是 WTP 中的概念：

   • 服务器 是可以将 J2EE 应用程序部署到其上的目标服务器。它包含各种服务器信息，如主机名、端口号、管理员用户名、密码以及服务器类型。

   • 服务器运行时 由类库及其对特定类型和版本的服务器的访问规则。

   要定义新 Community Edition 服务器和服务器运行时，请执行以下步骤：

   1. 在 Eclipse 菜单栏上，选择 File => New => Other, then click Next。

   2. 在 Select a wizard 面板上，选择 Server => Server，然后单击 Next。

   3. 在 New Server 面板上，确保 Server host name 设置为 localhost。对于 Server type，请选择 Apache, Apache Geronimo v1.0 Server。单击 Next。

   4. 在 New Apache Geronimo v1.0 Server Runtime 面板上，指定 JRE 和 Community Edition 服务器安装目录，然后单击 Next。

   5. 对 administrator name、password 和 ports 的值进行相应的更改，然后单击 Finish。

   图 1 显示了 J2EE 透视图中新定义的服务器。

   
   图 1. 新定义的服务器
   
   

4. 启动和停止服务器：

   要使用 Eclipse 框架启动服务器，请执行以下步骤：

   1. 在 J2EE 透视图中，打开 Servers 视图。
   2. 在 Servers 面板上右键单击要启动的服务器。
   3. 在出现的上下文菜单上单击 Start。

   要使用 Eclipse 框架停止服务器，请执行以下操作：

   1. 在 J2EE 透视图中，打开 Servers 视图。
   2. 在 Servers 面板上右键单击要停止的服务器。
   3. 在出现的上下文菜单中单击 Stop。

   除了启动和停止外，还可以右键单击服务器并选择其他操作，如 Delete、Restart、Debug、Publish、Add and Remove Projects 或 Launch Geronimo Console。Eclipse 插件监视服务器的状态，并相应地设置已停止、正在启动和已启动指示器。即使并未使用 Eclipse 启动或停止服务器，或服务器是远程服务器，此信息也是准确的。

回页首

创建和部署第一个程序

产品网站提供的其中一个下载文件，它是包含示例应用程序的 ZIP 文件。借助这些示例学习使用 Community Edition是一种非常好的方法。通过部署这些应用程序中最简单的程序 Hello 示例，可以了解在 Eclipse IDE中创建和部署您自己的应用程序所需了解的基本知识，

1. 从产品下载页下载 wasce_samples zip 文件，并将其解压缩到一个指定位置。

2. 在 samples\wasce 目录中，hello 目录中同时包含了该应用程序的源代码和二进制形式文件。如果导航到 src\webapp，会看到这是一个非常简单的 Web 应用程序。

3. 启动 Eclipse，切换到 J2EE 透视图，并定义一个新服务器和服务器运行时。

4. 启动服务器

5. 导入或创建新 J2EE 项目时，请确保计算机具有 Internet 接入。可能要求您接受 Sun Microsystems™ 许可证，以便 Eclipse 能缓存部署描述符和与项目关联的其他 XML 文件的文档类型定义（document type definition，DTD）和 XML 模式定义（XML schema definition，XSD）。如果没有 Internet 接入，相应进程可能会被挂起或非常缓慢。

6. 将 Hello 应用程序导入 Eclipse IDE：

   1. 在 Eclipse 菜单栏上，单击 File 并选择 Import...。
   2. 在 Import 面板上，选择 WAR file，然后单击 Next。
   3. 在 War Import 面板上，导航到 samples_install\samples\wasce\hello\target\hello-1.0.war，以将其作为 WAR file 的值，其中 samples_install 为示例安装目录。将前面定义的服务器运行时设置为目标运行时。取消选中 add module to an EAR application 并单击 Finish。

   图 2 显示了已导入 Eclipse 中的 Hello 应用程序。Geronimo Web 部署计划 (geronimo-web.xml) 旁边的 G 图标指示该计划可以使用 Geronimo Web 部署计划编辑器进行识别和查看；否则，如果没有此标志，将使用普通文本编辑器对此计划进行查看。开发 J2EE 应用程序时，请确保 Geronimo 部署计划可以使用 Geronimo Web 部署计划编辑器进行识别和查看，以便您的应用程序能部署到 Community Edition 服务器。

   
   图 2. 已导入 Eclipse 中的 Hello 应用程序
   
   

   或者，也可以采用以下步骤创建一个新 Hello 项目：

   1. 在 Eclipse 菜单栏上，选择 File => New => Project...。
   2. 在 New Project 面板上，展开 Web 并选择 Dynamic Web Project。单击 Next。
   3. 在 Dynamic Web Project 面板上指定项目名称，如 Hello。确保 target runtime 的值为前面定义的服务器运行时，并确保取消选中了 Add module to an EAR application。单击 Next。
   4. 由于我们将从 Hello 示例应用程序使用计划，因此请在 Select project facets 面板上取消选中 Geronimo Deployment Plans。单击 Finish。
   5. 将 samples_install\samples\wasce\hello\src\webapp\index.jsp 复制到 workspace\hello\WebContent 目录，其中 samples_install 是示例安装目录，而 workspace 是您的 Eclipse IDE 的当前工作区。
   6. 另外，还要将 samples_install\samples\wasce\hello\src\webapp\WEB-INF\geronimo-web.xml 文件复制到 workspace\hello\WebContent\WEB-INF 目录。
   7. 在 Project Explorer 视图上，导航到 Hello 项目，单击右键，并选择 Refresh，以刷新项目。应该会看到 geronimo-web.xml 和 index.jsp 文件。

7. 将 Hello 项目部署到服务器：

   1. 在 Project Explorer 视图上，右键单击 Hello 项目，并选择 Run As => Run on Server。
   2. 在 Run on server 面板上，使 Choose an existing server 选项保持选中状态并选择前面定义的服务器。如果不希望以后再次询问要使用的服务器，请选中 Set server as project default (do not ask again)。
   3. 单击 Next，以查看工作区中可用项目列表和已部署到该服务器的项目列表。单击 Finish。

   应该看到 http://localhost:8080/hello 已在 Eclipse IDE 内新启动的内部 Web 浏览器中打开。

   
   图 3. Eclipse 中的 Hello 应用程序
   
   

现在已经成功部署并运行了 Hello应用程序。这再简单不过了。如果要部署更为复杂的应用程序（例如，对外部库有依赖关系的应用程序或需要将很多资源引用映射到实际资源的应用程序），可以使用 Geronimo 部署计划编辑器来构建计划。部署计划编辑器仅是最低要求。在某些情况下，您将需要使用 Source 视图来验证部署计划中的其他配置和部署元素。

回页首

调试您的第一个应用程序

可以采用调试状态启动服务器，并添加断点来调试您的应用程序。让我们再次使用 Hello 应用程序作为例子，以说明如何使用 Eclipse 调试您的应用程序。

1. 更新 hello.jsp，在其中添加一个名为 hello 的新字符串（图 4）。

2. 在第 6 行添加一个断点，并保存更改。

3. 以调试状态启动服务器。如果服务器已经在运行，请在 Servers 视图中右键单击服务器，并选择 Restart => Debug。如果服务器已经停止，请在 Servers 视图中右键单击服务器，并选择 Debug。

4. 等待服务器状态更改为 Debugging。

   
   图 4. 已更新的 Hello 应用程序
   
   

5. 在 Project Explorer 视图中，右键单击 Hello 项目，并选择 Debug as => Debug on Server。 更改到 Debug 透视图（如果未自动更改）。将对新创建的 JSP 进行编译，并将应用程序重新部署到服务器，调试器将在放置了断点的代码行停止。现在可以单步执行您的 JSP，逐步查看变量值的更改情况。继续执行时（使用绿色箭头），JSP 将会在 Web 浏览器中打开。

   
   图 5. 调试 Hello 应用程序
   
   

回页首

使用 J2EE 分析功能

Geronimo 服务器运行时包含该服务器唯一的类。如果在 J2EE资产中使用任何唯一类，则无法将这些资产部署到任何其他应用服务器上。换句话说，您的 J2EE 应用程序将不具有可移植性。如果希望开发可移植的J2EE 应用程序，请使用 Eclipse 插件中包含的 J2EE 分析功能。

并不需要执行特殊的步骤来安装 J2EE 分析功能。只要将 Geronimo 服务器定义为项目的目标运行时，就包含此功能，可供您的项目使用。如果您的项目使用非 J2EE API，保存项目时会在 Problems 视图中显示警告，指示采用的是不推荐的访问方式。有关如何打开和关闭不推荐访问警告的信息，请参阅产品文档（请参见参考资料）。

回页首

故障排除

日志记录

遇到问题时，首先需要查看的就是日志：

• 在 Eclipse IDE 中的 Console 视图查看服务器控制台输出。缺省服务器控制台输出级别为 INFO。要将服务器控制台输出级别设置为 DEBUG，请在 Servers 视图中双击服务器。在 Server Overview 面板上，将控制台输出级别设置为 DEBUG，然后保存更改。
• 选中 workspace\.metadata\.log 文件，其中 workspace 是您的 Eclipse IDE 的当前工作区。
• Community Edition 服务器日志位于 installDir/var/log 目录，其中 installDir 是服务器的安装目录。server.log 文件包含服务器启动、部署、配置、应用程序运行和服务器关闭数据。

购买支持服务

虽然 WebSphere Application Server Community Edition 是免费的，您仍然可以按年度购买支持服务。有关详细信息，请参阅 Technical Support Offerings for WebSphere Application Server Community Edition。

回页首

结束语

本文提供的信息将帮助您安装并开始使用 WebSphere Application Server Community Edition 的 Eclipse 插件。请立即下载 Eclipse 插件，即刻开始探索之旅，体味其中的无限乐趣！

参考资料

学习

• 您可以参阅本文在 developerWorks 全球站点上的 英文原文
  
  
• IBM WebSphere Application Server Community Edition 产品文档
  
  
• IBM WebSphere Application Server Community Edition 资源
  
  
• Apache Geronimo 项目资源
  
  
• developerWorks 上的 IBM WebSphere Application Server Community Edition 与 Apache Geronimo 论坛
  
  

获得产品和技术

• 下载 IBM WebSphere Application Server Community Edition
  
  
• IBM WebSphere Application Server Community Edition 技术支持服务
  
  
• 着手编写 Java 应用程序：下载免费软件，进行快速开发
  
  

讨论

• 参与论坛讨论。
  
  

关于作者

Lin Sun在北卡罗来纳的 Research Triangle Park 担任 IBM 助理工程师，隶属于 Software GroupWebSphere Application Server Community Edition Development Team。Lin拥有北卡罗来纳州立大学（位于 Chapel Hill）的信息科学硕士学位。您可以通过 linsun@us.ibm.com 与她联系。