SpringMVC 入门：核心概念与第一个 HelloWorld 案例

引言

在 JavaWeb 开发中，MVC 模式是解决传统 Servlet 开发中 "代码耦合严重、维护困难" 的经典方案，而 SpringMVC 作为 Spring 生态的核心模块，凭借其 "轻量、灵活、易整合" 的特点，成为当前主流的 MVC 框架。本文将带新手快速入门 SpringMVC，理解其核心概念和工作流程，并通过一个完整的 HelloWorld 案例，让你动手搭建第一个 SpringMVC 项目。

一、先搞懂：SpringMVC 是什么？MVC 模式又是什么？

1. MVC 模式回顾

MVC 是 "Model-View-Controller" 的缩写，是一种软件架构模式，核心是 "职责分离"：

Model（模型）：处理业务逻辑和数据，比如实体类（POJO）、Service 层、DAO 层；
View（视图）：展示数据，比如 JSP、Thymeleaf、Vue 页面；
Controller（控制器）：接收请求、协调 Model 和 View，比如 SpringMVC 中的 Controller 类。

2. SpringMVC 的核心定位

SpringMVC 是基于 MVC 模式的请求驱动型框架，本质是对 Servlet 的封装，通过核心组件（如 DispatcherServlet）统一处理请求，简化开发流程，核心优势：

无需手动编写 Servlet，通过注解（如@Controller）快速定义控制器；
内置参数绑定、视图解析、异常处理等功能，减少重复代码；
与 Spring 无缝整合，轻松使用 Spring 的 IOC、AOP 等特性。

二、SpringMVC 核心组件与工作流程（关键！）

1. 5 个核心组件

SpringMVC 的请求处理依赖以下核心组件，缺一不可：

组件名称	作用
DispatcherServlet	前端控制器（核心），统一接收所有请求，分发到对应组件
HandlerMapping	处理器映射器，根据请求 URL 找到对应的 Controller 方法（如`@RequestMapping`）
HandlerAdapter	处理器适配器，调用 Controller 方法（处理参数绑定、类型转换）
ModelAndView	封装处理结果（数据 + 视图名），由 Controller 返回
ViewResolver	视图解析器，根据视图名找到实际视图（如 JSP 路径）

2. 请求处理完整流程（9 步）

用一张 "请求旅行图" 理解 SpringMVC 的工作过程：

浏览器发送请求（如http://localhost:8080/springmvc/hello）；
请求被 Tomcat 拦截，转发给DispatcherServlet（web.xml 中配置）；
DispatcherServlet调用HandlerMapping，根据 URL 找到对应的 Controller 方法；
HandlerMapping返回方法的映射信息给DispatcherServlet；
DispatcherServlet调用HandlerAdapter，适配并执行 Controller 方法；
Controller 方法处理业务，返回ModelAndView（如数据msg="Hello"+ 视图名"hello"）；
DispatcherServlet调用ViewResolver，根据视图名解析实际视图路径（如/WEB-INF/views/hello.jsp）；
ViewResolver返回解析后的视图对象给DispatcherServlet；
DispatcherServlet渲染视图（将 Model 数据传入视图），最终响应给浏览器。

三、动手实战：第一个 SpringMVC HelloWorld

1. 环境准备

开发工具：IDEA 2023 + Maven 3.8 + Tomcat 9
依赖版本：SpringMVC 5.3.28（与 Spring 核心版本一致）

2. 步骤 1：创建 Maven Web 项目

打开 IDEA → 新建 Maven 项目 → 选择maven-archetype-webapp → 填写 GroupId（如com.example）、ArtifactId（如springmvc-hello）；
补全项目结构：在src/main下新建java和resources目录（分别标记为 "Sources Root" 和 "Resources Root"）。

3. 步骤 2：导入 SpringMVC 依赖（pom.xml）

核心依赖包括 SpringMVC、Spring 核心、ServletAPI（需设置provided避免冲突）：

XML 复制代码

<dependencies>
    <!-- Spring核心 -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-context</artifactId>
        <version>5.3.28</version>
    </dependency>
    <!-- SpringMVC -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>5.3.28</version>
    </dependency>
    <!-- Servlet API（Tomcat已提供，无需打包） -->
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>4.0.1</version>
        <scope>provided</scope>
    </dependency>
    <!-- JSP API（可选，用于视图） -->
    <dependency>
        <groupId>javax.servlet.jsp</groupId>
        <artifactId>jsp-api</artifactId>
        <version>2.2</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

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

在WEB-INF下的web.xml中配置DispatcherServlet，指定 SpringMVC 配置文件路径：

XML 复制代码

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" 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>classpath:spring-mvc.xml</param-value>
        </init-param>
        <!-- 项目启动时加载Servlet -->
        <load-on-startup>1</load-on-startup>
    </servlet>
    <!-- 映射所有请求（除了.jsp）交给DispatcherServlet处理 -->
    <servlet-mapping>
        <servlet-name>springmvc</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
</web-app>

5. 步骤 4：配置 SpringMVC 核心文件（spring-mvc.xml）

在resources目录下新建spring-mvc.xml，配置组件扫描 （扫描 Controller）和视图解析器：

XML 复制代码

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="
        http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context.xsd">

    <!-- 1. 组件扫描：扫描Controller所在的包（替换为你的包路径） -->
    <context:component-scan base-package="com.example.controller"/>

    <!-- 2. 配置视图解析器：解析JSP视图 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <!-- 前缀：视图文件所在目录 -->
        <property name="prefix" value="/WEB-INF/views/"/>
        <!-- 后缀：视图文件后缀 -->
        <property name="suffix" value=".jsp"/>
    </bean>
</beans>

6. 步骤 5：编写 Controller（核心业务逻辑）

在com.example.controller包下新建HelloController，用@Controller和@RequestMapping定义请求映射：

java 复制代码

package com.example.controller;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller // 标记此类为SpringMVC控制器
public class HelloController {

    // 映射请求路径：http://localhost:8080/springmvc/hello
    @RequestMapping("/hello")
    public String hello(Model model) {
        // 1. 处理业务逻辑（这里模拟返回数据）
        String msg = "Hello, SpringMVC!";
        
        // 2. 将数据存入Model（类似request.setAttribute，供视图使用）
        model.addAttribute("message", msg);
        
        // 3. 返回视图名（会被视图解析器解析为：/WEB-INF/views/hello.jsp）
        return "hello";
    }
}

7. 步骤 6：编写视图（JSP 页面）

在WEB-INF下新建views目录，再新建hello.jsp，通过 EL 表达式获取 Model 中的数据：

复制代码

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>SpringMVC HelloWorld</title>
</head>
<body>
    <!-- 从Model中获取message值 -->
    <h1>${message}</h1>
</body>
</html>

8. 步骤 7：部署并测试

配置 Tomcat：IDEA 右侧 "Add Configuration" → 新增 "Tomcat Server" → 选择本地 Tomcat 路径；
部署项目：将springmvc-hello项目添加到 Tomcat 中，启动 Tomcat；
访问测试：打开浏览器输入http://localhost:8080/springmvc-hello/hello，页面显示Hello, SpringMVC!，说明项目成功！

四、入门小结

本文核心：理解 SpringMVC 的 "前端控制器 + 组件分工" 模式，记住 9 步工作流程；
关键注意点：
- web.xml中DispatcherServlet的url-pattern设为/（不要设为/*，否则会拦截 JSP）；
- spring-mvc.xml的组件扫描包路径必须正确，否则 Controller 无法被识别；
下一篇预告：深入 SpringMVC 核心组件的实现细节，以及开发中常用的 "参数绑定" 技术。