Servlet 包（手把手讲解）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;演示链接： http://116.62.199.48:7070 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

前言：Servlet 包在 Java Web 开发中的核心地位

在 Java Web 开发领域，Servlet 包（通常指 javax.servlet 包及其子包）如同一座连接客户端与服务器端的桥梁，它为开发者提供了处理 HTTP 请求与响应的核心工具。无论是构建简单的网页应用，还是开发复杂的分布式系统，Servlet 包都是不可或缺的基础组件。对于编程初学者而言，理解其原理与用法，可以快速搭建起 Web 开发的思维框架；对于中级开发者，深入掌握其高级特性，能显著提升代码的健壮性与扩展性。

本文将从 Servlet 的基础概念出发，逐步解析 Servlet 包的核心功能、生命周期、配置方法，以及实际开发中的典型应用场景，帮助读者系统性地掌握这一技术。

Servlet 的核心概念与工作原理

什么是 Servlet？

Servlet 是 Java 语言实现的一个接口，用于处理动态 Web 请求。它运行在支持 Java 的服务器（如 Tomcat、Jetty）上，能够接收 HTTP 请求，执行业务逻辑，最后生成 HTTP 响应返回给客户端。

形象地说，Servlet 就像一家快递公司的分拣中心：当客户端（如浏览器）发出请求（包裹），Servlet 根据地址（URL）将请求分发到对应的处理逻辑（分拣流程），最终生成响应（包裹送达）。

Servlet 包的功能定位

Servlet 包主要包含以下核心功能：

1. 请求处理：解析 HTTP 方法（GET、POST 等）、URL 路径、请求头与参数。
2. 响应生成：设置响应状态码、内容类型，以及返回 HTML、JSON 等格式的数据。
3. 生命周期管理：通过 init()、service()、destroy() 方法控制对象的创建、运行与销毁。
4. 会话跟踪：利用 HttpSession 对象维护用户会话状态。

一个简单的 Servlet 示例

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

@WebServlet("/hello")
public class HelloServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response) 
        throws IOException {
        response.setContentType("text/html");
        response.getWriter().println("<h1>Hello, Servlet World!</h1>");
    }
}

这段代码定义了一个处理 /hello 路径 GET 请求的 Servlet，返回简单的 HTML 内容。

Servlet 包的组成与核心类解析

Servlet 包主要由以下核心类与接口构成：

核心接口与类

常用工具类

• ServletConfig：存储 Servlet 的配置参数（如初始化参数）。
• ServletContext：提供对整个 Web 应用的上下文信息访问（如资源路径、共享数据）。
• HttpSession：管理用户会话状态，支持跨请求数据共享。

Servlet 的生命周期详解

Servlet 的生命周期由服务器严格控制，主要分为三个阶段：

1. 初始化阶段（init()）

当服务器首次接收到针对某个 URL 的请求，或在启动时根据配置加载 Servlet 时，会调用 init() 方法。此方法用于执行一次性的初始化操作，如加载配置文件、建立数据库连接。

@Override
public void init() throws ServletException {
    // 读取初始化参数
    String configPath = getServletConfig().getInitParameter("config");
    // 加载配置文件
    loadConfig(configPath);
}

2. 服务阶段（service()）

service() 方法是 Servlet 的核心入口，它根据请求的 HTTP 方法（GET/POST 等）自动调用对应的 doGet()、doPost() 方法。

protected void service(HttpServletRequest req, HttpServletResponse resp) 
    throws ServletException, IOException {
    String method = req.getMethod();
    if ("GET".equals(method)) {
        doGet(req, resp);
    } else if ("POST".equals(method)) {
        doPost(req, resp);
    }
}

3. 销毁阶段（destroy()）

当服务器决定卸载或终止 Servlet 时，会调用 destroy() 方法，用于释放资源（如关闭数据库连接、保存临时数据）。

@Override
public void destroy() {
    saveSessionData();
    dbConnection.close();
}

配置 Servlet 的两种方式

Servlet 的配置决定了其在服务器中的行为，常见的配置方式有两种：

1. 通过 web.xml 文件配置

在 web.xml 中，通过 <servlet> 和 <servlet-mapping> 标签定义 Servlet 的名称、类路径和 URL 映射。

<servlet>
    <servlet-name>HelloServlet</servlet-name>
    <servlet-class>com.example.HelloServlet</servlet-class>
    <init-param>
        <param-name>config</param-name>
        <param-value>/WEB-INF/config.properties</param-value>
    </init-param>
</servlet>
<servlet-mapping>
    <servlet-name>HelloServlet</servlet-name>
    <url-pattern>/hello</url-pattern>
</servlet-mapping>

2. 使用注解配置（@WebServlet）

