深入理解Servlet：从基础概念到高级特性与实战应用

一、Servlet 简介与工作原理

Servlet 是 Java Web 开发的核心组件，运行于服务器端，主要负责处理客户端请求并返回响应。其工作原理涉及多个组件的协同运作，从客户端发起请求到服务器端处理并返回响应，整个过程严谨有序。

（一）Servlet 容器与 Tomcat

Servlet 容器（Servlet Container）是 Servlet 运行的环境，负责管理 Servlet 的生命周期、资源分配以及请求分发等工作。Apache Tomcat 是最常用的 Servlet 容器之一，具备强大的功能和良好的性能。

在 Tomcat 架构中，Context 容器直接管理 Servlet 的包装类 Wrapper，一个 Context 对应一个 Web 应用。例如，在 Tomcat 的配置文件中，可以通过 <Context> 标签配置 Web 应用的相关参数，如上下文路径、文档根目录等。

（二）Servlet 的生命周期

Servlet 的生命周期由容器管理，主要包含以下四个阶段：

加载和实例化
- Servlet 容器通常在启动时或首次接收到请求时加载 Servlet 类。它通过类加载器从本地文件系统、远程文件系统或网络服务中获取类定义。例如，Web 应用启动时，Tomcat 会根据 web.xml 中的配置找到对应的 Servlet 类并加载。
- 容器使用 Java 反射 API 创建 Servlet 实例，调用默认构造方法（无参构造）。因此，编写 Servlet 类时不应提供带参数的构造方法。
初始化
- 实例化后，容器调用 Servlet 的 init() 方法进行初始化。在此方法中，Servlet 可执行准备工作，如建立数据库连接、获取配置信息等。示例如下：
```
public void init(ServletConfig config) throws ServletException {
super.init(config);
// 在这里进行初始化操作，如获取初始化参数
String paramValue = config.getInitParameter("paramName");
// 其他初始化逻辑
}
```
- 每个 Servlet 实例的 init() 方法仅被调用一次。初始化期间可使用 ServletConfig 对象获取 web.xml 中配置的初始化参数。若发生错误，可抛出 ServletException 或 UnavailableException 异常通知容器。
请求处理
- 容器调用 Servlet 的 service() 方法处理请求。在 service() 方法中，Servlet 通过 ServletRequest 对象获取客户端和请求信息，处理后通过 ServletResponse 对象设置响应信息。例如，处理登录请求的 Servlet 如下：
```
protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
// 获取用户名和密码
String username = request.getParameter("username");
String password = request.getParameter("password");
// 进行登录验证等业务逻辑处理
if (isValidUser(username, password)) {
    response.getWriter().println("登录成功");
} else {
    response.getWriter().println("登录失败");
}
}
```
- 若 service() 方法执行期间发生错误，可抛出 ServletException 或 UnavailableException 异常。若 UnavailableException 指示实例永久不可用，容器将调用 destroy() 方法释放实例。
服务终止
- 当容器检测到 Servlet 实例应被移除时（如应用停止或重新加载），调用 destroy() 方法释放资源，如关闭数据库连接、保存数据等。示例如下：
```
public void destroy() {
// 释放资源的逻辑，如关闭数据库连接
if (connection != null) {
    try {
        connection.close();
    } catch (SQLException e) {
        e.printStackTrace();
    }
}
super.destroy();
}
```
- destroy() 方法调用后，容器释放 Servlet 实例，由 Java 垃圾收集器回收。若再次需要该 Servlet 处理请求，容器会创建新的实例。

（三）Servlet 的体系结构

Servlet 规范基于几个关键类运转，其中 ServletConfig、ServletRequest 和 ServletResponse 与 Servlet 主动关联。ServletConfig 在初始化时传递给 Servlet，用于获取配置属性；ServletRequest 和 ServletResponse 在请求处理时传递，分别用于获取请求信息和设置响应信息。

在 Tomcat 容器中，广泛应用了门面设计模式（Facade Pattern）。例如，StandardWrapper 和 StandardWrapperFacade 实现了 ServletConfig 接口，传给 Servlet 的实际是 StandardWrapperFacade 对象。这保证了 Servlet 能获取所需数据，同时不暴露内部无关数据。同样，ServletContext 也有类似结构，Servlet 中获取的实际对象是 ApplicationContextFacade，用于安全地获取应用相关信息。

二、Servlet 的基本使用与配置

（一）创建 Servlet 类

创建 Servlet 类通常需要继承 HttpServlet 类并重写相应方法（如 doGet 或 doPost）。例如，创建一个简单的 HelloWorldServlet：

