当前位置：首页 > article >正文

SpringMVC 请求处理详解

article 2026/2/25 22:13:53

SpringMVC 是 Spring 框架中用于构建 Web 应用程序的模块，它基于 MVC（Model-View-Controller）设计模式，能够将业务逻辑、数据和显示分离，从而提高代码的可维护性和可扩展性。本文将详细介绍 SpringMVC 中请求处理的原理和步骤，以及如何在实际开发中灵活运用。

一、SpringMVC 请求处理概述

在 SpringMVC 中，请求处理是一个核心功能，它负责将用户的 HTTP 请求映射到相应的控制器方法，并处理请求参数、返回视图等。SpringMVC 的请求处理机制基于前端控制器（DispatcherServlet）、处理器映射器（HandlerMapping）、处理器适配器（HandlerAdapter）和视图解析器（ViewResolver）等组件协同工作，实现了请求的接收、处理和响应的完整流程。

二、SpringMVC 请求处理步骤

1. 用户发送请求

用户在浏览器中输入 URL 或点击链接、提交表单等操作，向服务器发送 HTTP 请求。例如，访问 http://localhost:8080/your-project-name/hello。

2. 前端控制器接收请求

SpringMVC 的前端控制器 DispatcherServlet 接收到用户的请求后，首先会根据请求的 URL 查找对应的处理器（Controller 中的方法）。它通过查询处理器映射器 HandlerMapping 来获取处理器的信息。

3. 处理器映射器查找处理器

处理器映射器 HandlerMapping 根据请求的 URL 和其他信息（如 HTTP 方法、请求参数等），在配置的处理器映射中查找匹配的处理器。如果找到匹配的处理器，则返回处理器对象和拦截器（如果有）给前端控制器。

4. 处理器适配器执行处理器

前端控制器 DispatcherServlet 收到处理器映射器返回的处理器后，会使用处理器适配器 HandlerAdapter 来执行该处理器。处理器适配器负责调用处理器的方法，并处理方法的参数和返回值。

5. 处理器处理请求并返回模型视图

处理器（Controller 中的方法）接收到请求后，会进行相应的业务逻辑处理。它可以通过请求参数获取用户输入的数据，调用服务层的方法进行业务处理，然后根据处理结果返回一个模型视图（ModelAndView 对象）。模型视图包含了要传递给视图的数据（模型）和逻辑视图名。

6. 视图解析器解析逻辑视图名

前端控制器 DispatcherServlet 收到模型视图后，会使用视图解析器 ViewResolver 根据逻辑视图名解析出实际的视图对象。视图解析器会根据配置的视图前缀和后缀，将逻辑视图名转换为实际的视图页面路径。

7. 渲染视图并返回响应

视图对象（如 JSP 页面）会根据模型中的数据进行渲染，生成 HTML 页面或其他形式的响应内容。然后，前端控制器将渲染后的视图内容作为 HTTP 响应返回给用户，用户在浏览器中看到最终的页面结果。

三、SpringMVC 请求处理示例

1. 创建控制器类

package com.example.controller;import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;@Controller
public class HelloController {@RequestMapping("/hello")public String hello(@RequestParam("name") String name, Model model) {model.addAttribute("message", "Hello, " + name + "!");return "hello";}
}

在这个控制器类中，@Controller 注解表明该类是一个控制器；@RequestMapping 注解用于定义请求的映射路径；@RequestParam 注解用于绑定请求参数到方法参数；Model 参数用于将数据传递到视图页面。

2. 创建视图页面

在项目的 WEB-INF/views/ 目录下创建 hello.jsp 文件：

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head><title>Hello Page</title>
</head>
<body><h1>${message}</h1>
</body>
</html>

3. 配置 SpringMVC

在 web.xml 中配置前端控制器 DispatcherServlet：

<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/javaeehttp://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"version="4.0"><servlet><servlet-name>springmvc</servlet-name><servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class><init-param><param-name>contextConfigLocation</param-name><param-value>/WEB-INF/springmvc-servlet.xml</param-value></init-param><load-on-startup>1</load-on-startup></servlet><servlet-mapping><servlet-name>springmvc</servlet-name><url-pattern>/</url-pattern></servlet-mapping></web-app>

在 springmvc-servlet.xml 中配置处理器映射器、处理器适配器和视图解析器：

