4.5 Web 应用生命周期管理

文档摘要

4.5 Web 应用生命周期管理 4.5 Web 应用生命周期管理在Tomcat等Servlet容器中，Web应用的生命周期管理是至关重要的环节。它确保了Web应用能够正确地启动、运行、更新和停止，同时有效地管理服务器资源。理解Web应用的生命周期，对于开发高效、稳定、可维护的Web应用至关重要。本章节将深入探讨Tomcat中Web应用的生命周期，包括各个阶段、关键事件以及如何通过代码和配置来管理这些生命周期阶段。 4.5.1 Web 应用生命周期阶段一个Web应用在Tomcat容器中经历以下几个主要的生命周期阶段：加载 (Loading / Deployment)：当Tomcat服务器启动时，或者当新的Web应用部署到Tomcat时，会触发加载阶段。

4.5 Web 应用生命周期管理

在Tomcat等Servlet容器中，Web应用的生命周期管理是至关重要的环节。它确保了Web应用能够正确地启动、运行、更新和停止，同时有效地管理服务器资源。理解Web应用的生命周期，对于开发高效、稳定、可维护的Web应用至关重要。本章节将深入探讨Tomcat中Web应用的生命周期，包括各个阶段、关键事件以及如何通过代码和配置来管理这些生命周期阶段。

4.5.1 Web 应用生命周期阶段

一个Web应用在Tomcat容器中经历以下几个主要的生命周期阶段：

加载 (Loading / Deployment)：
- 当Tomcat服务器启动时，或者当新的Web应用部署到Tomcat时，会触发加载阶段。
- Tomcat会读取Web应用的部署描述符（web.xml）以及注解配置，解析Web应用的结构和组件。
- 创建代表Web应用的 ServletContext 对象，这是整个Web应用的上下文环境。
- 初始化监听器（Listeners），例如 ServletContextListener，并调用其 contextInitialized() 方法。
- 根据配置，实例化和初始化Servlet，Filter等Web组件。可以配置Servlet的加载时机（例如，在启动时加载或首次请求时加载）。
- 将Web应用相关的资源（例如静态文件、JSP页面）准备就绪。
服务 (Service / In Service)：
- Web应用加载完成后，进入服务阶段，此时应用可以接收和处理客户端的请求。
- 当客户端发送HTTP请求到达Tomcat时，Tomcat根据请求的URL匹配到对应的Servlet或资源。
- 通过Filter链对请求进行预处理和后处理。
- Servlet的 service() 方法被调用来处理请求，并生成响应。
- Tomcat将响应返回给客户端。
- 在服务阶段，Web应用持续运行，响应来自用户的各种请求。
卸载 (Unloading / Undeployment)：
- 当Tomcat服务器关闭，或者Web应用被显式地从Tomcat中卸载时，会触发卸载阶段。
- Tomcat首先通知所有监听器，例如 ServletContextListener，调用其 contextDestroyed() 方法，允许监听器执行清理操作。
- 销毁所有已加载的Servlet和Filter实例，调用它们的 destroy() 方法，释放它们占用的资源。
- 移除 ServletContext 对象，使其失效。
- 清理Web应用相关的资源，例如释放数据库连接、关闭文件句柄等。
- Web应用从Tomcat容器中移除，停止服务。

可以使用 Mermaid 绘制 Web 应用生命周期状态图：

4.5.2 Web 应用生命周期事件和监听器

Tomcat通过一系列事件来通知Web应用生命周期状态的变化。Web应用可以通过注册监听器来监听这些事件，并在事件发生时执行相应的操作。常见的生命周期监听器包括：

ServletContextListener:
- 监听 ServletContext 的生命周期事件，即Web应用的启动和停止事件。
- 接口方法：
  - contextInitialized(ServletContextEvent sce): 在Web应用加载完成后，ServletContext 初始化时被调用。
  - contextDestroyed(ServletContextEvent sce): 在Web应用卸载前，ServletContext 即将被销毁时被调用。