import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.PrintWriter;

public class HelloWorldServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        // 设置响应内容类型为 HTML
        response.setContentType("text/html");
        // 获取输出流对象
        PrintWriter out = response.getWriter();
        // 输出 HTML 内容
        out.println("<html><body>");
        out.println("<h1>Hello, World!</h1>");
        out.println("</body></html>");
    }
}

（二）在 web.xml 中配置 Servlet

在 web.xml 文件中，需配置 Servlet 的相关信息，包括名称、类名、初始化参数和映射路径等。以下是上述 HelloWorldServlet 的配置示例：

<servlet>
    <servlet-name>HelloWorldServlet</servlet-name>
    <servlet-class>com.example.HelloWorldServlet</servlet-class>
    <init-param>
        <param-name>greeting</param-name>
        <param-value>Hello!</param-value>
    </init-param>
</servlet>
<servlet-mapping>
    <servlet-name>HelloWorldServlet</servlet-name>
    <url-pattern>/hello</url-pattern>
</servlet-mapping>

（三）Servlet 与 JSP 的关系

JSP 本质上是 Servlet 的扩展。JSP 页面在第一次被访问时会被翻译成 Servlet 源码并编译执行。在 Tomcat 中，通过 JspServlet 来处理 JSP 页面的翻译工作，其在 conf/web.xml 中有相应配置，会拦截所有以 .jsp 或 .jspx 为后缀的请求。

例如，一个简单的 JSP 页面：

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html>
<head>
<title>JSP Example</title>
</head>
<body>
    <%
    // 这里可以嵌入 Java 代码
    String message = "This is a JSP page.";
    %>
    <h1><%=message%></h1>
</body>
</html>

当访问该 JSP 页面时，Tomcat 会将其翻译成对应的 Servlet 类并执行，最终将生成的 HTML 内容返回给客户端。

三、Servlet 3.0 新特性详解

Servlet 3.0 规范引入了多项重要特性，旨在简化开发并提升性能。

（一）异步处理支持

解决的问题
在 Servlet 3.0 之前，Servlet 线程在处理业务时一直处于阻塞状态，直到业务处理完毕才能输出响应并结束线程。若业务处理耗时较长（如数据库操作、跨网络调用等），会导致服务器线程资源占用过多，影响并发处理能力。

异步处理流程
Servlet 接收到请求后，可先进行预处理，然后将请求转交给异步线程处理，自身返回容器。异步线程处理完业务后，可直接生成响应数据或转发请求。示例如下：

import javax.servlet.AsyncContext;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.PrintWriter;
import java.util.Date;

@WebServlet(urlPatterns = "/asyncDemo", asyncSupported = true)
public class AsyncDemoServlet extends HttpServlet {
    @Override
    public void doGet(HttpServletRequest req, HttpServletResponse resp) throws IOException, ServletException {
        resp.setContentType("text/html;charset=UTF-8");
        PrintWriter out = resp.getWriter();
        out.println("进入 Servlet 的时间：" + new Date() + ".");
        out.flush();

        // 启动异步处理
        AsyncContext ctx = req.startAsync();
        // 执行异步业务逻辑
        new Thread(new AsyncTask(ctx)).start();

        out.println("结束 Servlet 的时间：" + new Date() + ".");
        out.flush();
    }
}

class AsyncTask implements Runnable {
    private AsyncContext ctx;

    public AsyncTask(AsyncContext ctx) {
        this.ctx = ctx;
    }

