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

SpringMVC 配置详解

article 2026/2/25 18:39:01

SpringMVC 是 Spring 框架中用于构建 Web 应用程序的模块，它基于 MVC（Model-View-Controller）设计模式，能够将业务逻辑、数据和显示分离，从而提高代码的可维护性和可扩展性。本文将详细介绍 SpringMVC 的配置步骤和相关要点。

一、SpringMVC 简介

SpringMVC 是 Spring 框架的一部分，它提供了对 MVC 架构的支持，使得开发 Web 应用更加高效和灵活。在 SpringMVC 中，控制器（Controller）负责处理用户请求，并调用相应的业务逻辑；模型（Model）用于存储数据；视图（View）则负责将数据以适当的格式展示给用户。

二、SpringMVC 配置步骤

1. 创建 Maven 项目

首先，创建一个 Maven 项目，这样可以方便地管理项目的依赖。在项目的 pom.xml 文件中，添加 SpringMVC 所需的依赖项，包括 Spring 框架、Servlet API 等。例如：

<dependencies><!-- Spring MVC 依赖 --><dependency><groupId>org.springframework</groupId><artifactId>spring-webmvc</artifactId><version>5.2.12.RELEASE</version></dependency><!-- Servlet API 依赖 --><dependency><groupId>javax.servlet</groupId><artifactId>javax.servlet-api</artifactId><version>4.0.1</version><scope>provided</scope></dependency><!-- 其他依赖... -->
</dependencies>

2. 配置 web.xml

在 web.xml 文件中，需要配置 SpringMVC 的前端控制器 DispatcherServlet。这个控制器是 SpringMVC 的核心，它负责接收和分发用户请求。配置示例如下：

<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"><!-- 配置 SpringMVC 前端控制器 --><servlet><servlet-name>springmvc</servlet-name><servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class><!-- 可选：指定 SpringMVC 配置文件的位置 --><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>

在这里，<servlet-name> 是前端控制器的名称，可以自定义；<servlet-class> 指定了前端控制器的类；<init-param> 用于指定 SpringMVC 配置文件的位置，如果不配置该参数，则默认在 /WEB-INF/[servlet-name]-servlet.xml 文件中查找配置；<load-on-startup> 表示在服务器启动时加载该 Servlet；<url-pattern> 配置了前端控制器的映射路径，这里配置为 /，表示拦截所有请求。

3. 创建 SpringMVC 配置文件

在上面的配置中，我们指定了 SpringMVC 配置文件的位置为 /WEB-INF/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" /><!-- 启用 SpringMVC 的注解驱动 --><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>

在该配置文件中，<context:component-scan> 用于扫描控制器所在的包，以便 Spring 能够自动检测和管理控制器类；<mvc:annotation-driven> 启用了 SpringMVC 的注解驱动，这样可以使用 @Controller、@RequestMapping 等注解来定义控制器和请求映射；<bean> 定义了一个视图解析器，用于将逻辑视图名解析为实际的视图页面路径，这里配置了 JSP 页面的前缀和后缀路径。

4. 创建控制器类

接下来，创建一个控制器类，并使用 Spring 的注解进行标记和定义请求映射。例如：

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

在这个控制器类中，@Controller 注解表明该类是一个控制器；@RequestMapping 注解用于定义请求的映射路径，当用户访问 /hello 路径时，将调用 hello 方法；Model 参数用于将数据传递到视图页面，在方法中通过 model.addAttribute 将数据添加到模型中；return "hello"; 表示逻辑视图名，视图解析器会根据配置将其解析为 /WEB-INF/views/hello.jsp。

5. 创建视图页面

根据上面的配置和控制器代码，创建一个 JSP 页面作为视图。在项目的 WEB-INF/views/ 目录下创

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

这个 JSP 页面通过 ${message} 获取模型中的数据并展示在页面上。

6. 部署和测试

完成以上配置后，将项目部署到服务器（如 Tomcat）上，启动服务器并访问 http://localhost:8080/your-project-name/hello，应该能看到页面显示 "Hello, SpringMVC!"，说明 SpringMVC 配置成功。

三、SpringMVC 配置要点总结

项目依赖：确保在 pom.xml 中正确添加了 SpringMVC 和相关依赖。
前端控制器配置：在 web.xml 中配置 DispatcherServlet，并设置其映射路径和配置文件位置。
SpringMVC 配置文件：在配置文件中扫描控制器包、启用注解驱动、配置视图解析器等。
控制器开发：使用注解定义控制器类和请求映射，处理用户请求并返回视图。
视图页面：根据视图解析器的配置创建相应的视图页面，展示数据。

四、高级配置（可选）

1. 视图解析器的多样化配置

除了常用的 InternalResourceViewResolver 外，还可以根据需要配置其他类型的视图解析器，如 BeanNameViewResolver、ResourceBundleViewResolver 等，以满足不同的视图解析需求。

2. 文件上传配置

在 SpringMVC 中，可以通过配置 MultipartResolver 来支持文件上传功能。例如：

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

同时，在控制器中使用 @RequestParam 注解接收上传的文件。

3. 拦截器配置

SpringMVC 支持拦截器的配置，用于在请求处理前后执行一些公共逻辑，如权限验证、日志记录等。配置拦截器需要在 SpringMVC 配置文件中定义拦截器链：

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

然后创建拦截器类，实现 HandlerInterceptor 接口，并重写 preHandle、postHandle、afterCompletion 等方法。

五、总结

通过以上步骤，我们详细介绍了 SpringMVC 的配置过程，从项目依赖的添加到前端控制器的配置，再到控制器、视图解析器等的设置，每一步都进行了清晰的讲解。SpringMVC 的配置虽然有一定的复杂性，但只要理解了其核心原理和配置要点，就能灵活地运用它来开发高效、灵活的 Web 应用程序。在实际开发中，还可以根据项目需求进行更高级的配置和扩展，以满足各种复杂的业务场景。