JSP 过滤器

作者likuolei

JSP 过滤器

关键点

  • 研究表明，JSP 过滤器是 Java Servlet 技术的一部分，用于在请求到达 JSP/Servlet 或响应发送到客户端之前拦截和处理请求/响应。
  • 证据显示，过滤器通过实现 javax.servlet.Filter 接口定义，可用于日志记录、安全验证、数据压缩等。
  • 看起来，过滤器在 web.xml 中配置或通过注解定义，链式处理请求和响应。

JSP 过滤器概述
JSP 过滤器（“JSP 过滤器”）是 Java Web 应用中用于拦截和处理 HTTP 请求及响应的组件。它们可以在请求到达 JSP 或 Servlet 之前，或响应发送到客户端之前，执行预处理或后处理任务。过滤器适合用于日志记录、权限验证、字符编码设置等场景。

过滤器工作原理

  • 拦截请求：过滤器在请求到达目标资源（如 JSP 或 Servlet）之前处理请求。
  • 拦截响应：过滤器在响应返回客户端之前处理响应内容。
  • 链式处理：多个过滤器可以组成过滤器链，按配置顺序执行。

核心接口与方法
过滤器通过实现 javax.servlet.Filter 接口创建，包含三个主要方法：

  • init(FilterConfig config)：初始化过滤器，启动时调用。
  • doFilter(ServletRequest request, ServletResponse response, FilterChain chain)：执行过滤逻辑，处理请求/响应。
  • destroy()：销毁过滤器，释放资源。

