用 Tomcat 和 Eclipse 开发 Web 应用程序
用 Tomcat 和 Eclipse 开发 Web 应用程序
Apache Tomcat & Eclipse 平台是一款杰出的 Web 开发平台
若将 Eclipse 与 Apache Tomcat 直接集成,那么将其用作 Web 开发平台就会更为容易。通过本文,了解如何设置 Eclipse 和 Apache Tomcat V5.5 来开发经典的 Hello World servlet。
4 评论:
编辑的注释:本文是 Geoffrey Duck 在 2004 年 6 月发表的文章 “使用 Eclipse 作为 Jakarta Tomcat 的开发环境” 的后续篇。
所需的组件
Eclipse V3.2 Callisto 集成开发环境 (IDE) 包括了用于 Web 开发及与服务器集成的工具。所以,除了软件开发工具箱 (SDK) 之外,只需安装 Eclipse 和 Apache Tomcat。本文所使用的组件和版本如下所示:
表 1. 使用的组件和版本
组件 | 本文使用的版本 |
---|---|
Eclipse Platform | 3.2.2 |
Java EE 5 SDK | 1.5.0_09 |
Apache Tomcat | 5.5.20 |
Eclipse IDE 是一种开源 IDE,用作 Java™Server Pages (JSP) 和 Java 文件的开发环境。如若同时安装 Web 和 Java 2 Platform,Enterprise Edition (J2EE) 开发工具,那么 Eclipse 将非常适合于创建 HTML、JSP 和 servlet。
运行 servlet 需要 Java SDK。最后,在 Java Servlet 和 Java Server Page 的正式参考实现中还会用到 Apache Tomcat,它是一款开源 Web 和 servlet 容器。
安装
Eclipse 和 Tomcat 的安装非常类似 — 都需要将归档文件解压缩到本地硬盘上的文件夹。如果想要卸载任何一个,只需将解压缩后的文件所在的文件夹删除即可。
安装 Eclipse
要安装 Eclipse IDE,将从 Eclipse 网站下载的压缩文件 (.zip 或 .tar.gz) 解压缩,然后将压缩后的文件夹放入合适的位置。我会根据所使用的操作系统的约定来选择安装的位置。如果在 Macintosh 上安装 Eclipse,我会将 Eclipse 文件夹放在 Applications 文件夹内。如果使用的是 Microsoft™ Windows™,我会将解压缩后的文件夹放入 C:\Program 文件目录。
下载和安装了 Eclipse 后,就可以启动它了。在开始创建 Web 项目之前,您需要安装 J2EE 和 Web Development 插件。所幸的是,借助 Callisto Discovery 站点很容易安装这些插件。
安装 Web 工具
Eclipse IDE 运行正常后,选择 Help > Software Updates > Find and Install。这个选项会让您可以下载和安装 Web 工具,且无需转到 Web 站点。
选择 Search for New Features to Install,如下所示,然后单击 Next。
图 1. 安装/更新窗口
![安装/更新窗口](http://www.ibm.com/developerworks/cn/opensource/os-eclipse-tomcat/figure1.jpg)
选择 Callisto Discovery Site,如下所示,然后单击 Next。
图 2. 选择 Callisto Discovery Site
![选择 Callisto Discovery Site](http://www.ibm.com/developerworks/cn/opensource/os-eclipse-tomcat/figure2.jpg)
在 Callisto Discovery Site 下,选中 Web and J2EE Development 复选框。向导会随即警告您,尚缺少依赖项。单击 Select Required,警告消失。在 Graphical Editors and Frameworks and Models and Model Development 类别中的部分或全部组件会被选中(如图 3 所示),这些组件是安装 Web 和 J2EE 插件所必需的。
图 3. 选择要安装的特性
![选择要安装的特性](http://www.ibm.com/developerworks/cn/opensource/os-eclipse-tomcat/figure3.jpg)
单击 Next 以继续,针对所选的每个特性的证书协议也会继而出现。如果您同意这些证书,就选择接受,继续向导的后续过程。当 IDE 完成插件的安装后,就会要求您重启 Eclipse 以便更改能够生效。在继续之前,请务必重启 IDE。
重启了 IDE 后,开始开发动态 Web 项目所需的新特性就已准备完毕。
安装 Tomcat
要安装 Apache Tomcat,将所下载的归档文件解压缩并放入到目录中,我将其放在了我的 C:\apps 目录下以便于日后查找。到目前所做的这些就足够了,使用随后显示的 Eclipse 来启动 Tomcat。
创建一个新的 Web 项目
从 Eclipse IDE,选择 File > New > Project 查看项目向导。在 Wizards 框,输入 Web
,而 New Project 窗口会过滤向导以只显示匹配的那些项。利用这种方法可以很容易找到向导,而无需遍历每一项。
从列表中选择 Dynamic Web Project。我们要使用 Standard Web Project Wizard 来建立静态 HTML Web 项目。 虽然您也可以在技术上使用 Tomcat 运行静态 Web 站点,但 Web 服务器,比如 Apache Web Server 更适合于静态内容。 专门为服务于静态页面而设计的 Web 服务器拥有的开销更少,且专为此目的作了调优。
以运行库为目标
在 Target Runtime 下,可以看到 <None>,如图 4 所示,由于您尚未为 Apache Tomcat 创建运行库,所以需要单击 New 打开 New Target Runtime Wizard。从 Apache 文件夹中选择 Apache Tomcat V5.5,如图 5 所示,然后单击 Next。
图 4.创建一个新的动态 Web 项目
![创建一个新的动态 Web 项目](http://www.ibm.com/developerworks/cn/opensource/os-eclipse-tomcat/figure4.jpg)
图 5.创建一个新的服务器运行库
![创建一个新的服务器运行库](http://www.ibm.com/developerworks/cn/opensource/os-eclipse-tomcat/figure5.jpg)
现在,您可以命名此运行库,当然保留 Apache Tomcat V5.5 的默认名也可以。单击 Browse 来定位用于 Apache Tomcat 配置的基本文件夹(我的是 C:\apps\apache-tomcat-5.5.20,如图 6 所示)。若无特殊原因,我建议不要更改,保留 IBM® Java Runtime Environment (JRE) 版本作为工作台的默认 JRE。输入有效目录之后,单击 Finish 创建运行库配置。
图 6. 定义服务器位置
![定义服务器位置](http://www.ibm.com/developerworks/cn/opensource/os-eclipse-tomcat/figure6.jpg)
您还需要选择是否想要转换到 J2EE Perspective。我总是选择是,因为这个透视图包含了一些很有用的视图,比如 Servers 视图,可以帮助您日后启动和停止 Tomcat。通过选择 Window > Show View 可以打开 Servers 视图。
添加服务器
Servers 视图目前没有包含任何内容。此视图针对的是应用程序和 Web 服务器;它让您可以控制它们并监视其状态。要从 IDE 直接控制 Tomcat,可通过从上下文敏感菜单选择 New > Server 来向 Tomcat 添加引用。图 7 所示的 New Server 向导将默认指向刚刚创建的那个 Apache Tomcat V5.5 运行库。
图 7. 定义新服务器
![定义新服务器](http://www.ibm.com/developerworks/cn/opensource/os-eclipse-tomcat/figure7.jpg)
单击 Next。系统提问您是否想要向服务器添加项目。选择在之前的步骤中创建的那个项目,然后单击 Add。
图 8. 向服务器添加项目
![向服务器添加项目](http://www.ibm.com/developerworks/cn/opensource/os-eclipse-tomcat/figure8.jpg)
单击 Finish 关闭向导。现在,Servers 视图包含了 Tomcat V5.5 Server,且其下还包含项目。
图 9. Servers 视图中的 Tomcat 服务器
![Servers 视图中的 Tomcat 服务器](http://www.ibm.com/developerworks/cn/opensource/os-eclipse-tomcat/figure9.jpg)
创建示例页
测试新的动态 Web 项目以及 Tomcat 服务器集成的最简单方法是创建简单的 JSP 并将其部署到 Tomcat。您可以通过选择 File > New > Other创建新的 JSP 文件,或者您也可以使用上下文敏感菜单,方法是右键单击 Project Explorer 视图中的项目名称,并选择 New > JSP。
确保父目录是 WebContent,并将此文件命名为 index.jsp。单击 Finish 使用默认模板创建页面。如果单击 Next,还可以选择想要为新页面选用的模板(比如 HTML 或 XHTML)。对于本测试而言,可保留默认选项。
如下所示的页面代码显示了一个简单的日期,这表明该代码可以正常工作。
清单 1. index.jsp 的内容
<%@ page language="java" contentType="text/html; charset=ISO-8859-1" pageEncoding="ISO-8859-1"%> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>My Title</title> </head> <body> <% java.util.Date d = new java.util.Date(); %> <h1> Today's date is <%= d.toString() %> and this jsp page worked! </h1> </body> </html>
部署此页
测试页完成后,可使用 Eclipse 将其重新部署到 Apache Tomcat。在 Servers 视图,注意到 State 已被设置成 Republish。这是因为自项目上次部署到服务器以来,已经发生了很多更改。右键单击此服务器并从菜单中选择 Publish。一旦项目被部署到此服务器,状态就会变成 Synchronized。
项目成功部署且服务器成功启动之后,可以打开浏览器并导航到 http://localhost:8080/[ProjectName]/(其中 [ProjectName] 是所创建的动态 Web 项目的名称)。您所创建的新的 Web 页会随即出现,且日期应该是当前日期。如果刷新页面,日期还会随之变化。
图 10. index.jsp 在浏览器中的输出
![index.jsp 在浏览器中的输出](http://www.ibm.com/developerworks/cn/opensource/os-eclipse-tomcat/figure10.jpg)
Hello World servlet
您可以向您的项目添加 Java servlets 并加以部署。要为测试的目的而快速创建一个 servlet,可以使用 Servlet Wizard,方法是右键单击 Project Explorer 视图中的动态 Web 项目并选择 New > Other。在 Web 文件夹下,选择 Servlet,然后单击 Next。
将包名称 com.example.servlets
添加到 Java Package 旁,将 HelloServlet
添加到 Class name 旁。单击 Finish。作为示例,可以保留默认值。Eclipse IDE 会生成一个 servlet 类。要查看应用当中的这个测试用 servlet,可以在 doGet()
方法中添加一行代码来向 ResponseWriter 打印消息。servlet 类应该类似如下所示的这个。
清单 2. HelloServlet.java 的内容
package com.example.servlets; import java.io.IOException; import javax.servlet.ServletException; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; /** * Servlet implementation class for Servlet: HelloServlet * */ public class HelloServlet extends javax.servlet.http.HttpServlet implements javax.servlet.Servlet { /* (non-Java-doc) * @see javax.servlet.http.HttpServlet#HttpServlet() */ public HelloServlet() { super(); } /* (non-Java-doc) * @see javax.servlet.http.HttpServlet#doGet(HttpServletRequest request, HttpServletResponse response) */ protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { response.getWriter().write("Hello, world!"); } /* (non-Java-doc) * @see javax.servlet.http.HttpServlet#doPost(HttpServletRequest request, HttpServletResponse response) */ protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { // TODO Auto-generated method stub } }
添加此 servlet 后,Eclipse IDE 会提示项目有所更改。重新查看一下 Servers 视图;Restart 现在出现在 Tomcat 服务器旁的 Status 列。要重启此服务器,右键单击 Servers 视图中的此服务器,然后选择 Restart > Start。 打开浏览器并导航到 http://localhost:8080/[ProjectName]/HelloServlet(其中 [ProjectName] 是动态 Web 项目的名称)。文本 "Hello, world!" 将会出现在浏览器窗口中。您可以添加日期,将与 index.jsp 文件中的类似的代码添加到 doGet()
方法,并使用 Eclipse IDE 重新部署 servlet。
结束语
不用离开 IDE 就可以启动、停止和部署到服务器,这种开发 JSP 和 servlet 的方法非常高效。Eclipse 和 Apache Tomcat 的组合则提供了一种简单的集成环境,让您可以加速开发。
参考资料
学习
- 您可以参阅本文在 developerWorks 全球站点上的 英文原文 。
- 本文是 Geoffrey Duck 在 2004 年 6 月发表的文章 “使用 Eclipse 作为 Jakarta Tomcat 的开发环境” 的后续篇。
- 获得更多有关 Java servlet 技术 的信息以开始构建功能强大的动态 Web 应用程序。
- 访问 Sun Microsystems,获取有关 JavaServer Pages 技术 的信息来为您的动态 Web 站点构建 JSP。
- 参阅 Eclipse Web Tools Platform (WTP) Project,获取有关使用 Eclipse 构建 Web 应用程序所需插件的更多信息。
- 参阅 “Eclipse 推荐阅读清单”。
- 浏览 developerWorks 上所有的 Eclipse 文章 和 教程。
- Eclipse 的新手应该首先参看 现在开始学习 Eclipse。
- 通过查看 IBM developerWorks 的 Eclipse 项目资源 扩展您的 Eclipse 技能。
- 要收听面向软件开发人员的有趣访谈和讨论,请参考 developerWorks podcasts。
- 有关 Eclipse platform 的简介,请参看 “Eclipse 平台入门”。
- 随时关注 developerWorks 的 技术事件和网络广播。
- 查阅最近将在全球举办的面向 IBM 开放源码开发人员的会议、展览、网络广播和其他 活动。
- 访问 developerWorks 的 开源软件技术专区,获取广泛的 how-to 信息、工具和项目更新以帮助您利用开放源码技术进行开发并将其与 IBM 的产品结合使用。
获得产品和技术
- 从该项目的官方 Web 站点下载 Eclipse,这个 IDE 功能强大(而且免费),并可用于 Java、JSP 等。
- 下载 Apache Tomcat 并使用它来运行 Web 应用程序。
- 从 Sun Microsystems 下载 Java EE 5 SDK。
- 参考 IBM alphaWorks 上最新的 Eclipse 技术下载。
- 下载 IBM 产品的评估版,实际体验这些来自 DB2®、Lotus®、Rational®、Tivoli® 和 WebSphere® 的应用程序开发工具和中间件产品。
- 使用 IBM 试用软件 改进您的下一个开源开发项目,这些软件可以下载或通过 DVD 获得。
讨论
- Eclipse Platform 新闻组 应该是讨论有关 Eclipse 的问题的首站(选择它将会启动默认的 Usenet 新闻读写器应用程序并打开 eclipse.platform)。
- Eclipse 新闻组 中含有面向有兴趣使用和扩展 Eclipse 的用户的很多资源。
- 通过参与 developerWorks blog 加入 developerWorks 社区。