Java框架快速入门: Spring MVC拦截器详解

【Handler】Spring MVC控制器详解 在Spring MVC中,Handler是一个用来处理HTTP请求的对象。它通常是一个控制器(Controller)类中的方法。当用户发送一个请求到服务器时,Spring MVC会根据请求的URL、HTTP方法等信息,找到相应的处理器(Handler)来处理这个请求。 阅读详情

本文纲要

  1. 拦截器概念
  2. 拦截器与过滤器的区别
  3. 拦截器入门案例
    项目结构
    第一步:编写拦截器类
    第二步:配置拦截器
    启动测试与流程分析
  4. 拦截器方法参数详解
  5. 拦截器链配置与执行顺序
    配置多个拦截器
    执行顺序规则
    中断场景分析
  6. 总结

拦截器概念

Spring MVC 拦截器(Interceptor)是一种动态拦截请求调用的机制,它可以在控制器(Controller)方法执行的前后插入自定义逻辑。功能主要包括:

  • 在方法执行前后增加通用处理(如日志记录、权限校验、性能监控等)
  • 根据条件决定是否放行请求,可以终止原始方法的执行

在传统的 Java Web 架构中,请求首先到达 Tomcat 容器,然后经由过滤器(Filter)链,最终进入 Spring MVC 的中央控制器(DispatcherServlet)分发到具体的 Controller。

拦截器就工作在 Spring MVC 体系内,靠近 Controller 执行的前后位置,因此它可以便捷地使用 Spring 容器中的各种资源。

拦截器与过滤器的区别

对比维度过滤器(Filter)拦截器(Interceptor)
归属技术Servlet 规范的一部分Spring MVC 提供的组件
作用范围可拦截所有进入 Web 容器的请求(包括静态资源)仅拦截进入 Spring MVC 的请求(由 DispatcherServlet 处理)
配置方式在 web.xml 中配置或通过 @WebFilter 注解在 Spring MVC 配置类中注册
生命周期由 Servlet 容器管理由 Spring 容器管理,可以注入其他 Bean
执行顺序基于配置顺序,执行链可以包装请求/响应通过配置顺序形成拦截器链,前置顺序依次执行,后置和完成顺序反向

拦截器入门案例

1 )项目结构

springmvc_12_interceptor 
├── pom.xml 
└── src 
    └── main 
        └── java 
            └── com.wb 
                ├── config 
                │   ├── ServletContainersInitConfig.java 
                │   ├── SpringMvcConfig.java 
                │   └── SpringMvcSupport.java 
                ├── controller 
                │   ├── BookController.java 
                │   └── interceptor 
                │       ├── ProjectInterceptor.java 
                │       └── ProjectInterceptor2.java 
                └── domain 
                    └── Book.java 

2 ) 第一步:编写拦截器类

实现 HandlerInterceptor 接口,并覆盖其三个方法。该类需受 Spring 容器管理,通常使用 @Component 注解。

package com.wb.controller.interceptor;
 
import org.springframework.stereotype.Component;
import org.springframework.web.method.HandlerMethod;
import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;
 
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
 
@Component 
public class ProjectInterceptor implements HandlerInterceptor {
    @Override 
    // 原始方法调用前执行,返回值决定是否放行 
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        String contentType = request.getHeader("Content-Type");
        HandlerMethod hm = (HandlerMethod) handler;
        System.out.println("preHandle..." + contentType);
        return true;  // 返回 true 放行,false 则终止后续操作 
    }
 
    @Override 
    // 原始方法调用后执行(在视图渲染之前)
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        System.out.println("postHandle...");
    }
 
    @Override 
    // 原始方法调用完成后执行(视图渲染之后)
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        System.out.println("afterCompletion...");
    }
}

3 ) 第二步:配置拦截器

有两种常见配置方式:

方式一:实现 WebMvcConfigurer 接口(推荐,代码侵入性较强但简洁)

package com.wb.config;
 
import com.wb.controller.interceptor.ProjectInterceptor;
import com.wb.controller.interceptor.ProjectInterceptor2;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
 
@Configuration 
@ComponentScan({"com.wb.controller"})
@EnableWebMvc 
public class SpringMvcConfig implements WebMvcConfigurer {
    @Autowired 
    private ProjectInterceptor projectInterceptor;
 
    @Autowired 
    private ProjectInterceptor2 projectInterceptor2;
 