通过 @WebServlet 注解直接在类上定义 URL 映射和初始化参数，代码更简洁：

@WebServlet(
    urlPatterns={"/hello", "/hi"},
    initParams={@WebInitParam(name="config", value="/WEB-INF/config.properties")}
)
public class HelloServlet extends HttpServlet { /* ... */ }

Servlet 包的高级特性与最佳实践

1. 处理请求参数

通过 HttpServletRequest 可以获取请求中的参数、头信息等：

// 获取单个参数
String username = request.getParameter("username");

// 获取多个同名参数
String[] hobbies = request.getParameterValues("hobby");

// 获取请求头
String userAgent = request.getHeader("User-Agent");

2. 重定向与转发

• 重定向：通过 sendRedirect() 让浏览器跳转到新 URL，属于客户端跳转。

  response.sendRedirect("/login");
  

• 转发：通过 RequestDispatcher 在服务器内部跳转，保留请求上下文。

  RequestDispatcher dispatcher = request.getRequestDispatcher("/success.jsp");
  dispatcher.forward(request, response);
  

3. 处理会话状态

使用 HttpSession 可以在多个请求间共享数据：

// 存储用户信息
HttpSession session = request.getSession();
session.setAttribute("user", user);

// 获取用户信息
User currentUser = (User) session.getAttribute("user");

实战案例：构建用户登录功能

需求描述

实现一个简单的用户登录页面，包含以下功能：

1. 用户输入用户名和密码，提交表单。
2. 验证凭证后，重定向到欢迎页面。
3. 若验证失败，返回错误提示。

实现步骤

1. 创建登录页面（login.html）

<form action="/login" method="post">
    用户名：<input type="text" name="username"><br>
    密码：<input type="password" name="password"><br>
    <input type="submit" value="登录">
</form>

2. 编写登录处理 Servlet

@WebServlet("/login")
public class LoginServlet extends HttpServlet {
    @Override
    protected void doPost(HttpServletRequest req, HttpServletResponse resp) 
        throws ServletException, IOException {
        String username = req.getParameter("username");
        String password = req.getParameter("password");
        
        if ("admin".equals(username) && "123456".equals(password)) {
            // 记录用户登录状态
            req.getSession().setAttribute("user", username);
            resp.sendRedirect("/welcome");
        } else {
            req.setAttribute("error", "用户名或密码错误");
            RequestDispatcher dispatcher = req.getRequestDispatcher("/login.html");
            dispatcher.forward(req, resp);
        }
    }
}

3. 欢迎页面（welcome.jsp）

<%@ page contentType="text/html;charset=UTF-8" %>
<html>
<body>
    <h1>欢迎，${user}！</h1>
    <a href="/logout">退出登录</a>
</body>
</html>

常见问题与解决方案

Q1：Servlet 映射冲突如何处理？

解答：

• 确保 @WebServlet 注解或 web.xml 中的 URL 模式无重复。
• 使用通配符路径时，注意优先级（如 /api/* 会覆盖 /api/v1）。

Q2：Servlet 多线程安全问题

解答：
Servlet 是单实例多线程运行的，因此需避免在成员变量中存储非线程安全的数据。例如，以下代码会导致并发问题：

// 错误示例：成员变量可能被多个线程修改
private int counter = 0;

protected void doGet(HttpServletRequest req, HttpServletResponse resp) {
    counter++;
    // ...
}

解决方案：
使用局部变量或线程安全的集合，或通过 synchronized 关键字控制访问。

Q3：如何调试 Servlet？

解答：

• 在代码中添加日志输出（推荐使用 SLF4J 或 Log4j）。
• 利用 IDE 的 Debug 模式设置断点。
• 检查服务器日志文件（如 Tomcat 的 catalina.out）。

结论：掌握 Servlet 包，构建高效 Web 应用

Servlet 包作为 Java Web 开发的基石，其核心机制与高级特性为开发者提供了强大的工具支持。从基础的请求处理到复杂的会话管理，从简单的页面跳转到复杂的业务逻辑，Servlet 的灵活性与扩展性始终是构建现代 Web 应用的可靠保障。

对于初学者，建议从编写第一个 Hello World 示例开始，逐步探索其生命周期与配置方式；中级开发者则可以深入研究线程安全、性能优化等进阶主题。随着对 Servlet 包的掌握，开发者将能够更从容地应对各类 Web 开发挑战，并为后续学习 Spring MVC、Spring Boot 等框架打下坚实基础。

在实践中，建议读者通过实际项目反复演练，例如搭建用户注册系统、博客平台等，以巩固对 Servlet 包的理解。通过不断迭代与优化，您将逐渐成长为一名成熟的 Java Web 开发者。