Spring MVC：原理、配置与基础应用详解

🕗 发布于 2024-11-25 16:52 spring mvc java

一、引言

在现代 Java 企业级开发领域，Spring MVC 作为 Spring 框架家族中专注于构建 Web 应用的核心模块，凭借其强大、灵活且高效的特性，占据着举足轻重的地位。它遵循经典的 MVC（Model-View-Controller）设计模式，将业务逻辑、数据展示以及用户交互清晰地分离开来，极大地提升了代码的可维护性、可扩展性与可复用性。无论是小型项目的快速搭建，还是大型分布式系统中的 Web 服务层构建，Spring MVC 都展现出卓越的适配能力，接下来，让我们深入探究其底层原理、细致的配置方式以及基础应用场景。

二、Spring MVC 核心原理剖析

（一）MVC 设计模式基础

MVC 设计模式旨在分离应用程序的输入逻辑（Controller）、业务逻辑（Model）与输出逻辑（View）。在 Spring MVC 架构下，Controller 负责接收用户请求，解析请求参数，并决定调用何种业务逻辑方法；Model 封装应用数据，承载业务处理结果，它可以是简单的 POJO（Plain Old Java Object）类，存储数据库查询结果、计算值等；View 则专注于将 Model 中的数据以特定格式（如 HTML、JSON、XML 等）呈现给用户，常见的视图技术包括 JSP、Thymeleaf、Freemarker 等。这种解耦使得各层可以独立演进，开发人员可以专注于某一层功能优化而不影响其他层。

（二）DispatcherServlet 中央调度器

Spring MVC 的核心枢纽是 DispatcherServlet，作为前端控制器，它掌控着整个请求处理流程。当客户端发送 HTTP 请求时，该请求首先抵达 DispatcherServlet，它依据配置的映射规则（如 URL 映射）将请求分发给对应的 Controller 处理方法。例如，对于 URL “/user/list” 的请求，DispatcherServlet 会在预定义的处理器映射（HandlerMapping）中查找匹配的 Controller 方法，确保请求能精准定位到业务逻辑入口。

（三）HandlerMapping 与 HandlerAdapter

HandlerMapping 负责建立请求 URL 与 Controller 处理方法间的映射关系，Spring MVC 提供多种映射策略，像基于注解的 @RequestMapping 方式，开发人员能轻松将 URL 路径与特定方法绑定，如在 UserController 类中：

java

Copy

@Controller
@RequestMapping("/user")
public class UserController {
    @RequestMapping("/list")
    public String listUsers(Model model) {
        // 业务逻辑，查询用户列表
        List<User> userList = userService.findAll();
        model.addAttribute("userList", userList);
        return "userList";
    }
}

此处，“/user/list” 路径对应 listUsers 方法。而 HandlerAdapter 则作为适配层，协调 DispatcherServlet 与不同类型的 Controller 方法调用，它知晓如何调用基于注解、基于接口规范等各类形式定义的 Controller 方法，确保请求执行流程无缝衔接。

（四）ModelAndView 与视图解析

Controller 方法执行完业务逻辑后，常返回 ModelAndView 对象，Model 部分承载数据，View 部分指定视图名称（如 “userList”）。接着，视图解析器（ViewResolver）依据配置规则解析视图名称，定位实际物理视图资源。以 InternalResourceViewResolver 为例，若配置了前缀 “/WEB-INF/views/” 和后缀 “.jsp”，对于视图名称 “userList”，它会找到 “/WEB-INF/views/userList.jsp” 文件作为渲染模板，将 Model 数据填充进去，最终生成 HTML 页面返回客户端。

三、Spring MVC 详细配置解读

（一）基础项目搭建与依赖引入

使用 Spring MVC 首先要搭建 Java Web 项目，在 Maven 项目中，需在 pom.xml 文件引入核心依赖，包括 spring-webmvc、spring-context 等包，示例如下：

xml

Copy

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-webmvc</artifactId>
    <version>5.3.22</version>
</dependency>
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-context</artifactId>
    <version>5.3.22</version>
</dependency>

同时确保项目结构符合 Java Web 规范，有 src/main/java 存放 Java 代码，src/main/resources 放置配置文件，WEB-INF 目录包含 web.xml 等关键文件。

（二）web.xml 配置核心组件

传统方式下，web.xml 是配置 Spring MVC 的关键入口，需定义 DispatcherServlet，如下：

xml

Copy

