Java Servlet Hello World：基于Maven与Tomcat的完整实现步骤

顾言

发布时间：2026-10-16 | 6人浏览过

原创

在Java Web开发中，Servlet是处理HTTP请求的核心组件。本教程演示如何从零开始创建一个基于Maven管理的Servlet Hello World程序。主要流程包括：使用IDEA建立Maven项目并引入正确的Servlet API依赖；编写继承自HttpServlet的类并重写doGet方法；构建标准的Web应用目录结构并配置web.xml；最后将项目打包为WAR文件部署至Tomcat服务器以验证运行结果。

准备条件与项目创建

首先，需要在IntelliJ IDEA中创建一个标准的Maven项目。打开IDEA，选择新建项目，确保Maven骨架被选中。在配置界面中，指定项目的Group ID和Artifact ID，并完成路径设置后点击Finish初始化项目。

项目创建完成后，第一步是管理依赖。打开位于项目根目录下的pom.xml文件，找到<dependencies>标签部分。我们需要引入Servlet API，以便后续能正确识别javax.servlet相关的类和接口。

访问Maven中央仓库搜索“servlet”，通常第一个结果是官方提供的Servlet API包。选择一个与你的Tomcat版本相匹配的版本号。例如，如果使用Tomcat 8.x，推荐使用3.1.0版本的javax.servlet API。

将生成的<dependency>代码块复制到pom.xml中。保存文件后，IDEA会自动下载依赖。如果代码出现红色报错，通常是因为Maven资源正在下载，等待片刻或手动执行“Reload Project”即可解决。

编写Servlet核心代码

第1步：创建Servlet类

在src/main/java目录下新建一个Java类，例如命名为HelloServlet。为了让该类能够被Tomcat容器识别和处理HTTP请求，它必须继承自javax.servlet.http.HttpServlet类。只有继承了该父类，才能覆盖其中定义的方法逻辑。

第2步：重写doGet方法

在生成好的类中，默认可能会包含一个空的构造函数或父类调用。建议删除默认的super.doGet()调用，因为直接调用父类可能返回405错误码。取而代之的是重写doGet方法，这是处理GET请求的关键入口。

@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
    // 在此处编写具体逻辑
}

doGet方法的两个参数至关重要：HttpServletRequest封装了客户端发送的请求数据，而HttpServletResponse用于向客户端返回响应内容。Tomcat服务器会自动创建Servlet实例并在收到匹配请求时调用此方法，无需开发者手动实例化。

第3步：构造响应内容

在doGet方法内部，我们需要获取响应对象的输出流，并向其中写入内容。以下代码展示了如何向HTTP响应的Body中写入经典的“hello world”字符串：

resp.getWriter().println("hello world");

这一步完成了业务逻辑的最简实现，即当请求到达时，服务器返回指定文本。

配置URL映射与Web目录结构

仅有Java代码是不够的，还需要告知Tomcat哪个URL路径对应哪个Servlet类。在传统Java Web项目中，这通常通过在类头添加注解或在web.xml中配置来实现。为了更清晰地展示XML配置的作用，我们采用标准的目录结构和web.xml映射方式。

第4步：构建标准Web目录

Maven默认的结构可能不包含完整的Web App布局。我们需要手动调整目录：在main目录下创建webapp文件夹，接着在webapp下创建WEB-INF文件夹。

在WEB-INF目录下创建web.xml配置文件。虽然现代Spring等框架常使用注解替代，但web.xml仍是Servlet规范的基础。初始模板可参考以下标准结构：

<!DOCTYPE web-app PUBLIC
        "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
        "http://java.sun.com/dtd/web-app_2_3.dtd" >
<web-app>
    <display-name>Archetype Created Web Application</display-name>
</web-app>

第5步：关联URL与Servlet

在web.xml中声明Servlet及其映射关系。我们需要先定义Servlet类（servlet-name和servlet-class），然后再定义URL映射（url-pattern）。这样，当Tomcat接收到特定路径的请求时，就会定向到我们编写的HelloServlet类的doGet方法中。

完成上述编码和配置后，整个Java Servlet程序的开发阶段基本结束。接下来需要进行打包以便部署。

打包与部署配置

Tomcat服务器无法直接运行JAR文件来托管Web应用，它需要读取WAR（Web ARchive）格式的压缩包。因此，必须在pom.xml中修改打包方式为WAR。

在pom.xml中找到<packaging>标签，将其值从默认的jar改为war。

同时，为了防止生成的WAR包文件名过长或包含特殊字符导致访问不便，建议在<build>节点下指定最终的输出文件名，例如servlet1。修改完成后，在IDEA右侧的Maven面板中双击package目标进行打包编译。

部署到Tomcat并验证

打包成功后，会在项目下方的target目录中生成一个名为servlet1.war的文件。将该文件拷贝到本地安装的Tomcat服务器的webapps目录下。

启动Tomcat服务（执行bin/startup.sh或startup.bat）。Tomcat会自动检测webapps目录中的新WAR包，并将其解压缩为同名文件夹servlet1。解压后的目录结构中，WEB-INF/classes将存放编译好的.class文件，而lib目录则可能包含依赖库。

一切就绪后，打开浏览器，输入以下地址进行测试：

http://localhost:8080/servlet1/hello

如果在web.xml中配置的url-pattern为/hello，浏览器将显示“hello world”文本，标志着基于Servlet的Hello World程序已成功部署并运行。以上就是Java Servlet Hello World程序的详细内容，更多关于Java Web开发的基础资料请关注本站其它相关文章！