Java监听器该如何配置才能正确监听到事件？

在Java企业级应用开发中，监听器是一个不可或缺的组件，它扮演着“事件观察者”的角色，其核心思想是基于观察者设计模式，允许开发者在特定对象（如ServletContext、HttpSession）的生命周期发生变化或其属性发生增删改时，执行预先定义好的代码逻辑，这种机制极大地增强了应用的灵活性和可扩展性，使得系统初始化、资源管理、用户行为统计等横切关注点能够与核心业务逻辑解耦。

核心概念：观察者模式

监听器的实现根植于观察者模式，该模式定义了对象之间一种一对多的依赖关系，当一个对象（被观察者/事件源）的状态发生改变时，所有依赖于它的对象（观察者/监听器）都将得到通知并自动更新，在Java Web环境中，Servlet容器就是事件源，它会触发各种事件，而我们编写的监听器类则是观察者,负责响应这些事件。

Servlet监听器的主要类型

Servlet规范中定义了多种监听器接口，主要可以按照监听对象和事件类型进行划分，最常用的是监听三大域对象（ServletContext, HttpSession, ServletRequest）生命周期的监听器。

主要监听器接口详解

ServletContextListener
这是最核心的监听器之一，用于监听Web应用的启动与关闭，它在整个应用中只有一个实例,常用于执行全局性的初始化和清理工作。

• contextInitialized(ServletContextEvent sce): 在Web应用启动，ServletContext对象创建后调用，非常适合在此加载配置文件、初始化数据库连接池、创建全局缓存等。
• contextDestroyed(ServletContextEvent sce): 在Web应用关闭，ServletContext对象销毁前调用，适合用于释放资源、关闭连接、保存缓存数据等。

HttpSessionListener
用于监听用户会话（HttpSession）的创建与销毁,是实现在线用户统计等功能的基础。

• sessionCreated(HttpSessionEvent se): 当一个新的会话被创建时调用（用户首次访问）。
• sessionDestroyed(HttpSessionEvent se): 当会话失效（超时或调用invalidate()方法）时调用。

ServletRequestListener
用于监听每一个HTTP请求的生命周期,从请求开始到结束。

• requestInitialized(ServletRequestEvent sre): 当容器准备好一个请求时调用。
• requestDestroyed(ServletRequestEvent sre): 当请求处理完毕，即将被销毁时调用，常用于记录请求日志、计算请求处理耗时等。

配置监听器的方式

在Java Web应用中，配置监听器主要有两种方式：注解配置和web.xml配置。

使用@WebListener注解（推荐）

这是Servlet 3.0及以上版本推荐的现代化配置方式，简洁明了，只需在自定义的监听器类上添加@WebListener注解即可。

import javax.servlet.ServletContextEvent;
import javax.servlet.ServletContextListener;
import javax.servlet.annotation.WebListener;
@WebListener
public class MyApplicationListener implements ServletContextListener {
    @Override
    public void contextInitialized(ServletContextEvent sce) {
        System.out.println("Web应用启动，执行初始化操作...");
        // 加载数据库配置
        sce.getServletContext().setAttribute("appStartTime", System.currentTimeMillis());
    }
    @Override
    public void contextDestroyed(ServletContextEvent sce) {
        System.out.println("Web应用关闭，执行清理操作...");
        // 关闭资源
    }
}

使用web.xml配置文件

这是传统的配置方式,对于需要在不修改代码的情况下调整监听器顺序或禁用某个监听器的场景依然有用。

在WEB-INF/web.xml文件中添加<listener>

<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">
    <display-name>MyWebApp</display-name>
    <!-- 配置监听器 -->
    <listener>
        <listener-class>com.example.MyApplicationListener</listener-class>
    </listener>
</web-app>