- 作用：用于在Web应用启动时执行初始化操作（例如，加载配置文件、建立数据库连接、初始化共享资源）和在Web应用停止时执行清理操作（例如，释放资源、关闭连接、持久化数据）。
ServletRequestListener:
- 监听Servlet请求的创建和销毁事件。
- 接口方法：
  - requestInitialized(ServletRequestEvent sre): 在Servlet容器准备开始处理一个Servlet请求时被调用，在请求进入Filter链之前。
  - requestDestroyed(ServletRequestEvent sre): 在Servlet容器完成处理一个Servlet请求之后，响应发送给客户端之后被调用，在请求离开Filter链之后。
- 作用：用于在请求开始时进行一些准备工作（例如，记录请求开始时间、设置请求编码）和在请求结束时进行一些清理工作（例如，记录请求处理时间、清理线程本地变量）。
HttpSessionListener:
- 监听HttpSession的创建和销毁事件。
- 接口方法：
  - sessionCreated(HttpSessionEvent se): 在新的HttpSession被创建时调用。例如，当用户首次访问Web应用并需要创建会话时。
  - sessionDestroyed(HttpSessionEvent se): 在HttpSession失效或超时时，或者Web应用被卸载时调用。
- 作用：用于跟踪会话的创建和销毁，例如统计在线用户数、清理会话相关的资源。
ServletAttributeListener, ServletContextAttributeListener, HttpSessionAttributeListener, ServletRequestAttributeListener:
- 这些监听器监听不同作用域（Servlet, ServletContext, HttpSession, ServletRequest）属性的添加、移除和替换事件。
- 接口方法：
  - attributeAdded(XXXAttributeEvent event): 当属性被添加到作用域时调用。
  - attributeRemoved(XXXAttributeEvent event): 当属性从作用域中移除时调用。
  - attributeReplaced(XXXAttributeEvent event): 当作用域中已存在的属性被替换时调用。
- 作用：用于监控和响应属性的变化，例如实现审计日志、缓存管理、会话管理等。

4.5.3 代码实践：Web 应用生命周期监听器

以下代码示例展示了如何实现 ServletContextListener 和 HttpSessionListener，并观察Web应用的生命周期事件。

1. 创建监听器类:


package com.example.listener;
import javax.servlet.ServletContextEvent;
import javax.servlet.ServletContextListener;
import javax.servlet.http.HttpSessionEvent;
import javax.servlet.http.HttpSessionListener;
public class MyLifecycleListener implements ServletContextListener, HttpSessionListener {
    private static int activeSessions = 0;
    // ServletContextListener 方法
    @Override
    public void contextInitialized(ServletContextEvent sce) {
        System.out.println("ServletContext 初始化...");
        // 在Web应用启动时执行初始化操作，例如加载配置
        String contextPath = sce.getServletContext().getContextPath();
        System.out.println("Web应用 Context Path: " + contextPath);
        // 可以从ServletContext中获取初始化参数
        String initParam = sce.getServletContext().getInitParameter("appConfig");
        System.out.println("初始化参数 appConfig: " + initParam);
        // 初始化全局资源，例如数据库连接池
        System.out.println("全局资源初始化完成。");
    }
    @Override
    public void contextDestroyed(ServletContextEvent sce) {
        System.out.println("ServletContext 销毁...");
        // 在Web应用停止时执行清理操作，例如释放资源
        System.out.println("释放全局资源...");
        System.out.println("全局资源释放完成。");
    }
    // HttpSessionListener 方法
    @Override
    public void sessionCreated(HttpSessionEvent se) {
        activeSessions++;
        System.out.println("HttpSession 创建，当前会话数: " + activeSessions);
        // 可以将会话信息记录到日志或数据库
        String sessionId = se.getSession().getId();
        System.out.println("Session ID: " + sessionId);
    }
    @Override
    public void sessionDestroyed(HttpSessionEvent se) {
        activeSessions--;
        System.out.println("HttpSession 销毁，当前会话数: " + activeSessions);
        // 清理会话相关的资源
        String sessionId = se.getSession().getId();
        System.out.println("Session ID 销毁: " + sessionId);
    }
}

2. 配置监听器 (web.xml):

在 web.xml 部署描述符中声明监听器：


<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">
    <context-param>
        <param-name>appConfig</param-name>
        <param-value>config/app.properties</param-value>
    </context-param>
    <listener>
        <listener-class>com.example.listener.MyLifecycleListener</listener-class>
    </listener>
    <!-- 其他 Servlet, Filter 配置 -->
</web-app>

3. 部署和测试:

