Spring MVC 基础源码分析

引言

Spring MVC 是一种基于 Java 的 Web 框架，主要用于创建动态 Web 应用程序。其核心理念是“模型-视图-控制器”（MVC），通过分离业务逻辑、用户界面和输入控制，使得应用程序的开发、测试和维护变得更加容易。

在本文中，我们将深入分析 Spring MVC 的核心源码，理解其工作原理，并通过实际案例来展示其用法。

Spring MVC 概述

Spring MVC 是 Spring Framework 的一部分，它提供了一种灵活的方式来构建 Web 应用程序。它支持 RESTful API 的构建，可以与多种视图技术（如 JSP、Thymeleaf、FreeMarker 等）集成。

主要特性

注解驱动：支持使用注解来定义控制器和请求映射。
强大的数据绑定：自动将请求参数绑定到 Java 对象。
视图解析：支持多种视图技术，并允许自定义视图解析器。
拦截器：可以在请求处理之前或之后执行特定的操作。

核心组件分析

DispatcherServlet

DispatcherServlet 是 Spring MVC 的核心，它负责接收和处理所有的 HTTP 请求。每当请求发送到服务器时，DispatcherServlet 会根据配置的信息找到相应的处理器进行处理。

关键方法

doDispatch(HttpServletRequest request, HttpServletResponse response)：实现请求的分发逻辑。
getHandler(HttpServletRequest request)：获取处理该请求的控制器。

HandlerMapping

HandlerMapping 是一个接口，它的实现类负责将请求 URL 映射到具体的处理器。Spring 提供了多种实现，如 RequestMappingHandlerMapping 和 SimpleUrlHandlerMapping。

工作流程

DispatcherServlet 接收到请求后，通过 HandlerMapping 查找适合的处理器。
如果找到，DispatcherServlet 将请求转发给该处理器执行。

HandlerAdapter

HandlerAdapter 负责调用处理器的方法。由于不同类型的处理器可能有不同的调用方式，因此 HandlerAdapter 提供了一种统一的调用方式。

关键方法

handle(HttpServletRequest request, HttpServletResponse response, Object handler)：执行处理器的方法。

ViewResolver

ViewResolver 的作用是将逻辑视图名称解析为实际的视图对象。它允许开发者灵活地选择视图技术。

常见实现

InternalResourceViewResolver：将逻辑视图名称解析为 JSP 路径。
ThymeleafViewResolver：将逻辑视图名称解析为 Thymeleaf 模板。

请求处理流程

请求处理流程通常如下：

接收请求：DispatcherServlet 接收 HTTP 请求。
查找处理器：通过 HandlerMapping 确定适合的处理器。
调用处理器：使用 HandlerAdapter 调用处理器的方法。
返回视图：处理器返回逻辑视图名称。
解析视图：ViewResolver 将逻辑视图名称解析为视图对象。
渲染视图：将模型数据传递给视图并渲染。

案例分析

简单的控制器示例

下面是一个简单的 Spring MVC 控制器示例，该示例展示了如何创建一个基本的控制器并处理请求。

Controller 类

javaCopy Code
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.ui.Model;

@Controller
public class HelloController {

    @GetMapping("/hello")
    public String hello(@RequestParam(name = "name", required = false, defaultValue = "World") String name, Model model) {
        model.addAttribute("name", name);
        return "hello";
    }
}

配置文件

在 Spring 配置文件中，我们需要配置 DispatcherServlet 和视图解析器。

xmlCopy Code
<beans xmlns="http://www.springframework.org/schema/beans"
       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">

    <servlet>
        <servlet-name>dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <load-on-startup>1</load-on-startup>
    </servlet>

    <servlet-mapping>
        <servlet-name>dispatcher</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

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

JSP 文件

在 WEB-INF/views 目录下创建一个 hello.jsp 文件。

jspCopy Code
<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>
<html>
<head>
    <title>Hello</title>
</head>
<body>
    <h1>Hello, ${name}!</h1>
</body>
</html>

集成 Thymeleaf 作为视图

我们还可以使用 Thymeleaf 作为视图技术。以下是如何集成 Thymeleaf 的步骤。

Maven 依赖

在 pom.xml 中添加 Thymeleaf 相关依赖。

xmlCopy Code
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>

修改控制器

控制器无需修改，因为返回的逻辑视图名称仍然是相同的。

Thymeleaf 模板

在 src/main/resources/templates 目录下创建一个 hello.html 文件。

htmlCopy Code
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>Hello</title>
</head>
<body>
    <h1 th:text="'Hello, ' + ${name} + '!'"></h1>
</body>
</html>

整体运行

在浏览器中访问 http://localhost:8080/hello?name=Spring，将会看到页面输出 Hello, Spring!。

总结

在本文中，我们深入分析了 Spring MVC 的基础源码及其核心组件的工作原理。通过具体的实例，我们展示了如何使用 Spring MVC 创建简单的 Web 应用程序。

Spring MVC 不仅提供了强大的功能，还具有良好的可扩展性。通过理解其内部工作原理，开发者能够更好地利用这一框架创建高效的 Web 应用程序。

随着 Web 技术的发展，Spring MVC 不断演进，适应现代 Web 开发的需求。无论是传统的 Web 应用，还是现代的 RESTful API，Spring MVC 都能提供强有力的支持。