    @Override 
    public void addInterceptors(InterceptorRegistry registry) {
        // 配置拦截器并指定拦截路径 
        registry.addInterceptor(projectInterceptor).addPathPatterns("/books", "/books/*");
        registry.addInterceptor(projectInterceptor2).addPathPatterns("/books", "/books/*");
    }
}

方式二:继承 WebMvcConfigurationSupport(可自定义更多底层配置)

package com.wb.config;
 
import com.wb.controller.interceptor.ProjectInterceptor;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurationSupport;
 
@Configuration 
public class SpringMvcSupport extends WebMvcConfigurationSupport {
    @Autowired 
    private ProjectInterceptor projectInterceptor;
 
    @Override 
    protected void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/pages/").addResourceLocations("/pages/");
    }
 
    @Override 
    protected void addInterceptors(InterceptorRegistry registry) {
        // 配置拦截器并指定拦截路径 
        registry.addInterceptor(projectInterceptor).addPathPatterns("/books", "/books/*");
    }
}

如果采用方式二,主配置类 SpringMvcConfig 就不需要实现 WebMvcConfigurer 接口,但要确保该类被 Spring 容器加载(例如在 ComponentScan 范围内或手动注册)。

核心配置说明

  • addInterceptor(xxx):注册拦截器实例。
  • addPathPatterns("/books", "/books/"):指定要拦截的请求路径,支持通配符 (单级)和 (多级)。

4 ) 启动测试与流程分析

启动后发起请求 POST /books,控制台输出:

preHandle...application/json 
book save...Book{书名='...', 价格=...}
postHandle...
afterCompletion...

单个拦截器的执行流程如下:

return true

return false

请求到达

执行 preHandle

执行 Controller 方法

执行 postHandle

视图渲染/响应处理

执行 afterCompletion

直接结束请求

响应返回

  • preHandle 返回 true:放行,正常执行后续步骤。
  • preHandle 返回 false:终止请求,不会调用 postHandle 和 afterCompletion(但会执行已经触发的拦截器的 afterCompletion,详见拦截器链部分)

拦截器方法参数详解

方法参数说明
preHandlerequest, response, handlerhandler 是 HandlerMethod 类型,封装了被拦截的 Controller 方法信息,可通过 (HandlerMethod) handler 获取方法名、参数等。
postHandlerequest, response, handler, modelAndViewmodelAndView 在前后端分离架构中很少使用(主要用于页面跳转)。
afterCompletionrequest, response, handler, exex 是控制器方法抛出的异常对象,可用于统一日志记录(但更推荐使用全局异常处理器)。

典型用法示例:

@Override 
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {
    // 获取请求头信息 
    String contentType = request.getHeader("Content-Type");
    // 获取方法信息 
    HandlerMethod hm = (HandlerMethod) handler;
    System.out.println("即将执行:" + hm.getMethod().getName());
    // 权限校验伪代码 
    if (/ 无权限 /) {
        return false; // 终止请求 
    }
    return true;
}

拦截器链配置与执行顺序

1 ) 配置多个拦截器

在配置类中继续调用 registry.addInterceptor() 即可添加多个拦截器:

@Override 
public void addInterceptors(InterceptorRegistry registry) {
    registry.addInterceptor(projectInterceptor).addPathPatterns("/books", "/books/*");
    registry.addInterceptor(projectInterceptor2).addPathPatterns("/books", "/books/*");
}

Interceptor2 示例:

package com.wb.controller.interceptor;
 
import org.springframework.stereotype.Component;
import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;
 
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
 
@Component 
public class ProjectInterceptor2 implements HandlerInterceptor {
    @Override 
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {
        System.out.println("preHandle...222");
        return false;   // 测试终止情况 
    }
 
    @Override 
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) {
        System.out.println("postHandle...222");
    }
 
    @Override 
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
        System.out.println("afterCompletion...222");
    }
}

执行顺序规则

  • 前置(preHandle):按照配置的先后顺序,依次执行。
  • 后置(postHandle):与前置顺序相反,即先配置的后执行。
  • 完成(afterCompletion):同样与前置顺序相反。

全部放行

请求

拦截器1 preHandle (true)

拦截器2 preHandle (true)

Controller

拦截器2 postHandle

拦截器1 postHandle

拦截器2 afterCompletion

拦截器1 afterCompletion

中断场景分析

如果在某个拦截器的 preHandle 中返回 false,则:

  • **随后所有拦截器的 preHandle 均不执行。
  • **所有拦截器的 postHandle 均不执行。
  • 只有在返回 false 的拦截器之前已经执行过 preHandle 的拦截器,其 afterCompletion 会执行(顺序依然反向)。