示例
以下是一个简单的字符编码过滤器示例：
“`java
import javax.servlet.*;
import java.io.IOException;

public class CharsetFilter implements Filter {
public void init(FilterConfig config) throws ServletException {
// 初始化代码
}

public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)  
        throws IOException, ServletException {  
    request.setCharacterEncoding("UTF-8");  
    response.setContentType("text/html; charset=UTF-8");  
    chain.doFilter(request, response); // 继续处理请求  
}  

public void destroy() {  
    // 清理代码  
}

}

**web.xml 配置**

xml
CharsetFilter com.example.CharsetFilter CharsetFilter /*

**参考资料**  
- [菜鸟教程 - JSP 过滤器](https://www.runoob.com/jsp/jsp-filter.html)  
- [W3CSchool - JSP 过滤器](https://www.w3cschool.cn/jsp/jsp-filter.html)

---

### JSP 过滤器详解

JavaServer Pages（JSP）是一种服务器端技术，用于创建动态网页，通过在 HTML 中嵌入 Java 代码生成动态内容。JSP 过滤器（“JSP 过滤器”）是 Java Servlet 技术的一部分，用于在 HTTP 请求到达 JSP/Servlet 或响应发送到客户端之前拦截和处理请求/响应。以下是基于 2025 年 7 月 30 日的最新技术文档和可靠来源的详细分析。

#### 背景与定义  
JSP 由 Sun Microsystems 于 1999 年发布，是一种扩展 Java Servlet 的技术。过滤器是 Servlet 规范（`javax.servlet` 包）的一部分，JSP 作为 Servlet 的扩展也支持过滤器。过滤器通过实现 `javax.servlet.Filter` 接口定义，运行在 Web 容器（如 Apache Tomcat）中，用于拦截请求和响应，执行预处理或后处理任务。过滤器广泛应用于日志记录、权限验证、字符编码设置、数据压缩等场景。

#### 过滤器的工作原理  
过滤器的工作基于拦截器模式，位于客户端和目标资源（如 JSP 或 Servlet）之间。它的核心流程如下：  
1. **请求拦截**：客户端发送 HTTP 请求，过滤器在请求到达目标资源前进行处理。  
2. **执行逻辑**：过滤器可以修改请求参数、验证权限、记录日志等。  
3. **链式处理**：通过 `FilterChain` 的 `doFilter` 方法将请求传递给下一个过滤器或目标资源。  
4. **响应拦截**：目标资源生成响应后，过滤器可以修改响应内容或头信息。  
5. **响应返回**：最终响应发送到客户端。

过滤器链允许多个过滤器按配置顺序依次处理请求和响应，每个过滤器都可以决定是否继续传递请求。

#### 过滤器的核心接口与方法  
过滤器通过实现 `javax.servlet.Filter` 接口创建，包含以下三个核心方法：

| 方法 | 描述 |
|------|------|
| `init(FilterConfig config)` | 在 Web 容器启动时调用，用于初始化过滤器，获取配置信息。 |
| `doFilter(ServletRequest request, ServletResponse response, FilterChain chain)` | 每次请求时调用，执行过滤逻辑，`chain.doFilter` 将请求传递给链中的下一个过滤器或目标资源。 |
| `destroy()` | 在过滤器销毁时调用，释放资源，如关闭数据库连接。 |

#### 过滤器的常见用途  
根据菜鸟教程和 W3CSchool，过滤器的常见用途包括：  
- **认证过滤器**：验证用户身份，限制对资源的访问。  
- **日志记录**：记录请求信息，如客户端 IP、请求时间。  
- **字符编码**：统一设置请求和响应的字符编码，解决中文乱码问题。  
- **数据压缩**：压缩响应数据，减少传输时间。  
- **加密/解密**：对请求或响应数据进行加密处理。  
- **XSS 过滤**：过滤用户输入，防止跨站脚本攻击。  
- **缓存过滤**：缓存响应数据，提高性能。  

#### 配置过滤器  
过滤器可以通过两种方式配置：`web.xml` 文件或注解。

1. **web.xml 配置**  
   在 `WEB-INF/web.xml` 文件中定义过滤器及其映射：

xml
CharsetFilter com.example.CharsetFilter CharsetFilter /*

   - `<filter>`：定义过滤器名称和类。  
   - `<filter-mapping>`：指定过滤器应用的 URL 模式，`/*` 表示所有请求。  

2. **注解配置**（Servlet 3.0+）  
   使用 `@WebFilter` 注解直接在过滤器类中定义：

java
import javax.servlet.*;
import javax.servlet.annotation.WebFilter;
import java.io.IOException;

@WebFilter(urlPatterns = “/*”)
public class CharsetFilter implements Filter {
public void init(FilterConfig config) throws ServletException {
}

   public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)  
           throws IOException, ServletException {  
       request.setCharacterEncoding("UTF-8");  
       response.setContentType("text/html; charset=UTF-8");  
       chain.doFilter(request, response);  
   }  

   public void destroy() {  
   }

}

#### 示例：字符编码过滤器  
以下是一个完整的字符编码过滤器示例，用于解决中文乱码问题：

**过滤器代码**

java
package com.example;
import javax.servlet.*;
import java.io.IOException;

public class CharsetFilter implements Filter {
public void init(FilterConfig config) throws ServletException {
// 初始化逻辑
}

public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)  
        throws IOException, ServletException {  
    // 设置请求和响应编码  
    request.setCharacterEncoding("UTF-8");  
    response.setContentType("text/html; charset=UTF-8");  
    // 继续处理请求  
    chain.doFilter(request, response);  
}  

public void destroy() {  
    // 清理逻辑  
}

}

**web.xml 配置**

xml
CharsetFilter com.example.CharsetFilter CharsetFilter /*

**JSP 页面示例**

jsp
<%@ page language=”java” contentType=”text/html; charset=UTF-8″ pageEncoding=”UTF-8″%>
JSP 表单处理

表单提交

用户名: <% String username = request.getParameter(“username”); if (username != null) { out.println(“用户名: ” + username); } %>

**代码解释**  
- 过滤器 `CharsetFilter` 在请求到达 JSP 之前设置编码为 UTF-8，确保中文表单数据正确解析。  
- `chain.doFilter(request, response)` 将处理后的请求传递给下一个过滤器或目标 JSP。  
- JSP 页面通过 `request.getParameter` 获取表单数据，输出到页面。

#### 示例：权限验证过滤器  
以下是一个权限验证过滤器的示例，检查用户是否登录：

java
package com.example;
import javax.servlet.; import javax.servlet.http.;
import java.io.IOException;

public class AuthFilter implements Filter {
public void init(FilterConfig config) throws ServletException {
}

public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain)  
        throws IOException, ServletException {  
    HttpServletRequest request = (HttpServletRequest) req;  
    HttpServletResponse response = (HttpServletResponse) resp;  
    HttpSession session = request.getSession(false);  

    // 检查会话中是否有用户  
    if (session == null || session.getAttribute("user") == null) {  
        response.sendRedirect("login.jsp");  
    } else {  
        chain.doFilter(request, response);  
    }  
}  

public void destroy() {  
}

}

**web.xml 配置**

xml
AuthFilter com.example.AuthFilter AuthFilter /secure/*
“`

代码解释

  • 过滤器检查会话中是否存储了用户信息（session.getAttribute("user")）。
  • 如果用户未登录，请求被重定向到 login.jsp；否则，继续处理请求。
  • <url-pattern>/secure/*</url-pattern> 限制过滤器只应用于 /secure/ 路径下的资源。

实践与优势

JSP 过滤器的优点在于其模块化和可重用性，允许开发者将通用逻辑（如编码设置、权限验证）从 JSP 或 Servlet 中分离出来，降低代码耦合。过滤器链支持按顺序处理请求，灵活性高。JSP 的平台无关性支持“一次编写，随处运行”的理念，适合企业级 Web 应用开发。

注意事项

  • 过滤器顺序：在 web.xml 中，过滤器的映射顺序决定了执行顺序。
  • 性能影响：过多或复杂的过滤器可能增加请求处理时间，需优化逻辑。
  • 作用域：过滤器应用于配置的 URL 模式，/* 表示所有请求，需谨慎使用。
  • 中文乱码：字符编码过滤器是解决中文乱码的常用方案，建议在过滤器链的开头应用。

参考资料

以上内容基于 2025 年 7 月 30 日的最新技术文档，确保信息的准确性和全面性。

类似文章

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注