用 Tomcat 和 Eclipse 开发 Web 应用程序

骑猪看日落 2021-11-02 04:31 368阅读 0赞

# 用 Tomcat 和 Eclipse 开发 Web 应用程序 #

**Apache Tomcat & Eclipse 平台是一款杰出的 Web 开发平台**

**简介：** 若将 Eclipse 与 Apache Tomcat 直接集成，那么将其用作 Web 开发平台就会更为容易。通过本文，了解如何设置 Eclipse 和 Apache Tomcat V5.5 来开发经典的 Hello World servlet。

***编辑的注释**：本文是 Geoffrey Duck 在 2004 年 6 月发表的文章 “[使用 Eclipse 作为 Jakarta Tomcat 的开发环境][Eclipse _ Jakarta Tomcat]” 的后续篇。*

**所需的组件**

Eclipse V3.2 Callisto 集成开发环境 (IDE) 包括了用于 Web 开发及与服务器集成的工具。所以，除了软件开发工具箱 (SDK) 之外，只需安装 Eclipse 和 Apache Tomcat。本文所使用的组件和版本如下所示：

表 1. 使用的组件和版本

<table style="font-size:0.8em; border-width:0px 1px 1px; border-right-style:solid; border-bottom-style:solid; border-left-style:solid; border-right-color:rgb(204,204,204); border-bottom-color:rgb(204,204,204); border-left-color:rgb(204,204,204); width:708px"> 
 <tbody> 
  <tr> 
   <th style="font-family:arial,nsimsun,sans-serif; border-top-color:rgb(204,204,204); border-top-style:solid; border-top-width:1px; padding:8px 5px; vertical-align:top; background-color:rgb(247,248,252)"> 组件</th> 
   <th style="font-family:arial,nsimsun,sans-serif; border-top-color:rgb(204,204,204); border-top-style:solid; border-top-width:1px; padding:8px 5px; vertical-align:top; background-color:rgb(247,248,252)"> 本文使用的版本</th> 
  </tr> 
  <tr> 
   <td style="font-family:arial,nsimsun,sans-serif; border-top-color:rgb(204,204,204); border-top-style:solid; border-top-width:1px; padding:8px 5px; vertical-align:top"> <a href="http://www.eclipse.org/downloads/" style="color:rgb(153,102,153)" rel="nofollow">Eclipse Platform</a></td> 
   <td style="font-family:arial,nsimsun,sans-serif; border-top-color:rgb(204,204,204); border-top-style:solid; border-top-width:1px; padding:8px 5px; vertical-align:top"> 3.2.2</td> 
  </tr> 
  <tr> 
   <td style="font-family:arial,nsimsun,sans-serif; border-top-color:rgb(204,204,204); border-top-style:solid; border-top-width:1px; padding:8px 5px; vertical-align:top"> <a href="http://java.sun.com/javaee/downloads/" style="color:rgb(153,102,153)" rel="nofollow">Java EE 5 SDK</a></td> 
   <td style="font-family:arial,nsimsun,sans-serif; border-top-color:rgb(204,204,204); border-top-style:solid; border-top-width:1px; padding:8px 5px; vertical-align:top"> 1.5.0_09</td> 
  </tr> 
  <tr> 
   <td style="font-family:arial,nsimsun,sans-serif; border-top-color:rgb(204,204,204); border-top-style:solid; border-top-width:1px; padding:8px 5px; vertical-align:top"> <a href="http://tomcat.apache.org/" style="color:rgb(153,102,153)" rel="nofollow">Apache Tomcat</a></td> 
   <td style="font-family:arial,nsimsun,sans-serif; border-top-color:rgb(204,204,204); border-top-style:solid; border-top-width:1px; padding:8px 5px; vertical-align:top"> 5.5.20</td> 
  </tr> 
 </tbody> 
</table>

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. 安装/更新窗口  
![安装/更新窗口][figure1.jpg]

选择 **Callisto Discovery Site**，如下所示，然后单击 **Next**。

图 2. 选择 Callisto Discovery Site  
![选择 Callisto Discovery Site][Callisto Discovery Site]

在 **Callisto Discovery Site** 下，选中 **Web and J2EE Development** 复选框。向导会随即警告您，尚缺少依赖项。单击 **Select Required**，警告消失。在 Graphical Editors and Frameworks and Models and Model Development 类别中的部分或全部组件会被选中（如图 3 所示），这些组件是安装 Web 和 J2EE 插件所必需的。

