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

SpringMVC 系列博客（一）：基础概念与注解开发入门

news 2025/9/18 7:03:25

目录

一、引言

二、MVC 模式：SpringMVC 的设计基石

2.1 MVC 三大组件

2.2 主流 MVC 框架对比

2.3 MVC 模式的核心优势

三、SpringMVC 框架：是什么？为什么学？

3.1 什么是 SpringMVC？

3.2 为什么要学 SpringMVC？（对比原生 Servlet）

四、SpringMVC 执行流程：从请求到响应的完整链路

4.1 核心组件（无需手动开发，框架提供）

4.2 完整执行流程（图文解析）

五、注解开发 SpringMVC：手把手搭建入门程序

5.1 前置准备

5.2 步骤 1：创建 Maven Web 项目

5.3 步骤 2：添加依赖（pom.xml）

5.4 步骤 3：配置前端控制器（web.xml）

5.5 步骤 4：编写 SpringMVC 核心配置（springmvc.xml）

5.6 步骤 5：开发控制器（Controller）

5.7 步骤 6：开发视图页面

5.8 步骤 7：测试程序

六、入门常见问题解决

6.1 URL 拦截规则：/ vs /* 的区别

6.2 POST 请求参数乱码

七、第一篇总结

一、引言

        在 Java Web 开发中，MVC 设计模式是实现代码解耦、提高项目可维护性的核心思想，而SpringMVC作为 Spring 生态体系下的 MVC 框架，凭借其与 Spring 的无缝集成、灵活的配置和简洁的开发风格，早已取代 Struts2 成为主流选择。本文作为系列博客的第一篇，将从 MVC 模式基础入手，带你理解 SpringMVC 的核心定位、执行流程，并手把手教你搭建第一个注解驱动的 SpringMVC 入门程序。

二、MVC 模式：SpringMVC 的设计基石

        在学习 SpringMVC 前，必须先掌握 MVC 模式的核心思想 —— 它将应用程序分为三个独立部分，实现 “职责分离”。

2.1 MVC 三大组件

  • Model（模型）：分为 “业务模型” 和 “数据模型”。业务模型封装业务逻辑（如用户登录校验、订单计算），数据模型封装数据（如 User、Order 实体类），是应用程序的 “数据与逻辑核心”。
  • View（视图）：负责数据展示，即用户看到的界面（如 JSP、HTML、Freemarker），仅关注 “如何显示数据”，不处理业务逻辑。
  • Controller（控制器）：作为 “中间枢纽”，接收用户请求，调用 Model 处理业务，再将处理结果传递给 View 展示，实现 View 与 Model 的解耦。

2.2 主流 MVC 框架对比

框架特点适用场景
SpringMVC与 Spring 无缝集成、注解驱动、轻量灵活中大型企业级项目（主流）
Struts2功能全面但配置复杂、性能略低传统项目（逐渐被淘汰）
JFinal轻量级、API 简洁、开发效率高小型项目或快速原型开发

2.3 MVC 模式的核心优势

  1. 解耦：View 与 Model 分离，同一业务逻辑可对应多个视图（如 PC 端、移动端页面）。
  2. 可维护性：各组件职责单一，修改视图不影响业务逻辑，修改业务不影响视图。
  3. 可扩展性：新增功能只需新增 Controller 或 Model，无需改动现有视图。

三、SpringMVC 框架：是什么？为什么学？

3.1 什么是 SpringMVC？

  • 定位：SpringMVC 是 Spring Framework 的子框架，本质是对 Servlet 的封装，解决了原生 Servlet 的痛点（如请求映射繁琐、参数接收复杂）。
  • 核心特性：
    1. 注解驱动：通过@Controller、@RequestMapping等注解，让普通 POJO 成为控制器，无需实现接口。
    2. 松散耦合：支持可插拔组件（如视图解析器、参数绑定组件），扩展性强。
    3. 无缝集成 Spring：可直接使用 Spring 的 IOC、AOP 等功能（如依赖注入 Service 层）。
    4. 易测试：支持 Web 层单元测试，无需启动服务器即可测试控制器。

3.2 为什么要学 SpringMVC？（对比原生 Servlet）

原生 Servlet 开发存在三大痛点，而 SpringMVC 完美解决：

  1. 请求映射繁琐：100 个请求需写 100 个 Servlet，即使合并 Servlet 也需手动判断请求路径，耦合度高；SpringMVC 通过@RequestMapping一键绑定 URL。
  2. 参数接收复杂：需手动调用request.getParameter("username")获取参数，还需手动类型转换（如 String 转 Integer）；SpringMVC 自动完成参数绑定与类型转换。
  3. 解耦不足：Servlet 与业务逻辑代码耦合，难以维护；SpringMVC 通过 Controller 调用 Service，层次清晰。

四、SpringMVC 执行流程：从请求到响应的完整链路

SpringMVC 的执行流程依赖其核心组件的协作，理解流程是掌握框架的关键。

框架处理流程图：

4.1 核心组件（无需手动开发，框架提供）

  1. 前端控制器（DispatcherServlet）：全局入口，接收所有请求，转发给其他组件处理，降低组件耦合。
  2. 处理器映射器（HandlerMapping）：根据请求 URL 查找对应的 “处理器（Controller 方法）”，返回 HandlerExecutionChain（包含处理器和拦截器）。
  3. 处理器适配器（HandlerAdapter）：适配不同类型的处理器（如注解式、接口式），调用处理器的业务方法。
  4. 处理器（Handler/Controller）：开发者编写的 Controller 类，封装业务逻辑，返回 ModelAndView（模型数据 + 逻辑视图名）。
  5. 视图解析器（ViewResolver）：将 “逻辑视图名”（如 "ok.jsp"）解析为 “物理视图”（如/WEB-INF/jsp/ok.jsp）。
  6. 视图（View）：开发者编写的 JSP/HTML，渲染 Model 中的数据并响应给用户。

4.2 完整执行流程（图文解析）

  1. 用户发送请求（如http://localhost:8080/reg.do），请求被DispatcherServlet拦截。
  2. DispatcherServlet 调用HandlerMapping，根据 URL 找到对应的 Controller 方法（如UserController的show()方法）。
  3. DispatcherServlet 调用HandlerAdapter，适配并调用找到的 Controller 方法。
  4. Controller 方法执行业务逻辑，返回ModelAndView（如模型数据uname=张三，逻辑视图名ok.jsp）。
  5. DispatcherServlet 调用ViewResolver，将逻辑视图名ok.jsp解析为物理视图路径（如/ok.jsp）。
  6. ViewResolver 返回 View 对象，DispatcherServlet 调用 View 的render()方法，渲染 Model 数据到视图。
  7. 渲染完成后，DispatcherServlet 将响应结果返回给用户，流程结束。

五、注解开发 SpringMVC：手把手搭建入门程序

        本节将基于 IDEA+Maven+Tomcat，实现一个 “用户注册” 功能，涵盖环境搭建、配置编写、控制器开发全流程。

5.1 前置准备

  1. IDEA 版本：需旗舰版（Community 版不支持 Web 开发），下载地址：JetBrains IDEA。
  2. Tomcat 配置：
    • 解压 Tomcat 到本地（如D:\Tomcat8.5）。
    • IDEA 中依次点击：Run → Edit Configurations → Templates → Tomcat Server → Local → Configure，选择 Tomcat 解压路径。
    • 新建 Tomcat 配置：点击+ → Tomcat Server → Local，设置 Name（如 Tomcat8.5），在Deployment中添加项目的war exploded包。

5.2 步骤 1：创建 Maven Web 项目

  1. 新建项目：New Project → Maven → 勾选Create from archetype → 选择org.apache.maven.archetypes:maven-archetype-webapp。
  2. 填写项目信息：GroupId（如com.jr）、ArtifactId（如springmvc-demo）、Version（如1.0-SNAPSHOT）。
  3. 补全目录：项目创建后，手动在src/main下添加java（标记为 Sources Root）和resources（标记为 Resources Root）目录。

5.3 步骤 2：添加依赖（pom.xml）

需引入 Spring 核心包、SpringMVC 包、Servlet/JSP 包、JSTL 包，完整依赖如下：

<dependencies><!-- JUnit测试 --><dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.11</version><scope>test</scope></dependency><!-- Spring核心包 --><dependency><groupId>commons-logging</groupId><artifactId>commons-logging</artifactId><version>1.2</version></dependency><dependency><groupId>org.springframework</groupId><artifactId>spring-core</artifactId><version>4.1.6.RELEASE</version></dependency><dependency><groupId>org.springframework</groupId><artifactId>spring-beans</artifactId><version>4.1.6.RELEASE</version></dependency><dependency><groupId>org.springframework</groupId><artifactId>spring-context</artifactId><version>4.1.6.RELEASE</version></dependency><dependency><groupId>org.springframework</groupId><artifactId>spring-expression</artifactId><version>4.1.6.RELEASE</version></dependency><!-- SpringMVC包 --><dependency><groupId>org.springframework</groupId><artifactId>spring-web</artifactId><version>4.1.6.RELEASE</version></dependency><dependency><groupId>org.springframework</groupId><artifactId>spring-webmvc</artifactId><version>4.1.6.RELEASE</version></dependency><!-- Servlet/JSP依赖 --><dependency><groupId>javax.servlet</groupId><artifactId>servlet-api</artifactId><version>2.3</version><scope>provided</scope></dependency><dependency><groupId>javax.servlet.jsp</groupId><artifactId>jsp-api</artifactId><version>2.2</version><scope>provided</scope></dependency><!-- JSTL标签库 --><dependency><groupId>jstl</groupId><artifactId>jstl</artifactId><version>1.2</version></dependency><dependency><groupId>taglibs</groupId><artifactId>standard</artifactId><version>1.1.2</version></dependency>
</dependencies>

5.4 步骤 3：配置前端控制器（web.xml）

前端控制器是 SpringMVC 的入口，需在WEB-INF/web.xml中配置，核心作用是拦截请求并转发：

<web-app version="2.5"xmlns="http://java.sun.com/xml/ns/javaee"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://java.sun.com/xml/ns/javaeehttp://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"><!-- 欢迎页 --><welcome-file-list><welcome-file>index.jsp</welcome-file></welcome-file-list><!-- 配置SpringMVC前端控制器 --><servlet><servlet-name>springmvc</servlet-name><servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class><!-- 指定SpringMVC配置文件路径（默认在WEB-INF/[servlet-name]-servlet.xml） --><init-param><param-name>contextConfigLocation</param-name><param-value>classpath:springmvc.xml</param-value></init-param><!-- 启动Tomcat时自动加载Servlet --><load-on-startup>1</load-on-startup></servlet><!-- 拦截规则：/ 表示拦截所有请求（除JSP外） --><servlet-mapping><servlet-name>springmvc</servlet-name><url-pattern>/</url-pattern></servlet-mapping><!-- 配置乱码过滤器（解决POST请求参数乱码） --><filter><filter-name>charsetFilter</filter-name><filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class><init-param><param-name>encoding</param-name><param-value>UTF-8</param-value></init-param><init-param><param-name>forceEncoding</param-name><param-value>true</param-value></init-param></filter><filter-mapping><filter-name>charsetFilter</filter-name><url-pattern>/*</url-pattern></filter-mapping>
</web-app>

5.5 步骤 4：编写 SpringMVC 核心配置（springmvc.xml）

在src/main/resources下创建springmvc.xml，配置注解扫描、注解驱动等核心功能：

<?xml version="1.0" encoding="UTF-8"?>
<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"><!-- 1. 扫描Controller注解（指定包路径） --><context:component-scan base-package="com.jr.controller"/><!-- 2. 开启注解驱动：自动加载处理器映射器、处理器适配器 --><mvc:annotation-driven/><!-- 3. 静态资源放行（如JS、CSS、图片，避免被DispatcherServlet拦截） --><mvc:resources location="/js/" mapping="/js/**"/><mvc:resources location="/images/" mapping="/images/**"/>
</beans>

5.6 步骤 5：开发控制器（Controller）

在src/main/java/com/jr/controller下创建UserController，使用@Controller标记为控制器，@RequestMapping绑定请求路径：

package com.jr.controller;import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;import javax.servlet.http.HttpServletRequest;@Controller // 标记此类为SpringMVC控制器
public class UserController {// 绑定请求路径：http://localhost:8080/reg.do@RequestMapping("reg.do")public ModelAndView register(HttpServletRequest request) {// 1. 创建ModelAndView对象（封装模型数据和视图名）ModelAndView mv = new ModelAndView();// 2. 接收请求参数（此处用原生Servlet API，后续会优化）String username = request.getParameter("username");String password = request.getParameter("password");// 3. 封装模型数据（存入request作用域，供视图使用）mv.addObject("uname", username); // 等价于request.setAttribute("uname", username)// 4. 指定逻辑视图名（视图解析器会解析为物理路径）mv.setViewName("ok.jsp");return mv;}
}

5.7 步骤 6：开发视图页面

注册页面（index.jsp）：在webapp下创建，提供用户输入表单：

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head><title>用户注册</title>
</head>
<body>
<form action="reg.do" method="post">用户名：<input type="text" name="username"><br>密码：<input type="password" name="password"><br><input type="submit" value="提交注册">
</form>
</body>
</html>

成功页面（ok.jsp）：在webapp下创建，展示注册成功信息：

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head><title>注册成功</title>
</head>
<body>
<h3>注册成功！欢迎您，${uname}！</h3> <!-- EL表达式获取模型数据 -->
</body>
</html>

5.8 步骤 7：测试程序

  1. 启动 Tomcat，访问http://localhost:8080/springmvc-demo/（项目上下文路径根据配置调整）。
  2. 输入用户名和密码，点击 “提交注册”，页面跳转至ok.jsp并显示欢迎信息，说明程序运行成功。

六、入门常见问题解决

6.1 URL 拦截规则：/ vs /* 的区别

  • /：拦截所有请求（除 JSP 外），是 SpringMVC 推荐配置。JSP 由 Tomcat 的 JspServlet 处理，不会被拦截，可正常渲染。
  • /*：拦截所有请求（包括 JSP），会导致 JSP 被 DispatcherServlet 当作控制器处理，找不到对应映射而报 404 错误，禁止使用。

6.2 POST 请求参数乱码

        如步骤 3 中配置的CharacterEncodingFilter，通过encoding=UTF-8强制设置请求和响应的字符编码，解决 POST 乱码问题（GET 乱码需修改 Tomcat 的server.xml，添加URIEncoding="UTF-8"）。

七、第一篇总结

        本文从 MVC 模式基础出发，讲解了 SpringMVC 的核心定位、执行流程，并通过 “用户注册” 案例完整演示了注解开发的入门流程。你已掌握：

  1. MVC 模式的三大组件与职责分离思想；
  2. SpringMVC 的核心特性与执行流程；
  3. 基于 Maven+IDEA 的 SpringMVC 环境搭建；
  4. 控制器开发与请求映射、视图跳转的基本用法。

        下一篇博客将深入 SpringMVC 的核心功能，讲解请求映射、返回值类型与参数绑定，带你实现更灵活的业务逻辑开发。


文章转载自：

http://ZZ4wRHTT.yfcbf.cn
http://TiQnVLHR.yfcbf.cn
http://s0wxm8bI.yfcbf.cn
http://sYmCoQ8N.yfcbf.cn
http://vOArVqiV.yfcbf.cn
http://WEaFEnQc.yfcbf.cn
http://iK1F6QiB.yfcbf.cn
http://o5lFutxH.yfcbf.cn
http://JYa9o29F.yfcbf.cn
http://esVJ33Ry.yfcbf.cn
http://BUXbjFIw.yfcbf.cn
http://57TcMGsP.yfcbf.cn
http://h6vXWKSY.yfcbf.cn
http://S4ddcYG5.yfcbf.cn
http://0xziOD0u.yfcbf.cn
http://RPm0HLTI.yfcbf.cn
http://h2hhEwHP.yfcbf.cn
http://NIpNkLNp.yfcbf.cn
http://8gF9xWHf.yfcbf.cn
http://wdBrqsvW.yfcbf.cn
http://xfj8XDe1.yfcbf.cn
http://CUlzkNmP.yfcbf.cn
http://aVk0LpAt.yfcbf.cn
http://iVVtGH0k.yfcbf.cn
http://spxCOcgX.yfcbf.cn
http://ueX6YsSS.yfcbf.cn
http://kZx7u6lF.yfcbf.cn
http://r92OLm29.yfcbf.cn
http://1a0ISocy.yfcbf.cn
http://7LKddwO8.yfcbf.cn
http://www.dtcms.com/a/387731.html

相关文章：

  • AI+Playwright+Pytest 自动化测试方案：优势、劣势与实战融合
  • docker启动Nginx并配置SSL自动续期.md
  • OpenStack 学习笔记（三）：存储与计算核心组件管理实践
  • Linux文件IO与文件系统深度解析：从系统调用到文件系统原理
  • 如何在 2025 年绕过 Cloudflare 人工检查？
  • 【pycharm】index-tts2：之三 ：ubuntu24.04 体验tts demo
  • vivado中DDR4 仿真模型的获取
  • 《RocketMQ 2025 实战指南：从消息丢失 / 重复消费 / 顺序消费到事务消息，一篇搞定生产级问题（附完整代码）》
  • 十二、vue3后台项目系列——设置路由守卫，获取角色权限，获取角色路由列表、页面请求进度条
  • 6个AI论文网站排行，实测
  • Dioxus基础介绍和创建组件
  • 基于粒子群算法的山地环境无人机最短路径规划研究(含危险区域约束的三维优化方法)
  • ardupilot开发 --- 无人机数学模型与控制律分解 篇
  • 海外代理IP服务器平台测评，Tik Tok多账号运营稳定IP服务支持
  • 【面板数据】省及地级市农业新质生产力数据集（2002-2025年）
  • Linux的常用命令总结
  • Egg.js：企业级 Node.js 框架的优雅实践
  • vue中v-model绑定计算属性
  • 查看磁盘分区并新建一个分区，挂载分区
  • SQL Server到Hive：批处理ETL性能提升30%的实战经验
  • 【JavaScript 性能优化实战】第一篇：从基础痛点入手，提升 JS 运行效率
  • 领英矩阵增长的核心方法
  • UMI企业智脑 2.1.0：智能营销新引擎，图文矩阵引领内容创作新潮流
  • 测试你的 Next.-js 应用：Jest 和 React Testing Library
  • 第二十二篇｜新世界语学院教育数据深度解析：学制函数、能力矩阵与升学图谱
  • n8n自动化工作流学习笔记-生成动物跳水视频
  • 如何用快慢指针优雅地找到链表的中间结点？——LeetCode 876 题详解
  • 计算机听觉分类分析：从音频信号处理到智能识别的完整技术实战
  • [torch] xor 分类问题训练
  • React学习教程，从入门到精通，React 表单完整语法知识点与使用方法(22）