Java Web 基础：Servlet 详解与实战

📅 2026-05-26 🔄 更新：2026-05-30 👁 26 阅读 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 基础：Servlet 详解与实战

引言 / 什么是 Servlet

Servlet 的工作原理

Servlet 的生命周期

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

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

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

实战案例：用户登录功能

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

步骤二：编写 LoginServlet

步骤三：欢迎页（JSP）

步骤四：退出登录（LogoutServlet）

进阶技巧

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

2. 配置 Servlet 初始化参数

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

常见问题

小结

📚 同系列教程

广告投放和询

引言 / 什么是 Servlet

Servlet 的工作原理

Servlet 的生命周期

1. 初始化阶段：init()

2. 服务阶段：service()

3. 销毁阶段：destroy()

实战案例：用户登录功能

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

步骤二：编写 LoginServlet

步骤三：欢迎页（JSP）

步骤四：退出登录（LogoutServlet）

进阶技巧

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

2. 配置 Servlet 初始化参数

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

常见问题

小结

📚 同系列教程

🗂 相关分类

💡 推荐阅读

Java Web 基础：JSP 技术全解析

Java Web 基础：MVC 设计模式解析

Java Web 基础：数据库连接与操作指南

剪映模板素材哪里找？优质资源推荐

Android通知历史记录：轻松回顾错过的消息

批量打印入门：如何快速设置打印任务？

WPS演示图表制作技巧：数据可视化轻松搞定

如何通过外链（Backlinks）提升网站权重？

OBS 录屏软件安装全攻略：零基础快速上手

Excel打印高级技巧：如何打印网格线和批注？

AE预设应用指南：快速打造专业级视频

手机夜景拍摄全攻略：轻松拍出璀璨夜色

iOS系统设置：如何快速关闭后台应用刷新？

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

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

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

OBS场景与来源优化：提升录屏直播质量

Android系统设置进阶：提升手机性能的秘诀

隐私浏览模式真的完全安全吗？

数码配件保养与维护：延长使用寿命的小技巧

广告投放和询

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

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

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