<servlet>
    <servlet-name>dispatcherServlet</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>/WEB-INF/spring-mvc.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>dispatcherServlet</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>

这里指定 DispatcherServlet 初始参数指向 spring-mvc.xml（后续配置核心文件），并设置 URL 映射为 “/”，意味着所有请求都会先经它处理，仅排除 JSP、静态资源等特定映射（可额外配置排除规则）。

（三）spring-mvc.xml 配置细节

开启注解扫描：利用<context:component-scan>标签扫描指定包下带有注解（如 @Controller、@Service 等）的类，确保相关组件被 Spring 容器管理，示例：

xml

Copy

<context:component-scan base-package="com.example.controller,com.example.service"/>

配置视图解析器：以 Thymeleaf 为例，需引入 Thymeleaf 依赖后，在 spring-mvc.xml 配置：

xml

Copy

<bean id="viewResolver" class="org.thymeleaf.spring5.view.ThymeleafViewResolver">
    <property name="templateEngine">
        <bean class="org.thymeleaf.spring5.SpringTemplateEngine">
            <property name="templateResolver">
                <bean class="org.thymeleaf.spring5.templateresolver.SpringResourceTemplateResolver">
                    <property name="prefix" value="/WEB-INF/templates/"/>
                    <property name="suffix" value=".html"/>
                    <property name="characterEncoding" value="UTF-8"/>
                </bean>
            </property>
        </bean>
    </property>
</bean>

这精确设定了视图模板的前缀、后缀与编码，方便定位与渲染。
3. 配置静态资源处理：为使 CSS、JS 等静态资源能正常访问，添加资源处理器，像：

xml

Copy

<mvc:resources mapping="/static/**" location="/static/"/>

