Java Web 基础：Servlet 详解与实战

📅 2026-05-26 🔄 更新：2026-05-30 👁 3 阅读 Java Web 基础

Servlet 是 Java Web 开发的核心组件。本文将深入解析 Servlet 的工作原理、生命周期及常用方法，并通过实战案例展示其应用。

468 × 60 文章顶部广告 QEG44JER

引言 / 什么是 Servlet

在 Java Web 开发中，Servlet 是处理 HTTP 请求和响应的核心组件。它作为服务器端程序，能够动态生成网页内容、处理表单数据、管理会话状态等。无论是传统的 JSP/Servlet 架构，还是现代框架（如 Spring MVC）的底层，Servlet 都扮演着关键角色。

Servlet 的核心优势在于其跨平台性和与 Java 生态的无缝集成。通过标准化的接口（javax.servlet），开发者可以专注于业务逻辑，而无需关心底层网络通信细节。本文将系统讲解 Servlet 的工作原理、生命周期及实战用法，帮助你快速掌握这一基础技术。

Servlet 的工作原理

Servlet 运行在 Servlet 容器（如 Tomcat、Jetty）中，其工作流程可分为以下步骤：

客户端请求：用户通过浏览器发送 HTTP 请求（如访问 /login）。
容器接收请求：Servlet 容器（如 Tomcat）解析请求，创建 HttpServletRequest 和 HttpServletResponse 对象。
路由匹配：容器根据 web.xml 或注解（如 @WebServlet）找到对应的 Servlet 类。
实例化与初始化：若 Servlet 未实例化，容器会调用其 init() 方法完成初始化。
处理请求：容器调用 Servlet 的 service() 方法，根据请求类型（GET/POST）分发到 doGet() 或 doPost()。
生成响应：Servlet 将处理结果写入 HttpServletResponse，容器将其返回给客户端。

提示：Servlet 是单例多线程的，即一个 Servlet 实例可能同时处理多个请求。因此，避免在 Servlet 中使用实例变量存储用户数据，以防线程安全问题。

Servlet 的生命周期

Servlet 的生命周期由容器管理，包含三个关键阶段：

1. 初始化阶段：`init()`

当 Servlet 首次被请求或容器启动时，容器会调用 init(ServletConfig config) 方法完成初始化。ServletConfig 对象提供初始化参数（通过 web.xml 配置）：

<!-- web.xml 配置示例 -->
<servlet>
    <servlet-name>DemoServlet</servlet-name>
    <servlet-class>com.example.DemoServlet</servlet-class>
    <init-param>
        <param-name>dbUrl</param-name>
        <param-value>jdbc:mysql://localhost:3306/test</param-value>
    </init-param>
</servlet>

在代码中获取参数：

public void init(ServletConfig config) throws ServletException {
    String dbUrl = config.getInitParameter("dbUrl");
    System.out.println("Database URL: " + dbUrl);
}

2. 服务阶段：`service()`

每次请求到达时，容器调用 service(ServletRequest req, ServletResponse res) 方法，并根据请求类型（GET/POST）分发到 doGet() 或 doPost()。典型实现如下：

protected void doGet(HttpServletRequest req, HttpServletResponse resp) 
    throws ServletException, IOException {
    resp.setContentType("text/html");
    PrintWriter out = resp.getWriter();
    out.println("<h1>Hello, Servlet!</h1>");
}

3. 销毁阶段：`destroy()`

当容器关闭或 Servlet 被移除时，调用 destroy() 方法释放资源（如关闭数据库连接）：

public void destroy() {
    System.out.println("Servlet is being destroyed.");
}

实战案例：用户登录功能

下面通过一个完整的登录案例，演示 Servlet 如何处理表单提交和会话管理。

步骤一：创建登录表单（HTML）

<!-- login.html -->
<form action="/login" method="post">
    <input type="text" name="username" placeholder="用户名">
    <input type="password" name="password" placeholder="密码">
    <button type="submit">登录</button>
</form>

步骤二：编写 LoginServlet

@WebServlet("/login")
public class LoginServlet extends HttpServlet {
    protected void doPost(HttpServletRequest req, HttpServletResponse resp) 
        throws ServletException, IOException {
        
        // 1. 获取表单数据
        String username = req.getParameter("username");
        String password = req.getParameter("password");

        // 2. 简单验证（实际项目中应查询数据库）
        if ("admin".equals(username) && "123456".equals(password)) {
            // 3. 创建会话并存储用户信息
            HttpSession session = req.getSession();
            session.setAttribute("user", username);

            // 4. 重定向到欢迎页
            resp.sendRedirect("welcome.jsp");
        } else {
            // 5. 返回错误信息
            resp.setContentType("text/html");
            resp.getWriter().println("用户名或密码错误！");
        }
    }
}

步骤三：欢迎页（JSP）

<%-- welcome.jsp --%>
<%@ page contentType="text/html;charset=UTF-8" %>
<html>
<body>
    <h1>欢迎, <%= session.getAttribute("user") %>!</h1>
    <a href="/logout">退出登录</a>
</body>
</html>

步骤四：退出登录（LogoutServlet）

