Spring MVC：从历史演变到实战入门

1. Java Web的发展历史与MVC模式

1.1 Model I与Model II的演进

Model I（JSP+JavaBean）
作为早期Java Web开发的主流模式，其核心架构如下：

graph LR
A[客户端] --> B[JSP页面]
B --> C{业务逻辑}
C --> D[JavaBean]
D --> B
B --> A

痛点分析：

• JSP同时承担视图渲染与业务控制，代码耦合度高

• 项目规模扩大后维护成本指数级增长

Model II（Servlet+JSP+JavaBean）
通过分层思想实现解耦：

graph LR
A[客户端] --> B[Servlet]
B --> C{控制逻辑}
C --> D[JavaBean]
D --> E[JSP]
E --> A

优势：

• 职责分离：Servlet负责流程控制，JSP专注视图展示

• 更适合大型项目开发

1.2 MVC设计模式的精髓

组件	职责说明	具体实现
Model	数据处理与业务逻辑	Service/Dao/Entity
View	用户界面与数据展示	JSP/Thymeleaf模板
Controller	请求调度与响应处理	@Controller注解类

2. Spring MVC快速入门实战

2.1 环境搭建（IntelliJ IDEA演示）

Maven依赖配置：

<properties>
    <spring.version>5.3.18</spring.version>
</properties>

<dependencies>
    <!-- Spring MVC核心 -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>${spring.version}</version>
    </dependency>
    
    <!-- 视图解析 -->
    <dependency>
        <groupId>org.thymeleaf</groupId>
        <artifactId>thymeleaf-spring5</artifactId>
        <version>3.0.15.RELEASE</version>
    </dependency>
</dependencies>

2.2 核心配置详解

web.xml配置：

<!-- 字符编码过滤器 -->
<filter>
    <filter-name>encodingFilter</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>
</filter>

<!-- 前端控制器 -->
<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:spring-mvc.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
</servlet>

Spring MVC配置（spring-mvc.xml）：

<!-- 组件扫描 -->
<context:component-scan base-package="com.example.controller"/>

<!-- 视图解析器 -->
<bean class="org.thymeleaf.spring5.view.ThymeleafViewResolver">
    <property name="templateEngine" ref="templateEngine"/>
</bean>

<!-- 模板引擎配置 -->
<bean id="templateEngine" class="org.thymeleaf.spring5.SpringTemplateEngine">
    <property name="templateResolver">
        <bean class="org.thymeleaf.spring5.templateresolver.SpringResourceTemplateResolver">
            <property name="prefix" value="/WEB-INF/views/"/>
            <property name="suffix" value=".html"/>
        </bean>
    </property>
</bean>

2.3 控制器开发实例

@Controller
public class HelloController {

    @GetMapping("/hello")
    public String sayHello(Model model) {
        model.addAttribute("message", "Welcome to Spring MVC!");
        return "result-page";
    }
}

页面结构：

src
├── main
│   ├── webapp
│   │   └── WEB-INF
│   │       └── views
│   │           └── result-page.html

3. Spring MVC核心原理剖析

3.1 请求处理全流程

1. DispatcherServlet接收请求
   作为统一入口，拦截所有HTTP请求

2. HandlerMapping路由匹配
   根据URL找到对应的Controller方法

3. HandlerAdapter执行处理
   通过反射调用目标方法

4. 视图解析与渲染
   将逻辑视图名转换为物理视图路径

sequenceDiagram
客户端->>DispatcherServlet: HTTP请求
DispatcherServlet->>HandlerMapping: 查询处理器
HandlerMapping-->>DispatcherServlet: 返回Handler
DispatcherServlet->>HandlerAdapter: 执行处理器
HandlerAdapter->>Controller: 调用方法
Controller-->>HandlerAdapter: 返回ModelAndView
HandlerAdapter-->>DispatcherServlet: 返回结果
DispatcherServlet->>ViewResolver: 解析视图
ViewResolver-->>DispatcherServlet: 返回视图
DispatcherServlet->>View: 渲染视图
View-->>客户端: 响应HTML

3.2 核心组件详解

组件	职责说明	默认实现类
HandlerMapping	请求到处理器的映射	RequestMappingHandlerMapping
HandlerAdapter	执行处理器方法	RequestMappingHandlerAdapter
ViewResolver	解析逻辑视图名	InternalResourceViewResolver
HandlerExceptionResolver	异常处理	ExceptionHandlerExceptionResolver

---

4. 开发技巧与最佳实践

1. RESTful风格设计

@RestController
@RequestMapping("/api/users")
public class UserController {
    
    @GetMapping("/{id}")
    public ResponseEntity<User> getUser(@PathVariable Long id) {
        // 业务逻辑
    }
}

        2.统一异常处理

@ControllerAdvice
public class GlobalExceptionHandler {
    
    @ExceptionHandler(Exception.class)
    public ModelAndView handleException(Exception ex) {
        ModelAndView mav = new ModelAndView();
        mav.addObject("errorMsg", ex.getMessage());
        mav.setViewName("error-page");
        return mav;
    }
}

3. 参数验证技巧

@PostMapping("/register")
public String register(@Valid User user, BindingResult result) {
    if (result.hasErrors()) {
        return "register-form";
    }
    // 处理注册逻辑
}

5. 常见问题排查指南

问题1：404未找到页面
✅ 检查项：

• 控制器是否添加@Controller注解

• 请求路径是否匹配@RequestMapping

• 视图文件位置是否符合配置的prefix/suffix

问题2：参数绑定失败
✅ 解决方案：

• 检查表单字段名与POJO属性名是否一致

• 使用@RequestParam指定参数名称

• 添加BindingResult参数捕获错误

6. 性能优化建议

1. 启用缓存

@Cacheable("users")
@GetMapping("/{id}")
public User getUser(@PathVariable Long id) {
    // 数据库查询
}

         2.异步处理

@Async
public CompletableFuture<User> fetchUserAsync(Long id) {
    // 异步操作
}

         3.静态资源优化

结语

<mvc:resources mapping="/static/**" location="/static/" cache-period="31556926"/>

通过本文的学习，我们不仅掌握了Spring MVC的核心原理，还完成了从环境搭建到实战开发的完整流程。建议读者在掌握基础后，继续深入以下方向：

1. 深入理解拦截器(Interceptor)机制

2. 研究Spring Boot对MVC的自动化配置

3. 探索响应式编程WebFlux框架