图 3. 选择要安装的特性  
![选择要安装的特性][figure3.jpg]

单击 **Next** 以继续，针对所选的每个特性的证书协议也会继而出现。如果您同意这些证书，就选择接受，继续向导的后续过程。当 IDE 完成插件的安装后，就会要求您重启 Eclipse 以便更改能够生效。在继续之前，请务必重启 IDE。

重启了 IDE 后，开始开发动态 Web 项目所需的新特性就已准备完毕。

**安装 Tomcat**

要安装 Apache Tomcat，将所下载的归档文件解压缩并放入到目录中，我将其放在了我的 C:\\apps 目录下以便于日后查找。到目前所做的这些就足够了，使用随后显示的 Eclipse 来启动 Tomcat。

[回页首][Link 1]

**创建一个新的 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 项目][Web]   
  
  
图 5.创建一个新的服务器运行库  
![创建一个新的服务器运行库][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. 定义服务器位置  
![定义服务器位置][figure6.jpg]

## 运行库配置 ##

若您日后发现需要更改自己的运行库配置，可以通过选择 **Window > Preferences** 实现此目的。在 filter 框，键入 `Runtime`，列表就会在 Server 类别下显示已安装的运行库配置设置。选择您的 Apache Tomcat 运行库，然后单击 **Edit** 来更改名称、目录位置或 JRE 版本。

您还需要选择是否想要转换到 J2EE Perspective。我总是选择是，因为这个透视图包含了一些很有用的视图，比如 Servers 视图，可以帮助您日后启动和停止 Tomcat。通过选择 **Window > Show View** 可以打开 Servers 视图。

**添加服务器**

Servers 视图目前没有包含任何内容。此视图针对的是应用程序和 Web 服务器；它让您可以控制它们并监视其状态。要从 IDE 直接控制 Tomcat，可通过从上下文敏感菜单选择 **New > Server** 来向 Tomcat 添加引用。图 7 所示的 **New Server** 向导将默认指向刚刚创建的那个 Apache Tomcat V5.5 运行库。

图 7. 定义新服务器  
![定义新服务器][figure7.jpg]

单击 **Next**。系统提问您是否想要向服务器添加项目。选择在之前的步骤中创建的那个项目，然后单击 **Add**。

图 8. 向服务器添加项目  
![向服务器添加项目][figure8.jpg]

单击 **Finish** 关闭向导。现在，Servers 视图包含了 Tomcat V5.5 Server，且其下还包含项目。

图 9. Servers 视图中的 Tomcat 服务器  
![Servers 视图中的 Tomcat 服务器][Servers _ Tomcat]

**创建示例页**

测试新的动态 Web 项目以及 Tomcat 服务器集成的最简单方法是创建简单的 JSP 并将其部署到 Tomcat。您可以通过选择 **File > New > Other** 创建新的 JSP 文件，或者您也可以使用上下文敏感菜单，方法是右键单击 Project Explorer 视图中的项目名称，并选择**New > JSP**。

确保父目录是 WebContent，并将此文件命名为 index.jsp。单击 **Finish** 使用默认模板创建页面。如果单击 **Next**，还可以选择想要为新页面选用的模板（比如 HTML 或 XHTML）。对于本测试而言，可保留默认选项。

如下所示的页面代码显示了一个简单的日期，这表明该代码可以正常工作。

清单 1. index.jsp 的内容

<table style="font-size:0.8em"> 
 <tbody> 
  <tr> 
   <td style="font-family:arial,nsimsun,sans-serif; border:1px solid rgb(204,204,204); padding:2px 2px 5px; background-color:rgb(247,247,247)!important"> <pre style="width:694px; margin-top:0px; margin-bottom:0px; font-family:'Andale Mono','Lucida Console',Monaco,Liberation,fixed,monospace; font-size:11px; overflow:auto; background-color:rgb(247,247,247)!important">                
&lt;%@ page language="java" contentType="text/html; charset=ISO-8859-1"
    pageEncoding="ISO-8859-1"%&gt;
&lt;!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
    "http://www.w3.org/TR/html4/loose.dtd"&gt;
&lt;html&gt;
&lt;head&gt;
&lt;meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"&gt;
&lt;title&gt;My Title&lt;/title&gt;
&lt;/head&gt;
&lt;body&gt;
&lt;% java.util.Date d = new java.util.Date(); %&gt;
&lt;h1&gt;
Today's date is &lt;%= d.toString() %&gt; and this jsp page worked!
&lt;/h1&gt;
&lt;/body&gt;
&lt;/html&gt;
</pre> </td> 
  </tr> 
 </tbody> 
</table>

**部署此页**

测试页完成后，可使用 Eclipse 将其重新部署到 Apache Tomcat。在 Servers 视图，注意到 State 已被设置成 Republish。这是因为自项目上次部署到服务器以来，已经发生了很多更改。右键单击此服务器并从菜单中选择 **Publish**。一旦项目被部署到此服务器，状态就会变成 Synchronized。

## 存在问题？ ##

事情有时难免会出错。要查看从 Tomcat 产生的错误，可以使用 Console 视图。Console 捕获源自您在 Servers 视图中设置的服务器的输出。

项目成功部署且服务器成功启动之后，可以打开浏览器并导航到 http://localhost:8080/\[ProjectName\]/（其中 \[ProjectName\] 是所创建的动态 Web 项目的名称）。您所创建的新的 Web 页会随即出现，且日期应该是当前日期。如果刷新页面，日期还会随之变化。

图 10. index.jsp 在浏览器中的输出  
![index.jsp 在浏览器中的输出][index.jsp]

**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 的内容

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 {
		<strong>response.getWriter().write("Hello, world!");</strong>
	}  	
	
	/* (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
	}   	  	    
}</pre> </td> 
  </tr> 
 </tbody> 
</table>

添加此 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。

[回页首][Link 1]

**结束语**

不用离开 IDE 就可以启动、停止和部署到服务器，这种开发 JSP 和 servlet 的方法非常高效。Eclipse 和 Apache Tomcat 的组合则提供了一种简单的集成环境，让您可以加速开发。

**参考资料**

学习

*  您可以参阅本文在 developerWorks 全球站点上的 [英文原文][Link 2] 。  
      
    
 *  本文是 Geoffrey Duck 在 2004 年 6 月发表的文章 “[使用 Eclipse 作为 Jakarta Tomcat 的开发环境][Eclipse _ Jakarta Tomcat]” 的后续篇。  
      
    
 *  获得更多有关 [Java servlet 技术][Java servlet] 的信息以开始构建功能强大的动态 Web 应用程序。   
      
    
 *  访问 Sun Microsystems，获取有关 [JavaServer Pages 技术][JavaServer Pages] 的信息来为您的动态 Web 站点构建 JSP。   
      
    
 *  参阅 [Eclipse Web Tools Platform (WTP) Project][Eclipse Web Tools Platform _WTP_ Project]，获取有关使用 Eclipse 构建 Web 应用程序所需插件的更多信息。   
      
    
 *  参阅 “[Eclipse 推荐阅读清单][Eclipse]”。   
      
    
 *  浏览 developerWorks 上所有的 Eclipse [文章][Link 3] 和 [教程][Link 4]。  
      
    
 *  Eclipse 的新手应该首先参看 [现在开始学习 Eclipse][Eclipse 1]。  
      
    
 *  通过查看 IBM developerWorks 的 [Eclipse 项目资源][Eclipse 2] 扩展您的 Eclipse 技能。  
      
    
 *  要收听面向软件开发人员的有趣访谈和讨论，请参考 [developerWorks podcasts][]。  
      
    
 *  有关 Eclipse platform 的简介，请参看 “[Eclipse 平台入门][Eclipse 3]”。  
      
    
 *  随时关注 developerWorks 的 [技术事件和网络广播][Link 5]。  
      
    
 *  查阅最近将在全球举办的面向 IBM 开放源码开发人员的会议、展览、网络广播和其他 [活动][Link 6]。   
      
    
 *  访问 developerWorks 的 [开源软件技术专区][Link 7]，获取广泛的 how-to 信息、工具和项目更新以帮助您利用开放源码技术进行开发并将其与 IBM 的产品结合使用。

获得产品和技术

*  从该项目的官方 Web 站点下载 [Eclipse][Eclipse 4]，这个 IDE 功能强大（而且*免费*），并可用于 Java、JSP 等。   
      
    
 *  下载 [Apache Tomcat][] 并使用它来运行 Web 应用程序。   
      
    
 *  从 Sun Microsystems 下载 [Java EE 5 SDK][]。  
      
    
 *  参考 IBM [alphaWorks][] 上最新的 [Eclipse 技术下载][Eclipse 5]。  
      
    
 *  下载 [IBM 产品的评估版][IBM]，实际体验这些来自 DB2®、Lotus®、Rational®、Tivoli® 和 WebSphere® 的应用程序开发工具和中间件产品。  
      
    
 *  使用 [IBM 试用软件][IBM] 改进您的下一个开源开发项目，这些软件可以下载或通过 DVD 获得。

讨论

*  Eclipse Platform 新闻组 应该是讨论有关 Eclipse 的问题的首站（选择它将会启动默认的 Usenet 新闻读写器应用程序并打开 eclipse.platform）。  
      
    
 *  [Eclipse 新闻组][Eclipse 6] 中含有面向有兴趣使用和扩展 Eclipse 的用户的很多资源。  
      
    
 *  通过参与 [developerWorks blog][] 加入 developerWorks 社区。

[Eclipse _ Jakarta Tomcat]: http://www.ibm.com/developerworks/cn/opensource/os-ectom/
[figure1.jpg]: /images/20211102/3afa8ba4392a403aac999183e673594c.png
[Callisto Discovery Site]: /images/20211102/0bd66a6048c94dac90c22d87402491fc.png
[figure3.jpg]: /images/20211102/07f69adab8384238ad90e6b9e507fb0a.png
[Link 1]: http://www.ibm.com/developerworks/cn/opensource/os-eclipse-tomcat/#ibm-pcon
[Web]: /images/20211102/d11e5e1456914cdc97ee5032e9f8d204.png
[figure5.jpg]: /images/20211102/0bf7e286d39f4dcc9c08ba7aa19c45cd.png
[figure6.jpg]: /images/20211102/772e582992e44a92852fac1a533ed069.png
[figure7.jpg]: /images/20211102/a5611c9a013e4b53a9759709e0565efa.png
[figure8.jpg]: /images/20211102/63555a7c04e54c06ab0c8f1a883d1a5e.png
[Servers _ Tomcat]: /images/20211102/63d187ec2e3140dcaeace69945c9c7c9.png
[index.jsp]: /images/20211102/a57e29c4891f44b2af9b69dd5fc1f3e0.png
[Link 2]: http://www.ibm.com/developerworks/opensource/library/os-eclipse-tomcat/?S_TACT=105AGX52&S_CMP=cn-a-os
[Java servlet]: http://java.sun.com/products/servlet/
[JavaServer Pages]: http://java.sun.com/products/jsp/
[Eclipse Web Tools Platform _WTP_ Project]: http://www.eclipse.org/webtools/main.php
[Eclipse]: http://www.ibm.com/developerworks/cn/opensource/os-ecl-read/
[Link 3]: http://www.ibm.com/developerworks/cn/views/opensource/articles.jsp?view_by=search&search_by=eclipse
[Link 4]: http://www.ibm.com/developerworks/cn/views/opensource/tutorials.jsp?view_by=search&search_by=eclipse
[Eclipse 1]: http://www.ibm.com/developerworks/cn/opensource/top-projects/eclipse-starthere.html
[Eclipse 2]: http://www.ibm.com/developerworks/cn/opensource/top-projects/eclipse.html
[developerWorks podcasts]: http://www.ibm.com/developerworks/podcast/?S_TACT=105AGX52&S_CMP=cn-a-os
[Eclipse 3]: http://www.ibm.com/developerworks/cn/linux/opensource/os-ecov/
[Link 5]: http://www.ibm.com/developerworks/offers/techbriefings/?S_TACT=105AGX52&S_CMP=cn-a-os
[Link 6]: http://www.ibm.com/developerworks/views/opensource/events.jsp?S_TACT=105AGX52&S_CMP=cn-a-os
[Link 7]: http://www.ibm.com/developerworks/cn/opensource/
[Eclipse 4]: http://www.eclipse.org/downloads/
[Apache Tomcat]: http://tomcat.apache.org/
[Java EE 5 SDK]: http://java.sun.com/javaee/downloads/
[alphaWorks]: http://www.alphaworks.ibm.com/
[Eclipse 5]: http://www.alphaworks.ibm.com/eclipse
[IBM]: http://www.ibm.com/developerworks/cn/downloads/
[Eclipse 6]: http://www.eclipse.org/newsgroups/
[developerWorks blog]: http://www.ibm.com/developerworks/blogs?S_TACT=105AGX52&S_CMP=cn-a-os