@WebServlet("/logout")
public class LogoutServlet extends HttpServlet {
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) 
        throws ServletException, IOException {
        // 销毁会话
        req.getSession().invalidate();
        resp.sendRedirect("login.html");
    }
}

进阶技巧

1. 使用过滤器（Filter）预处理请求

过滤器可在请求到达 Servlet 前拦截处理，常用于权限校验、日志记录等：

@WebFilter("/*")
public class AuthFilter implements Filter {
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) 
        throws IOException, ServletException {
        
        HttpServletRequest req = (HttpServletRequest) request;
        HttpSession session = req.getSession(false);
        
        if (session == null || session.getAttribute("user") == null) {
            ((HttpServletResponse) response).sendRedirect("login.html");
        } else {
            chain.doFilter(request, response);
        }
    }
}

2. 配置 Servlet 初始化参数

除了 web.xml，也可通过注解配置初始化参数：

@WebServlet(
    urlPatterns = "/demo",
    initParams = {
        @WebInitParam(name = "env", value = "production")
    }
)
public class DemoServlet extends HttpServlet {
    // ...
}

3. 异步处理请求（Servlet 3.0+）

对于耗时操作（如文件上传），可使用异步 Servlet 避免线程阻塞：

@WebServlet(urlPatterns = "/async", asyncSupported = true)
public class AsyncServlet extends HttpServlet {
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) {
        AsyncContext asyncCtx = req.startAsync();
        new Thread(() -> {
            try {
                Thread.sleep(3000); // 模拟耗时操作
                asyncCtx.getResponse().getWriter().write("Async complete!");
                asyncCtx.complete();
            } catch (Exception e) {
                e.printStackTrace();
            }
        }).start();
    }
}

常见问题

Q：Servlet 和 JSP 有什么区别？
A：Servlet 是 Java 类，擅长处理业务逻辑；JSP 是文本文件，本质是编译为 Servlet 的模板，擅长生成动态页面。通常结合使用：Servlet 处理请求，JSP 渲染视图。

Q：如何解决 Servlet 的中文乱码问题？
A：在获取请求参数或写入响应前，设置字符编码：

// 请求乱码（POST）
req.setCharacterEncoding("UTF-8");
// 响应乱码
resp.setContentType("text/html;charset=UTF-8");

Q：Servlet 是否支持 RESTful 风格？
A：支持。通过 @PathParam（需配合 JAX-RS）或手动解析 URL 路径实现。现代框架（如 Spring MVC）提供了更简洁的注解（如 @RequestMapping）。

小结

本文系统讲解了 Servlet 的核心概念：从工作原理、生命周期到实战案例，覆盖了表单处理、会话管理、过滤器等关键技术。作为 Java Web 开发的基石，掌握 Servlet 有助于深入理解 Spring 等框架的底层机制。建议通过以下步骤巩固学习：

搭建本地 Tomcat 环境，运行本文案例。
尝试扩展登录功能（如连接数据库验证用户）。
学习 Servlet 3.0+ 的新特性（如注解配置、异步处理）。

Servlet 虽然“古老”，但仍是理解 Web 开发的绝佳入口。动手实践吧！

468 × 60 文章底部广告 7XM2LNHL

🏷 标签：实战案例后端开发 Java Web Servlet 生命周期

📚 同系列教程

Java Web 基础：JSP 技术全解析

引言 / 什么是 Servlet

Servlet 的工作原理

Servlet 的生命周期

1. 初始化阶段：init()

2. 服务阶段：service()

3. 销毁阶段：destroy()

实战案例：用户登录功能

步骤一：创建登录表单（HTML）

步骤二：编写 LoginServlet

步骤三：欢迎页（JSP）

步骤四：退出登录（LogoutServlet）

进阶技巧

1. 使用过滤器（Filter）预处理请求

2. 配置 Servlet 初始化参数

3. 异步处理请求（Servlet 3.0+）

常见问题

小结

📚 同系列教程

🗂 相关分类

💡 推荐阅读

Java Web 基础：JSP 技术全解析

Word长文档如何快速生成目录？超详细教程

Excel错误值处理的7个实用技巧

Word段落格式设置：让文档结构更清晰

Photoshop入门教程：PS基础操作完全指南

PowerPoint动画优化：如何提升动画的流畅度和自然度？

如何用AI工具快速生成短视频封面和标题？

AE关键帧速度控制：打造个性化动画节奏

安卓手机实用技巧：让手机更好用的50个小技巧

Python 文件自动化处理：批量重命名技巧

Figma入门教程：UI设计从零开始

数据库备份与恢复自动化：提升效率的利器

VBA错误处理与调试：让Excel程序更稳定

PPT制作入门：从零开始做出好看的演示文稿

WPS Office完全使用指南

SQL 分组与排序：让数据更有条理

iOS系统设置：如何自定义通知显示方式？

iOS系统设置：如何管理存储空间和优化性能？

远程桌面故障排查与修复指南

VS Code插件推荐：提升开发效率的必备神器

广告投放和询

1. 初始化阶段：`init()`

2. 服务阶段：`service()`

3. 销毁阶段：`destroy()`