以拦截器1(true)、拦截器2(return false)为例:

请求

拦截器1 preHandle (true)

拦截器2 preHandle (return false)

❌ 后续 preHandle 全部跳过

❌ Controller 不执行

拦截器1 afterCompletion 执行

请求结束

从控制台输出会看到:

preHandle...          (拦截器1)
preHandle...222       (拦截器2)
afterCompletion...    (拦截器1)

afterCompletion...222 没有出现,因为拦截器2的 preHandle 返回 false 后,它自身的完成回调不会触发

总结

  • 拦截器是 Spring MVC 中用于增强 Controller 的组件,归属于 Spring 技术栈
  • 开发步骤:实现 HandlerInterceptor 接口 → 注册为 Spring Bean → 在配置类中注册并指定拦截路径
  • 单个拦截器的生命周期:preHandle → Controller → postHandle → afterCompletion
  • preHandle 的返回值控制请求是否继续;返回 false 会直接终止后续所有处理
  • 多拦截器形成“拦截器链”,执行顺序遵循“前置正序,后置和完成逆序”的栈式结构
  • 合理使用拦截器可以实现权限校验、日志记录、性能监控等切面功能,是面向切面编程在 Spring MVC 中的典型实践
Spring框架中的过滤器、拦截器与Spring Security:深入比较与应用实践 Spring框架是一个轻量级的开源Java平台,它为现代Java应用程序开发提供了全面的基础设施支持。Spring的核心特性包括依赖注入(DI)、面向切面编程(AOP)、事务管理、数据访问等,这些特性使得开发者能够构建松耦合、易于测试和维护的企业级应用。:提供IoC容器和依赖注入功能Spring AOP:提供面向切面编程实现Spring MVC:基于模型-视图-控制器模式的Web框架:认证和授权框架:简化数据访问操作:快速应用开发的约定优于配置解决方案。 阅读详情

相关推荐

Java开发 - Spring MVC框架初体验

写到这里,Spring MVC框架就跟大家分享完了,看到这里没你已经可以写一个简单的Spring MVC框架的项目了。甚至一些小的项目,使用这个框架也完全够了,只要有一台服务器,它就可以正常工作,给客户端提供服务。下一篇,咱们SSM框架见。

CodingFire的博客 2237

Spring+SpringMVC+MyBatis整合项目开发

Spring+SpringMVC+MyBatis框架变得越来越流行,简化开发流程 ,提高了开发效率。本文具有IOC、AOP、事务控制、拦截器的使用、文件上传、异常处理等案例讲解。

LYG优快云_的博客 5007

掌握Spring MVC拦截器:入门级实战范例

本文还有配套的精品资源,点击获取 简介:Spring MVC拦截器允许开发者在控制器处理请求前后执行自定义逻辑,如权限验证和日志记录。通过实现 HandlerInterceptor 接口或继承 AbstractHandlerInterceptor 类,开发者可以创建拦截器并实现三个主要方法: preHandle , post...

weixin_32099703的博客 1018

java openresty 调用_hades: 基于openresty、给java开发人员的mvc框架

hades,基于OpenResty的mvc框架简介OpenResty是一个基于 Nginx 与 Lua 的高性能 Web 平台,其内部集成了大量精良的 Lua 库、第三方模块以及大多数的依赖项。用于方便地搭建能够处理超高并发、扩展性极高的动态 Web 应用、Web 服务和动态网关。通过汇聚各种设计精良的 Nginx 模块(主要由 OpenResty 团队自主开发),从而将 Nginx 有效地变成一...

weixin_39588223的博客 591

Spring MVC入门实战:Hello World详解

Spring MVC 是 Spring 框架的重要组成部分,专为构建灵活、可维护的 Web 应用程序而设计,遵循经典的 MVC(Model-View-Controller)架构模式。该模式将业务逻辑(Model)、用户界面(View)和用户输入处理(Controller)分离,提升了代码的可读性与可测试性。

weixin_42298254的博客 1163

Auto.js凉了之后,我们该用啥?AutoX.js保姆级环境搭建与第一个脚本实战(2024最新)

本文详细介绍了AutoX.js作为Auto.js替代方案的环境搭建与脚本开发实战指南。从技术生态现状分析到2024最新环境配置,再到编写第一个实用脚本和进阶调试技巧,帮助开发者无缝迁移至AutoX.js平台。特别适合需要手机自动化的JavaScript开发者,涵盖从基础到企业级应用的全套解决方案。

