董云舟1. JavaWeb三大核心组件概述
在JavaWeb开发领域，Servlet、Filter和Listener构成了最基础的三大组件，它们就像建筑中的钢筋骨架，支撑着整个Web应用的运行机制。我刚开始接触JavaWeb时，常常分不清这三者的区别和适用场景，直到在实际项目中踩过几次坑后才真正理解它们的协作关系。
Servlet是处理HTTP请求的核心处理器，每个请求最终都会到达某个Servlet进行业务处理；Filter则像安检通道，对请求进行预处理或后处理；Listener则是系统的"耳朵"，监听各种事件的发生。这三者共同构成了JavaWeb应用的请求处理管道（Pipeline），理解它们的交互方式对构建健壮的Web应用至关重要。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. Servlet深度解析
2.1 Servlet生命周期与工作原理
Servlet的生命周期由容器（如Tomcat）管理，主要包括三个阶段：
- 初始化：容器调用init()方法，通常在此加载资源
- 服务：每次请求调用service()方法（实际开发中更多用doGet/doPost）
- 销毁：容器调用destroy()方法释放资源
一个典型的Servlet类结构如下：
java复制public class MyServlet extends HttpServlet {
@Override
public void init() throws ServletException {
// 初始化代码
}
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) {
// 处理GET请求
}
@Override
public void destroy() {
// 资源清理
}
}
提示：避免在Servlet中定义实例变量，因为Servlet是单例的，可能引发线程安全问题。我在早期项目中就曾因此出现数据错乱。
2.2 Servlet配置的两种方式
现代JavaWeb项目通常使用注解配置：
java复制@WebServlet("/user")
public class UserServlet extends HttpServlet {
// ...
}
传统方式是在web.xml中配置：
xml复制<servlet>
<servlet-name>userServlet</servlet-name>
<servlet-class>com.example.UserServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>userServlet</servlet-name>
<url-pattern>/user</url-pattern>
</servlet-mapping>
2.3 Servlet 3.0+的异步处理
对于耗时操作，可以使用异步Servlet避免线程阻塞：
java复制@WebServlet(urlPatterns = "/async", asyncSupported = true)
public class AsyncServlet extends HttpServlet {
protected void doGet(HttpServletRequest req, HttpServletResponse resp) {
AsyncContext ctx = req.startAsync();
// 将任务提交到线程池
executor.submit(() -> {
// 耗时操作
ctx.complete();
});
}
}
3. Filter过滤器详解
3.1 Filter的工作原理
Filter采用责任链模式，可以串联多个过滤器。一个请求可能经过这样的处理流程：
code复制客户端 → Filter1 → Filter2 → Servlet → Filter2 → Filter1 → 客户端
我在日志记录、权限校验、编码设置等场景都大量使用Filter。比如设置统一编码：
java复制@WebFilter("/*")
public class EncodingFilter implements Filter {
public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) {
req.setCharacterEncoding("UTF-8");
resp.setCharacterEncoding("UTF-8");
chain.doFilter(req, resp); // 传递给下一个过滤器或Servlet
}
}
3.2 常见Filter应用场景
| 场景类型 | 实现方式 | 注意事项 |
|---|---|---|
| 权限控制 | 检查Session/Cookie | 排除登录/注册等URL |
| 日志记录 | 记录请求参数和耗时 | 注意性能影响 |
| 数据压缩 | 包装Response对象 | 检查Accept-Encoding头 |
| XSS防护 | 过滤请求参数 | 注意转义规则 |
3.3 Filter的初始化参数
可以通过@WebFilter的initParams或web.xml配置参数：
java复制@WebFilter(
urlPatterns = "/*",
initParams = @WebInitParam(name = "exclusions", value = "/static/*")
)
在Filter中通过FilterConfig获取参数：
java复制String exclusions = filterConfig.getInitParameter("exclusions");
4. Listener监听器实战
4.1 常用监听器类型
JavaWeb提供了多种监听器接口，主要分为三类：
-
ServletContext监听器
- ServletContextListener：应用启动/销毁
- ServletContextAttributeListener：属性变更
-
Session监听器
- HttpSessionListener：Session创建/销毁
- HttpSessionAttributeListener：Session属性变更
-
Request监听器
- ServletRequestListener：请求初始/完成
- ServletRequestAttributeListener：请求属性变更
4.2 典型应用案例
初始化数据库连接池：
java复制@WebListener
public class AppContextListener implements ServletContextListener {
public void contextInitialized(ServletContextEvent sce) {
// 初始化连接池
DataSource ds = createDataSource();
sce.getServletContext().setAttribute("DBPool", ds);
}
public void contextDestroyed(ServletContextEvent sce) {
// 关闭连接池
DataSource ds = (DataSource)sce.getServletContext().getAttribute("DBPool");
if(ds != null) ds.close();
}
}
统计在线人数：
java复制@WebListener
public class SessionCounter implements HttpSessionListener {
private static final AtomicInteger count = new AtomicInteger();
public void sessionCreated(HttpSessionEvent se) {
count.incrementAndGet();
se.getSession().getServletContext().setAttribute("onlineUsers", count);
}
public void sessionDestroyed(HttpSessionEvent se) {
count.decrementAndGet();
}
}
5. 三大组件的交互与整合
5.1 执行顺序与优先级
在web.xml中，组件的加载顺序为：
- Listener → 2. Filter → 3. Servlet
通过@WebServlet等注解配置时，顺序是不确定的。如果需要确保顺序，应该：
- 使用web.xml显式配置
- 或者实现ServletContainerInitializer
5.2 组件间通信方式
-
ServletContext共享：适合全局数据
java复制// 设置 getServletContext().setAttribute("key", value); // 获取 Object value = getServletContext().getAttribute("key"); -
Request传递：适合请求级数据
java复制// Filter中设置 request.setAttribute("key", value); // Servlet中获取 Object value = request.getAttribute("key"); -
Session存储：适合用户会话数据
java复制// 设置 request.getSession().setAttribute("user", userObj); // 获取 User user = (User)request.getSession().getAttribute("user");
5.3 性能优化实践
-
Servlet优化：
- 使用异步处理耗时操作
- 避免在service方法中同步代码块
-
Filter优化：
- 尽早过滤无效请求（如权限校验）
- 对静态资源设置exclusions
-
Listener优化：
- 避免在监听器中实现复杂逻辑
- 考虑事件处理的异步化
6. 常见问题排查与调试
6.1 典型问题与解决方案
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 404错误 | URL映射错误 | 检查@WebServlet注解或web.xml配置 |
| 过滤器不生效 | 顺序问题或URL模式不匹配 | 调整filter-mapping顺序或检查urlPatterns |
| 监听器未执行 | 未正确配置或加载顺序问题 | 确保@WebListener或web.xml配置正确 |
| 内存泄漏 | 未正确清理资源 | 检查destroy()方法和监听器的资源释放 |
6.2 调试技巧
-
日志输出：
java复制// 在Servlet/Filter的各个生命周期方法中添加日志 System.out.println("MyFilter initialized"); // 生产环境应使用日志框架 -
断点调试：
- 在IDEA/Eclipse中配置远程调试
- 对init(), doFilter(), service()等方法设置断点
-
请求追踪：
java复制// 在Filter中记录请求信息 String path = ((HttpServletRequest)request).getRequestURI(); System.out.println("Request path: " + path);
7. 现代JavaWeb架构中的演进
虽然Servlet API仍然是JavaWeb的基础，但在Spring等现代框架中，这些组件的使用方式发生了变化：
- Servlet的替代：Spring MVC的@Controller
- Filter的替代：Spring的HandlerInterceptor
- Listener的替代：Spring的事件机制
但理解原生组件的工作原理，对于：
- 排查框架底层问题
- 自定义扩展框架功能
- 维护传统项目
仍然非常重要。
我在迁移老项目到Spring Boot时，就遇到过需要混合使用Servlet和Spring MVC的情况。这时清晰理解各组件的生命周期和交互方式就派上了大用场。