<beans xmlns="http://www.springframework.org/schema/beans"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns:context="http://www.springframework.org/schema/context"xmlns:mvc="http://www.springframework.org/schema/mvc"xsi:schemaLocation="http://www.springframework.org/schema/beanshttp://www.springframework.org/schema/beans/spring-beans.xsdhttp://www.springframework.org/schema/contexthttp://www.springframework.org/schema/context/spring-context.xsdhttp://www.springframework.org/schema/mvchttp://www.springframework.org/schema/mvc/spring-mvc.xsd"><context:component-scan base-package="com.example.controller" /><mvc:annotation-driven /><bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"><property name="prefix" value="/WEB-INF/views/" /><property name="suffix" value=".jsp" /></bean></beans>

4. 测试请求处理

启动服务器，访问 http://localhost:8080/your-project-name/hello?name=SpringMVC，应该能看到页面显示 "Hello, SpringMVC!"，说明 SpringMVC 请求处理成功。

四、SpringMVC 请求处理中的参数绑定

1. 简单类型参数绑定

在控制器方法中，可以使用 @RequestParam 注解将请求参数绑定到方法参数。例如：

@RequestMapping("/hello")
public String hello(@RequestParam("name") String name, Model model) {model.addAttribute("message", "Hello, " + name + "!");return "hello";
}

这里，@RequestParam("name") 将请求中名为 "name" 的参数值绑定到方法参数 name。

2. 对象参数绑定

可以将请求参数绑定到一个 JavaBean 对象中。例如：

public class User {private String name;private int age;// getter 和 setter 方法
}@Controller
public class UserController {@RequestMapping("/user")public String user(User user, Model model) {model.addAttribute("user", user);return "user";}
}

在 JSP 页面中可以通过 ${user.name}、${user.age} 获取对象的属性值。

3. 集合参数绑定

对于请求中的数组或集合参数，SpringMVC 也提供了支持。例如：

@RequestMapping("/users")
public String users(@RequestParam("ids") int[] ids, Model model) {model.addAttribute("ids", ids);return "users";
}

在 JSP 页面中可以通过循环遍历数组来展示数据。

五、SpringMVC 请求处理中的文件上传

SpringMVC 支持文件上传功能，需要进行相应的配置。首先，在 SpringMVC 配置文件中添加文件上传解析器：

<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"><property name="maxUploadSize" value="10485760" /> <!-- 设置最大上传大小为10MB -->
</bean>

然后，在控制器中处理文件上传：

@RequestMapping("/upload")
public String upload(@RequestParam("file") MultipartFile file, Model model) {if (!file.isEmpty()) {try {byte[] bytes = file.getBytes();// 处理文件内容，如保存到服务器或数据库model.addAttribute("message", "文件上传成功！");} catch (Exception e) {model.addAttribute("message", "文件上传失败！");}} else {model.addAttribute("message", "请选择文件！");}return "upload";
}

在 JSP 页面中，表单需要设置 enctype="multipart/form-data"：

<form action="${pageContext.request.contextPath}/upload" method="post" enctype="multipart/form-data"><input type="file" name="file" /><input type="submit" value="上传" />
</form>

六、SpringMVC 请求处理中的拦截器

SpringMVC 提供了拦截器机制，可以在请求处理的前后执行一些公共逻辑，如权限验证、日志记录等。要使用拦截器，需要创建一个拦截器类并进行配置。

创建拦截器类：

public class LoggingInterceptor implements HandlerInterceptor {@Overridepublic boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {// 在请求处理之前执行的逻辑，如记录请求信息System.out.println("请求地址: " + request.getRequestURI());return true; // 返回true表示继续执行后续的拦截器和处理器，返回false表示中断请求处理}@Overridepublic void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {// 在请求处理之后、视图渲染之前执行的逻辑，如修改模型数据if (modelAndView != null) {modelAndView.addObject("interceptorMessage", "拦截器已处理");}}@Overridepublic void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {// 在视图渲染之后执行的逻辑，如清理资源System.out.println("请求处理完成");}
}

在 SpringMVC 配置文件中配置拦截器：

<mvc:interceptors><bean class="com.example.interceptor.LoggingInterceptor" />
</mvc:interceptors>

七、总结

SpringMVC 的请求处理机制是其核心功能之一，通过前端控制器、处理器映射器、处理器适配器和视图解析器等组件的协同工作，实现了从接收请求到返回响应的完整流程。在实际开发中，灵活运用请求参数绑定、文件上传、拦截器等功能，可以提高开发效率和代码的可维护性。掌握 SpringMVC 请求处理的原理和方法，对于开发高质量的 Web 应用程序具有重要意义。