将上述代码打包成WAR文件，部署到Tomcat服务器。启动Tomcat服务器，观察控制台输出。访问Web应用，创建会话，然后停止Tomcat服务器或卸载Web应用，再次观察控制台输出。

预期控制台输出 (部分):

Tomcat 启动，Web应用加载时：


ServletContext 初始化...
Web应用 Context Path: /your-webapp-context-path
初始化参数 appConfig: config/app.properties
全局资源初始化完成。

用户首次访问Web应用，创建会话时：


HttpSession 创建，当前会话数: 1
Session ID: <session-id>

用户会话超时或失效，会话销毁时：


HttpSession 销毁，当前会话数: 0
Session ID 销毁: <session-id>

Tomcat 关闭或 Web应用卸载时：


ServletContext 销毁...
释放全局资源...
全局资源释放完成。

4. 其他监听器实践 (简要说明):

ServletRequestListener: 可以创建一个类实现 ServletRequestListener，并重写 requestInitialized 和 requestDestroyed 方法，然后在 web.xml 中配置 <listener>。在方法中可以获取 ServletRequestEvent 对象，从而访问 ServletRequest 和 ServletContext，进行请求级别的操作，例如记录请求日志。
HttpSessionAttributeListener: 创建一个类实现 HttpSessionAttributeListener，并重写 attributeAdded, attributeRemoved, attributeReplaced 方法。在方法中可以获取 HttpSessionBindingEvent 对象，从而访问属性名和属性值，进行会话属性变更的监控和处理，例如实现会话属性变更审计。

4.5.4 内容详解：深入理解生命周期管理

ServletContext 的作用:
- ServletContext 是Web应用的上下文环境，每个Web应用在Tomcat中都有一个唯一的 ServletContext 实例。
- 它提供了访问Web应用全局资源和配置信息的入口，例如初始化参数、上下文路径、Web应用的根目录等。
- Web应用中的所有Servlet、Filter、Listener等组件共享同一个 ServletContext 对象，可以通过它进行组件之间的协作和数据共享。
- ServletContext 在Web应用启动时创建，在Web应用卸载时销毁，它的生命周期与Web应用的生命周期一致。
Servlet 的生命周期:
- 加载和初始化 (Instantiation and Initialization): Servlet 类被加载，Servlet 实例被创建（通常在首次请求或服务器启动时，取决于配置），然后Servlet容器调用 init(ServletConfig config) 方法进行初始化。ServletConfig 包含了Servlet的初始化参数和 ServletContext。init() 方法只在Servlet生命周期中被调用一次。
- 服务 (Service): 当Servlet容器接收到客户端请求时，会调用Servlet的 service(ServletRequest req, ServletResponse res) 方法来处理请求。service() 方法会根据HTTP请求的方法（GET, POST等）调用 doGet(), doPost() 等方法。service() 方法会被多次调用，处理来自客户端的多个请求。
- 销毁 (Destruction): 当Servlet需要从服务中移除时（例如，Web应用卸载或Tomcat关闭），Servlet容器会调用 destroy() 方法，允许Servlet释放资源、清理状态。destroy() 方法也只在Servlet生命周期中被调用一次，在Servlet实例被垃圾回收之前调用。
Filter 的生命周期:
- 加载和初始化 (Instantiation and Initialization): Filter 类被加载，Filter 实例被创建（通常在Web应用启动时），然后Filter容器调用 init(FilterConfig filterConfig) 方法进行初始化。FilterConfig 包含了Filter的初始化参数和 ServletContext。init() 方法只在Filter生命周期中被调用一次。
- 过滤 (Filtering): 当客户端请求访问受保护的资源时，Filter容器会调用Filter的 doFilter(ServletRequest request, ServletResponse response, FilterChain chain) 方法进行过滤。doFilter() 方法可以检查请求、修改请求和响应，并决定是否将请求传递给FilterChain中的下一个Filter或目标Servlet。doFilter() 方法会被多次调用，处理匹配的请求。
- 销毁 (Destruction): 当Filter需要从服务中移除时（例如，Web应用卸载或Tomcat关闭），Filter容器会调用 destroy() 方法，允许Filter释放资源、清理状态。destroy() 方法也只在Filter生命周期中被调用一次，在Filter实例被垃圾回收之前调用。
会话 (HttpSession) 的生命周期:
- 创建 (Creation): 当用户首次访问Web应用，并且服务器需要为用户维护会话状态时，Servlet容器会自动创建一个 HttpSession 对象。可以通过 request.getSession() 方法获取会话。
- 激活 (Active): 会话在创建后处于激活状态，可以存储和检索用户会话数据。会话保持激活状态的时间取决于会话超时设置（可以在 web.xml 或 Tomcat 的 context.xml 中配置）。
- 钝化 (Passivation - 可选): 在集群环境中，为了实现会话复制和故障转移，Servlet容器可能会将长时间不活动的会话钝化到持久存储（例如，磁盘或数据库）。钝化是将HttpSession对象序列化并存储的过程。
- 活化 (Activation - 可选): 当用户再次访问Web应用，并且需要访问之前钝化的会话时，Servlet容器会从持久存储中活化会话。活化是将HttpSession对象反序列化并恢复到内存的过程。
- 失效 (Invalidation): 会话在以下情况下失效：
  - 会话超时：如果会话在一段时间内没有被访问，Servlet容器会使会话超时失效。
  - 程序显式失效：通过调用 session.invalidate() 方法可以立即使会话失效。
  - Web应用卸载或Tomcat关闭：当Web应用卸载或Tomcat关闭时，所有会话都会被销毁。