    @Override
    public void run() {
        try {
            // 模拟耗时业务操作，这里等待 5 秒
            Thread.sleep(5000);
            PrintWriter out = ctx.getResponse().getWriter();
            out.println("业务处理完毕的时间：" + new Date() + ".");
            out.flush();
            ctx.complete();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

配置方式
- 使用传统 web.xml 配置时，在 <servlet> 标签中添加 <async-supported>true</async-supported> 子标签。
- 使用注解配置时，在 @WebServlet 或 @WebFilter 注解中设置 asyncSupported = true。

（二）新增的注解支持

简化配置
Servlet 3.0 新增了多个注解，用于简化 Servlet、过滤器和监听器的声明，使 web.xml 部署描述文件不再是必选的。
常用注解介绍
- @WebServlet：用于将类声明为 Servlet，可配置名称、URL 匹配模式、加载顺序、初始化参数、异步支持等属性。
```
@WebServlet(urlPatterns = {"/demoServlet"}, asyncSupported = true, loadOnStartup = 1, name = "DemoServlet", displayName = "DS", initParams = {@WebInitParam(name = "param1", value = "value1")})
public class DemoServlet extends HttpServlet {...}
```
- @WebFilter：用于声明过滤器，可配置过滤器名称、URL 匹配模式、应用的 Servlet、转发模式、初始化参数、异步支持等属性。
```
@WebFilter(servletNames = {"DemoServlet"}, filterName = "DemoFilter")
public class DemoFilter implements Filter {...}
```
- @WebListener：用于将类声明为监听器，被标注的类需实现至少一个相关接口，如 ServletContextListener 等。
```
@WebListener("This is a demo listener")
public class SimpleListener implements ServletContextListener {...}
```
- @MultipartConfig：辅助 HttpServletRequest 对上传文件的支持。标注在 Servlet 上，表示希望处理的请求的 MIME 类型是 multipart/form-data，并可配置文件大小阈值、存放地址、允许上传的最大值等属性。
```
@MultipartConfig(fileSizeThreshold = 1024 * 1024, location = "/tmp/uploads", maxFileSize = 1024 * 1024 * 5, maxRequestSize = 1024 * 1024 * 10)
@WebServlet("/uploadServlet")
public class UploadServlet extends HttpServlet {...}
```

（三）可插性支持

功能扩充方式
可插性支持允许在不修改已有 Web 应用的前提下，将通过一定格式打包的 JAR 包放到 WEB-INF/lib 目录下，实现新功能的扩充。

web-fragment.xml 文件
Servlet 3.0 引入了 web-fragment.xml 部署描述文件，存放在 JAR 文件的 META-INF 目录下，可包含 web.xml 中能定义的内容。示例如下：

<?xml version="1.0" encoding="UTF-8"?>
<web-fragment xmlns="http://java.sun.com/xml/ns/javaee"
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="3.0"
               xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-fragment_3_0.xsd"
               metadata-complete="true">
    <servlet>
        <servlet-name>FragmentServlet</servlet-name>
        <servlet-class>com.example.FragmentServlet</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>FragmentServlet</servlet-name>
        <url-pattern>/fragment</url-pattern>
    </servlet-mapping>
</web-fragment>

加载顺序规则
web-fragment.xml 包含 <name> 和 <ordering> 两个可选顶层标签，用于指定加载顺序。<name> 标识文件，<ordering> 通过 <after> 和 <before> 子标签指定与其他文件的相对位置关系，还可使用 <others/> 表示除自身外的其他文件，其优先级低于明确指定的相对位置关系。

（四）ServletContext 的性能增强

动态部署与配置
ServletContext 对象在 Servlet 3.0 中支持在运行时动态部署 Servlet、过滤器、监听器，以及为 Servlet 和过滤器增加 URL 映射等。例如，动态添加 Servlet：

ServletContext context = getServletContext();
ServletRegistration.Dynamic dynamicServlet = context.addServlet("DynamicServlet", DynamicServlet.class);
dynamicServlet.addMapping("/dynamic");
dynamicServlet.setLoadOnStartup(2);

与相关接口和类的配合
这些动态配置方法通常在 ServletContextListener 的 contextInitialized 方法或 ServletContainerInitializer 的 onStartup() 方法中调用。ServletContainerInitializer 是 Servlet 3.0 新增接口，容器启动时使用 JAR 服务 API 发现其实现类，并将 WEB-INF/lib 目录下 JAR 包中的类交给 onStartup() 方法处理，通常需使用 @HandlesTypes 注解指定处理的类。

（五）HttpServletRequest 对文件上传的支持

简化文件上传操作
Servlet 3.0 之前，处理上传文件需使用第三方框架。现在 HttpServletRequest 提供了 getPart() 和 getParts() 方法用于从请求中解析上传文件。每个文件用 javax.servlet.http.Part 对象表示，该接口提供了处理文件的简易方法，如 write()、delete() 等。示例如下：

import javax.servlet.ServletException;
import javax.servlet.annotation.MultipartConfig;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import javax.servlet.http.Part;
import java.io.IOException;

@WebServlet("/upload")
@MultipartConfig
public class FileUploadServlet extends HttpServlet {
    @Override
    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        Part filePart = request.getPart("file");
        if (filePart != null) {
            filePart.write("/tmp/uploadedFile.txt");
            response.getWriter().println("文件上传成功");
        } else {
            response.getWriter().println("没有选择文件上传");
        }
    }
}

配置与注意事项
需配合 @MultipartConfig 注解对上传操作进行自定义配置，如限制文件大小和保存路径等。注意，如果请求的 MIME 类型不是 multipart/form-data，使用上述方法会抛出异常。

四、Servlet 在实际应用中的场景与案例分析

（一）在 Web 应用中的常见应用场景

处理用户请求与业务逻辑
Servlet 可接收用户在浏览器中输入的 URL 请求，根据请求参数进行业务逻辑处理，如登录验证、数据查询与更新等。例如，在电商网站中，LoginServlet 接收用户名和密码，与数据库中的用户信息进行比对，验证用户身份。
生成动态页面内容
通过获取数据库数据或其他业务逻辑处理结果，Servlet 可以动态生成 HTML、XML 等格式的页面内容返回给客户端。比如，新闻网站的 NewsServlet 根据用户请求的新闻类别，从数据库中查询相关新闻数据，然后生成包含新闻列表的 HTML 页面返回给用户。

（二）案例分析：使用 Servlet 实现简单的用户登录系统

功能需求
用户在登录页面输入用户名和密码，点击登录按钮后，请求发送到服务器端的 LoginServlet。LoginServlet 验证用户名和密码是否正确：如果正确，跳转到欢迎页面；如果错误，返回错误提示信息到登录页面。

代码实现

登录页面（login.jsp）

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html>
<head>
<title>Login Page</title>
</head>
<body>
<h1>Login</h1>
<form action="login" method="post">
    <label for="username">Username:</label><input type="text" id="username" name="username"><br>
    <label for="password">Password:</label><input type="password" id="password" name="password"><br>
    <input type="submit" value="Login">
</form>
</body>
</html>

LoginServlet.java

import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.PrintWriter;

public class LoginServlet extends HttpServlet {
@Override
protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
    // 设置响应内容类型为 HTML
    response.setContentType("text/html");
    
    // 获取用户名和密码
    String username = request.getParameter("username");
    String password = request.getParameter("password");

    // 假设这里进行简单的用户名和密码验证，实际应用中应与数据库比对
    if ("admin".equals(username) && "123456".equals(password)) {
        // 登录成功，将用户名存入 Session 后跳转到欢迎页面
        request.getSession().setAttribute("username", username);
        response.sendRedirect("welcome.jsp");
    } else {
        // 登录失败，返回错误提示
        PrintWriter out = response.getWriter();
        out.println("<html><body>");
        out.println("<h1>Login Failed</h1>");
        out.println("<p>Invalid username or password.</p>");
        out.println("</body></html>");
    }
}
}

web.xml 配置

<servlet>
<servlet-name>LoginServlet</servlet-name>
<servlet-class>com.example.LoginServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>LoginServlet</servlet-name>
<url-pattern>/login</url-pattern>
</servlet-mapping>

欢迎页面（welcome.jsp）

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html>
<head>
<title>Welcome</title>
</head>
<body>
<!-- 从 Session 中获取用户名，避免重定向后参数丢失 -->
<h1>Welcome, <%= session.getAttribute("username") %>!</h1>
</body>
</html>

通过这个案例，可以看到 Servlet 在处理用户请求、验证用户身份以及控制页面跳转等方面的实际应用。它是构建 Java Web 应用的重要基础组件，在实际开发中还有更多复杂和高级的应用场景等待开发者去探索和实践。

五、总结与展望

Servlet 作为 Java Web 开发的核心技术之一，在服务器端处理请求和生成响应方面有着不可替代的作用。从其基本的工作原理、生命周期到配置使用，再到 Servlet 3.0 带来的一系列新特性（如异步处理、注解配置、动态注册等），都为 Java Web 开发提供了更强大、更灵活的工具。在实际应用中，它广泛应用于各种 Web 系统的构建，从简单的网站到复杂的企业级应用。

随着技术的不断发展，Servlet 规范也在持续演进。未来可能会在性能优化、与新兴技术的融合等方面有更多的突破。开发者需要持续关注其发展动态，以便更好地利用 Servlet 构建高效、稳定的 Web 应用。

说明：本文主要基于 Servlet 3.0 规范及 javax.servlet 包进行讲解。自 Jakarta EE 9 起，Servlet 规范已迁移至 jakarta.servlet 包下（如 Servlet 5.0/6.0），但核心生命周期与工作原理保持一致。在实际开发中，请根据所使用的 Java EE 或 Jakarta EE 版本选择对应的依赖包。

本文地址：https://1diff.fun/archives/shen-ru-li-jie-servlet-cong-ji-chu-gai-nian-dao-gao-ji-te-xing-yu-shi-zhan-ying-yong.html

如果对本文有什么问题或疑问都可以在评论区留言，我看到后会尽量解答。