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

SpringMVC 入门教程

news 2025/7/27 22:09:44

一、SpringMVC 简介

SpringMVC 是基于 MVC 设计模式的轻量级 Web 框架，核心功能包括：

请求分发：通过 DispatcherServlet 统一处理请求。
注解驱动：使用 @Controller、@RequestMapping 简化开发。
视图解析：支持 JSP、Thymeleaf 等多种视图技术。

在三层架构中的位置：

表现层：SpringMVC 负责处理用户请求（如 /user/login.form）。
业务层：Spring 的 Service 层处理业务逻辑。
持久层：MyBatis 或 Hibernate 操作数据库。

二、项目快速搭建

1. 创建 Maven 项目

添加以下依赖（以 Spring 5.3.10 为例）：

<dependencies>
    <!-- SpringMVC 核心 -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>5.3.10</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-app>
    <servlet>
        <servlet-name>dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!-- 手动指定配置文件路径（推荐） -->
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:springmvc-config.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>dispatcher</servlet-name>
        <!-- 拦截规则配置 -->
        <url-pattern>*.form</url-pattern>
    </servlet-mapping>
</web-app>

3. 创建 SpringMVC 配置文件

文件：src/main/resources/springmvc-config.xml

<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xmlns:context="http://www.springframework.org/schema/context"
       xsi:schemaLocation="...">
    
    <!-- 扫描控制器包 -->
    <context:component-scan base-package="com.example.controller" />
    
    <!-- 开启注解驱动 -->
    <mvc:annotation-driven />
    
    <!-- 放行静态资源（可选） -->
    <mvc:resources mapping="/static/**" location="/static/" />
</beans>

三、核心配置详解

1. `servlet-name` 与配置文件的对应关系

默认规则：SpringMVC 默认加载 WEB-INF/[servlet-name]-servlet.xml（如 dispatcher-servlet.xml）。
自定义路径：通过 contextConfigLocation 参数指定配置文件路径（推荐）。

2. `url-pattern` 拦截模式

模式	行为	适用场景	注意事项
`*.form`	仅拦截以 `.form` 结尾的请求	传统 Web 项目	需手动放行静态资源
`/`	拦截所有非 JSP 请求（包括静态资源）	前后端分离项目	需配置静态资源映射
`/*`	拦截所有请求（包括 JSP）	不推荐使用	导致 JSP 无法渲染

3. 静态资源处理

在 springmvc-config.xml 中添加：

<mvc:resources mapping="/css/**" location="/css/" />
<mvc:resources mapping="/js/**" location="/js/" />

四、最佳实践与常见问题

1. 配置推荐

传统 Web 项目：使用 *.form 拦截模式，JSP 直接访问。
RESTful API 项目：使用 / 拦截模式，放行静态资源。

2. 常见问题解决

问题	原因	解决方案
静态资源 404	未配置资源映射	添加 `<mvc:resources>`
JSP 无法访问	误用 `/*` 拦截模式	改为 `/` 或 `.form` 模式
Controller 未生效	包扫描路径错误	检查 `component-scan` 配置

五、完整配置示例

`web.xml`

<web-app>
    <servlet>
        <servlet-name>dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:springmvc-config.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>dispatcher</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
</web-app>

`springmvc-config.xml`

<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xmlns:context="http://www.springframework.org/schema/context"
       xsi:schemaLocation="...">
    
    <!-- 控制器包扫描 -->
    <context:component-scan base-package="com.example.controller" />
    
    <!-- 开启注解驱动 -->
    <mvc:annotation-driven />
    
    <!-- 静态资源放行 -->
    <mvc:resources mapping="/static/**" location="/static/" />
</beans>

六、扩展内容

RESTful 支持：使用 @GetMapping、@PostMapping 简化请求映射。
数据绑定：通过 @RequestParam 获取参数，@RequestBody 接收 JSON。
视图解析器：配置 InternalResourceViewResolver 简化视图路径：

<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
    <property name="prefix" value="/WEB-INF/views/" />
    <property name="suffix" value=".jsp" />
</bean>