拦截过滤器模式

约 607 字大约 2 分钟

设计模式

2018-05-05

什么是拦截过滤器模式？

Interceptor(拦截过滤器)模式是一种结构型设计模式。

它用于在请求处理流程中动态添加预处理（如验证、日志）和后处理逻辑。它通过可插拔的过滤器链在核心业务逻辑执行前后拦截请求/响应，实现横切关注点（Cross-Cutting Concerns）的解耦。

它主要由四个部分组成：

过滤器（Filter）

执行具体拦截任务的独立模块（如身份验证、日志记录）。

过滤器链（Filter Chain）

管理过滤器的有序执行，控制流程传递。

目标对象（Target）

核心业务逻辑（如 API 处理器）。

过滤器管理器（Filter Manager）

创建和组装过滤器链（可选）。

实现拦截过滤器模式

创建过滤器接口

class Filter {
  execute(request, response, chain) {
    throw new Error('execute() must be implemented')
  }
}

实现具体过滤器

// 身份验证过滤器
class AuthFilter extends Filter {
  execute(request, response, chain) {
    console.log('AuthFilter: Checking authentication')
    if (!request.headers.token) {
      throw new Error('Unauthorized!')
    }
    chain.execute(request, response) // 传递到下一个过滤器
  }
}

// 日志过滤器
class LogFilter extends Filter {
  execute(request, response, chain) {
    console.log(`LogFilter: ${request.url} at ${new Date()}`)
    chainexecute(request, response)
    consolelog('LogFilter: Response sent')
  }
}

创建过滤器链

class FilterChain {
  constructor() {
    this.filters = []
    this.target = null
  }

  addFilter(filter) {
    this.filters.push(filter)
    return this // 支持链式调用
  }

  setTarget(target) {
    this.target = target
  }

  execute(request, response) {
    if (this.filters.length === 0) {
      this.target?.execute(request, response)
      return
    }

    const [currentFilter, ...remainingFilters] = this.filters
    const nextChain = new FilterChain()
    nextChain.filters = remainingFilters
    nextChain.target = this.target

    currentFilter.execute(request, response, nextChain)
  }
}

目标对象（业务逻辑）

class ApiHandler {
  execute(request, response) {
    console.log('Processing API request')
    response.status = 200
    response.body = { data: 'Success' }
  }
}

客户端使用

// 组装过滤器链
const chain = new FilterChain()
chain
  .addFilter(new AuthFilter())
  .addFilter(new LogFilter())
  .setTarget(new ApiHandler())

// 模拟请求
const request = { url: '/api/data', headers: { token: 'abc123' } }
const response = {}

try {
  chain.execute(request, response)
  console.log('Response:', response)
}
catch (err) {
  console.error('Error:', err.message)
}

// 输出顺序:
// AuthFilter: Checking authentication
// LogFilter: /api/data at [timestamp]
// Processing API request
// LogFilter: Response sent
// Response: { status: 200, body: { data: "Success" } }

优点

解耦性
业务逻辑与横切关注点（如日志、安全）分离。
可复用性
过滤器可在不同场景重复使用。
灵活扩展
动态增删过滤器，无需修改核心代码。
职责清晰
每个过滤器专注单一任务。

缺点

性能开销
链式调用增加额外处理时间。
调试复杂度
多级过滤增加调试难度。
过度设计风险
简单场景可能引入不必要的复杂性。