允许对 “/static/” 目录下资源以 “/static/**” 路径模式访问，避免被 DispatcherServlet 误拦截。

四、Spring MVC 基础应用实例

（一）构建简单用户管理模块

定义数据模型（Model）：创建 User 实体类，包含 id、name、age 等属性及对应 get/set 方法，作为数据库操作与业务逻辑的数据载体。

java

Copy

public class User {
    private Long id;
    private String name;
    private Integer age;
    // 构造函数、get/set 方法省略
}

编写业务逻辑层（Service）：接口 UserService 定义操作规范，如 saveUser、getUserById 等方法，实现类 UserServiceImpl 借助 DAO 层（数据访问层，此处略）完成数据库交互与业务处理，示例 saveUser 方法：

java

Copy

@Service
public class UserServiceImpl implements UserService {
    @Autowired
    private UserDAO userDAO;
    @Override
    public void saveUser(User user) {
        userDAO.save(user);
    }
}

开发 Controller 层：UserController 类接收请求，调用 Service 方法，处理参数传递与视图跳转，如添加用户方法：

java

Copy

@Controller
@RequestMapping("/user")
public class UserController {
    @Autowired
    private UserService userService;
    @RequestMapping("/add")
    public String addUser(User user, Model model) {
        userService.saveUser(user);
        model.addAttribute("msg", "用户添加成功");
        return "success";
    }
}

这里将前端表单提交的 User 对象参数接收，保存后跳转至 “success” 视图展示提示信息。

（二）表单数据处理与验证

表单提交与绑定：在前端 JSP（或其他视图技术）页面，设计用户添加表单，各字段与 User 实体属性对应，提交到 “/user/add” 路径，Spring MVC 自动依据名称匹配将表单数据绑定到 User 对象，简化数据获取流程。

html

Copy

<form action="/user/add" method="post">
    <input type="text" name="name" placeholder="姓名"/>
    <input type="number" name="age" placeholder="年龄"/>
    <input type="submit" value="添加用户"/>
</form>

数据验证：利用 Spring 的 Validation 框架（如 Hibernate Validator），在 User 类属性添加注解规范，如 @NotEmpty、@Min 等，在 Controller 方法参数前加 @Valid 启用验证，示例：

java

Copy

public class User {
    @NotEmpty(message = "姓名不能为空")
    private String name;
    @Min(value = 18, message = "年龄需大于等于 18")
    private Integer age;
    // get/set 方法省略
}

java

Copy

@RequestMapping("/add")
public String addUser(@Valid User user, BindingResult bindingResult, Model model) {
    if (bindingResult.hasErrors()) {
        model.addAttribute("errors", bindingResult.getAllErrors());
        return "addUserForm";
    }
    userService.saveUser(user);
    model.addAttribute("msg", "用户添加成功");
    return "success";
}

若验证出错，返回表单页面展示错误信息，确保数据完整性与合法性。

五、总结

Spring MVC 通过精妙的设计原理、细致的配置体系以及贴合实际的应用示例，展现强大 Web 开发能力。理解其原理有助于排查问题、优化性能；掌握配置可灵活定制项目架构；实践应用能快速搭建功能模块。后续我们将深入探究其高级特性，如异常处理、拦截器、异步处理等，进一步挖掘 Spring MVC 潜力，敬请期待。

原文地址：https://blog.csdn.net/ZERO141239/article/details/144016093

免责声明：本站文章内容转载自网络资源，如本站内容侵犯了原著者的合法权益，可联系本站删除。更多内容请关注自学内容网（zxcms.com）！

上一篇：【系统架构设计师】真题论文: 论软件需求管理（包括解题思路和素材）
下一篇：Linux安装RabbitMQ

【Go】-go中的锁机制
简单的说方法内联就是将被调用方函数代码“复制”到调用方函数中，减少函数调用开销，在2018年之前的go版本中，所有的逻辑都在Lock函数中，并没有拆出来，2018年之后Go开发者将slow path拆
阅读更多2024-11-25
基于Java Springboot校园跑腿系统
项目编号：springbootA188随着互联网技术的不断发展和校园生活的多样化需求，校园跑腿系统应运而生。该系统旨在为大学生提供一个便捷的在线服务平台，解决校园内学生因时间紧张、事务繁忙而无法亲自处
阅读更多2024-11-25
【Leecode】Leecode刷题之路第59天之螺旋矩阵II
代码示例：（Java）代码示例：（Java）代码示例：（Java）
阅读更多2024-11-25
C++共享智能指针
C++中没有垃圾回收机制，必须自己释放分配的内存，否则就会造成内存泄漏。解决这个问题最有效的方式是使用智能指针。智能指针是存储指向动态分配(堆)对象指针的类，用于生存期的控制，能够确保在离开指针所在作
阅读更多2024-11-25
使用NAS开启无纸化办公，Docker部署开源文档管理系统『Paperless-ngx』
今天分享的这个项目还是非常实用了，它可以让我们更好地管理他们的文档，提高生产力，减少纸张使用，不管是对企业还是个人都是一个实用的解决方案，有兴趣的小伙伴可以整起来了！最近正逢极空间双十一感恩回馈大促销
阅读更多2024-11-25
【数字图像处理+MATLAB】通过 Roberts, Prewitt, Sobel, LoG 等算子实现图像边缘检测：使用 edge 函数
边缘检测是图像处理中的一种技术，用于识别图像中的物体边界。边缘是图像亮度函数快速变化的地方，通常对应于物体或物体部分的边界。边缘检测的目标是显著减少图像中的数据量，同时保留有用的结构信息。常用的边缘检
阅读更多2024-11-25
设计模式——前端控制器模式
前端控制器模式（Front Controller Pattern）是一种软件设计模式，主要用于集中处理 Web 应用或其他多层架构应用的请求。它作为一个单一的入口点来接收和处理所有的客户端请求，将请求
阅读更多2024-11-25
吊车-双摆系统的控制
吊车双摆控制
阅读更多2024-11-25
原生openGauss与Oracle数据库函数兼容性对比验证测试
近期在进行调研去O,为此研究了下原生openGauss和Oracle数据库兼容性，特整理测试了Oracle常用函数和openGauss数据库的对比测试。
阅读更多2024-11-25
修复kernel编译栈帧大小异常问题error: the frame size of 1928 bytes is larger than 1024 bytes
并且内存是4K分页，创建一个内核栈就需要申请连续2块的4K页，内存紧张的时候，申请8K的连续内存比申请4K困难的多；(1)栈内存申请过大，或者函数调用层次太深都会导致栈溢出，引起系统崩溃，在编译时会去
阅读更多2024-11-25

Spring MVC：原理、配置与基础应用详解

一、引言

二、Spring MVC 核心原理剖析

（一）MVC 设计模式基础

（二）DispatcherServlet 中央调度器

（三）HandlerMapping 与 HandlerAdapter

（四）ModelAndView 与视图解析

三、Spring MVC 详细配置解读

（一）基础项目搭建与依赖引入

（二）web.xml 配置核心组件

（三）spring-mvc.xml 配置细节

四、Spring MVC 基础应用实例

（一）构建简单用户管理模块

（二）表单数据处理与验证

五、总结

相关文章