weixin_28737073的博客 392

SpringMVC的介绍

学而时习之,不亦乐乎!

2301_79853526的博客 268

什么是无人机巡检?如何实现无人机自动巡检?

复亚智能的无人机自动巡检系统通过高度自动化的技术,实现了无人机的高效巡检作业。无人机自动机场支持无人机的自动起降和电池更换,自动飞行算法确保无人机在复杂环境中的精准飞行和拍摄,而云端识别诊断和AI感知算法平台则实现图像的实时传输和智能分析。复亚智能,作为无人机技术的创新者和推动者,致力于开发先进的无人机自动巡检解决方案,助力各行各业实现智能化、自动化的巡检工作,引领智能巡检的未来。利用人工智能和机器学习算法,无人机可以被训练来识别特定的模式和异常,如结构损坏、热泄漏等,从而提高巡检的准确性和效率。

foiadrone的博客 2845

Spring MVC 教程,快速入门,深入分析

Spring MVC 教程,快速入门,深入分析 [url]http://elf8848.iteye.com/blog/875830/[/url]

战斗机 128

RH850从0搭建Autosar开发环境【23】- Davinci Configurator之DCM实操实现DID的读取写入

RH850从0搭建Autosar开发环境【23】- Davinci Configurator之DCM实操实现DID的读取写入,结合Developer实现

weixin_42412049的博客 1812

把云端打印带回办公室:通信场景 SAP_COM_0466 打通 SAP BTP ABAP environment 与本地打印机的 Pull Integration 实战

摘要: 本文探讨云端SAP系统如何通过SAP_COM_0466通信场景实现与本地打印机的安全连接。核心方案采用Pull Integration模式,由本地组件(如SAP Cloud Print Manager或第三方OMS)主动从云端打印队列拉取任务,避免网络边界冲突。配置流程涵盖通信安排创建、打印队列绑定及权限管理,并强调队列类型必须选择"Pull Integration Queue"的关键细节。方案通过分离云端生产与本地打印环节,既保障安全性又便于运维监控,适用于SAP BTP AB

2007 年 ~ 2025 年,深耕 SAP 技术 18 年 147

4.2 SpringMVC 基础:Spring MVC项目的快速搭建

4.2 SpringMVC 基础:Spring MVC项目的快速搭建 4.2 SpringMVC项目的快速搭建

one_chao的博客 189

V90伺服 EPOS模式下回原(详细配置+SCL源代码)

/ 输出上限 100.0%rSetPoint : Real;// 设置目标值工程量。// 通道转换参考值。Td : Real;

RXXW_Dor的博客 2666

探索Java中最常用的框架:Spring、Spring MVC、Spring Boot、MyBatis和Netty

探索Java中最常用的框架:Spring、Spring MVC、Spring Boot、MyBatis和Netty

weixin_58070962的博客 9906

华为OD机试新系统真题【字符串压缩编码】

华为OD机试 新系统真题【字符串压缩编码】,提供C语言、Java、C++、Python、Go、JavaScript源码实现,并提供完整思路讲解,以及在线OJ模拟做题。华为OD机试真题【字符串压缩编码】多语言题解

qq_45776114的博客 356

YOLOv11涨点改进| TGRS 2026 | 独家创新首发、特征融合改进篇| 引入STSAM协同时空注意力融合模块,发论文热点创新,注意力能够互相引导强化边界和结构细节,增强目标检测、图像分割涨点

🔥本文提出了一种改进YOLOv11网络模型的STSAM协同时空注意力融合模块,用于提升高分辨率遥感变化检测的精度。STSAM通过并行处理全局跨时相注意力和局部坐标注意力,能有效聚焦真实变化目标,强化边界和结构细节。该模块包含两个分支:Cross-Attention分支通过时间嵌入增强双时相特征的时间差异,CoordAtt分支则强化局部结构细节。实验表明,STSAM能显著提升变化检测性能,同时保持训练稳定性。文章详细介绍了模块结构、原理、优势,并提供了完整的核心代码实现和配置方法,包括三种改进方案。

Ai缝合怪、助力小伙伴高效发论文 218

Spring 框架详解

Spring 是一个功能强大的企业级开发框架,提供了从核心容器、AOP、数据访问到 Web 开发、微服务架构的完整解决方案。Spring Boot 进一步简化了 Spring 的使用,使开发更高效。

m0_69529796的博客 2067

鸿蒙系统开发工程师:核心技术解析与深度面试指南