- 销毁 (Destruction): 当HttpSession失效时，Servlet容器会触发 HttpSessionListener.sessionDestroyed() 事件，并回收HttpSession对象。

4.5.5 最佳实践和注意事项

资源管理: 在 contextInitialized() 和 init() 方法中初始化资源（例如数据库连接池、线程池、缓存），并在 contextDestroyed() 和 destroy() 方法中释放这些资源，避免资源泄露。
启动和关闭时间优化: Web应用的启动和关闭时间影响用户体验和服务器维护。
- 延迟加载: 对于非关键的Servlet，可以配置为延迟加载（lazy-loading），只在首次请求时才初始化，缩短启动时间。
- 异步初始化: 对于耗时的初始化任务，可以考虑使用异步线程来执行，避免阻塞主线程，加快启动速度。
- 快速关闭: 确保 destroy() 和 contextDestroyed() 方法能够快速完成资源释放，缩短关闭时间。
错误处理: 在生命周期事件处理方法中（例如监听器方法、init()、destroy()），要进行适当的异常处理，避免因为一个组件的初始化或销毁失败导致整个Web应用启动或停止失败。
会话管理: 合理配置会话超时时间，避免会话占用过多内存资源。对于不需要会话的应用，可以禁用会话创建。在集群环境中，要考虑会话复制和持久化策略，确保会话的可靠性和可用性。
监听器的使用: 合理使用监听器来处理生命周期事件，例如初始化全局配置、监控应用状态、清理资源。避免在监听器中执行过于复杂的业务逻辑，保持监听器的简洁和高效。
部署描述符和注解: 可以使用 web.xml 部署描述符或Servlet 3.0+ 的注解来配置Servlet、Filter、Listener等组件。选择合适的配置方式，保持配置的一致性和可维护性。
热部署和热加载: 在开发环境中，可以利用Tomcat的热部署和热加载功能，快速迭代和测试Web应用。但要注意热部署可能会导致类加载器泄露和内存溢出，在生产环境中要谨慎使用。

4.5.6 总结

Web应用的生命周期管理是Tomcat等Servlet容器的核心功能之一。理解Web应用的生命周期阶段、事件和监听器，掌握Servlet、Filter、HttpSession的生命周期，并遵循最佳实践，可以帮助开发者构建高效、稳定、可靠的Web应用。通过合理地管理Web应用的生命周期，可以有效地利用服务器资源，提升应用性能，并简化应用的部署和维护。本章节深入探讨了Web应用生命周期管理的各个方面，并提供了代码示例和实践指导，希望读者能够深入理解并应用到实际的Web应用开发中。

作者与出处

原作者：灏天文库

来源：灏天文库

原文： https://aiknowledge.cn/collection/182-tomcat-web%E6%9C%8D%E5%8A%A1%E5%99%A8%E9%85%8D%E7%BD%AE%E4%B8%8E%E7%AE%A1%E7%90%86

整理：灏天文库整理

由灏天文库平台收录，内容或由平台用户上传，仅供学习交流