摘要: 鸿蒙系统开发工程师需具备底层驱动开发、系统移植优化及分布式架构能力。核心职责包括硬件适配(Bootloader、内核移植、HDF驱动开发)、性能调优(启动加速、功耗管理)及稳定性保障。技术要求涵盖C/C++编程、Linux内核机制、鸿蒙架构(HDF、分布式服务)及ArkTS/ArkUI基础。面试重点考察系统移植流程(如ARM板适配)、驱动开发(I2C/Display)、性能优化手段及内存/同步机制的应用。

郑伟强dev的专栏 432

Spirng MVC详解:从入门到核心原理

Spring MVC 是 Spring Framework 的内置 Web 模块,是基于 Java 实现 MVC(Model-View-Controller)架构的轻量级 Web 框架。它通过分离模型(Model)、视图(View)和控制器(Controller),实现了 Web 应用的分层设计,降低了模块间的耦合度。@Controller // 标记为控制器// 映射 GET 请求 /hello,跳转视图// 向 Model 中添加数据(视图可通过 ${message} 获取)");

2403_88625492的博客 1076

IEM模型,地表粗糙度模拟

利用微波反演土壤水分时候,利用IEM模型可以实现对随机地表的模拟

NTscan扫描工具

ntscan是一个扫描器,可以扫描没有密码和弱密码的共享,先到配置文件中填写猜测的用户名和密码,扫描过程中右侧出现的是扫描日志。

Spring MVC拦截器1:拦截器入门一:拦截器(interceptor)简介;拦截器开发流程简介;演示了拦截器最基本的配置流程;

说明: (1)本篇博客合理性解释: (2)如有需要:过滤器(filter)可以参考【(5)常用功能与过滤器、监听器、FreeMarker;】专栏中的内容;SpringAOP可以参考【(15)Spring基础:IoC;AOP;JDBC;】专栏中的内容; 一:拦截器简介; 说明: (1)拦截器的作用:拦截url,对其进行前置/后置过滤; (2)【Spring的拦截器】和【J2EE的过滤器】,其作用有点相似,都是拦截请求;但是二者底层的实现逻辑是不同的; ●拦截器(...

小枯林的博客 1819

WINCC7.3破解文件

WINCC7.3硬件够破解文件,有需要的下载!WINCC7.3硬件够破解文件,有需要的下载!

Spring-MVC框架简单介绍及快速入门案例

初识spring-mvc框架及快速入门案例 spring-mvc概述 spring组件分析 spring-mvc执行流程 快速入门

beansice的博客 364

Statistics and Machine Learning Toolbox

Statistics and Machine Learning Toolbox(带书签),MATLAB统计学习工具

Spring MVC 框架详解

不定期分享高并发、高可用、高性能、微服务、分布式、海量数据、性能调优、云原生、项目管理、产品思维、技术选型、架构设计、求职面试、副业思维、个人成长等内容。接下来,我将为大家呈现正文内容。在实际开发过程中,需要根据具体需求选择合适的组件和配置,以达到最佳的开发效果。

我是Java程序员廖志伟,感谢朋友们的支持!不定期贡献一篇高品质、过万文字、图文并茂且附有视频解说、满载代码示例注释的良心之作,坚决杜绝粗制乱造。 649

Spring MVC控制层框架

Spring Web MVC是基于Servlet API构建的原始Web框架,从一开始就包含在Spring Framework中。正式名称“Spring Web MVC”来自其源模块的名称(),但它通常被称为“Spring MVC”。在控制层框架历经Strust、WebWork、Strust2等诸多产品的历代更迭之后,目前业界普遍选择了SpringMVC作为Java EE项目表述层开发的首选方案。Spring 家族原生产品,与IOC容器等基础设施无缝对接表述层各细分领域需要解决的问题全方位覆盖,提供。

qq_62079814的博客 1455

通过SpringMVC进行文件的上传

http://blog.youkuaiyun.com/xiyang_1990/article/details/17718275 http://blog.youkuaiyun.com/skylovedaim/article/details/17581413 Spring MVC 教程,快速入门,深入分析 http://zyjustin9.iteye.com/blog/2002830 springmvc的测试 ...

pengfeifei26的专栏 131
上一篇: Java框架快速入门: SSM整合进阶——统一异常处理与前后端联调实战
下一篇: Java框架快速入门:SpringBoot工程入门案例开发全流程解析
Wang's Blog
博客等级 码龄12年 7438粉丝 2422原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

Wang's Blog

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值