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

Spring MVC深度解析：从原理到实战

news 来源：原创 2025/4/29 7:46:20

文章目录

    • 一、Spring MVC概述
      • 1.1 MVC设计模式
      • 1.2 Spring MVC特点
    • 二、Spring MVC核心组件
      • 2.1 架构流程图解
      • 2.2 核心组件说明
    • 三、环境搭建与配置
      • 3.1 Maven依赖
      • 3.2 传统XML配置 vs JavaConfig
    • 四、控制器开发实践
      • 4.1 基础控制器示例
      • 4.2 请求映射注解
    • 五、数据处理与绑定
      • 5.1 表单处理示例
      • 5.2 数据验证
    • 六、视图技术集成
      • 6.1 Thymeleaf配置
      • 6.2 JSP视图示例
    • 七、RESTful API开发
      • 7.1 REST控制器
    • 八、高级特性
      • 8.1 拦截器实现
      • 8.2 全局异常处理
    • 九、最佳实践建议
    • 十、常见问题排查

在这里插入图片描述

一、Spring MVC概述

1.1 MVC设计模式

MVC（Model-View-Controller）是一种经典的软件架构模式，将应用程序分为三个核心组件：

  • Model：数据模型，负责业务逻辑和数据管理
  • View：视图层，负责数据展示
  • Controller：控制器，处理用户请求并协调Model和View

1.2 Spring MVC特点

  • 基于DispatcherServlet的前端控制器模式
  • 灵活的配置方式（注解驱动）
  • 强大的数据绑定和验证机制
  • 支持多种视图技术（JSP、Thymeleaf等）
  • 与Spring框架无缝集成

二、Spring MVC核心组件

2.1 架构流程图解

[客户端] --> [DispatcherServlet] --> [HandlerMapping]--> [Controller] --> [ModelAndView]--> [ViewResolver]--> [视图]

2.2 核心组件说明

  • DispatcherServlet：前端控制器，统一处理请求
  • HandlerMapping：请求到处理器的映射
  • Controller：业务逻辑处理器
  • ViewResolver：视图解析器
  • HandlerAdapter：处理器适配器
  • Model：数据模型容器

三、环境搭建与配置

3.1 Maven依赖

<dependencies><!-- Spring MVC --><dependency><groupId>org.springframework</groupId><artifactId>spring-webmvc</artifactId><version>5.3.20</version></dependency><!-- Servlet API --><dependency><groupId>javax.servlet</groupId><artifactId>javax.servlet-api</artifactId><version>4.0.1</version><scope>provided</scope></dependency>
</dependencies>

3.2 传统XML配置 vs JavaConfig

XML配置示例：

<!-- web.xml -->
<servlet><servlet-name>dispatcher</servlet-name><servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class><init-param><param-name>contextConfigLocation</param-name><param-value>/WEB-INF/spring-mvc.xml</param-value></init-param>
</servlet>

JavaConfig实现：

@Configuration
@EnableWebMvc
@ComponentScan("com.example.controller")
public class WebConfig implements WebMvcConfigurer {@Beanpublic ViewResolver viewResolver() {InternalResourceViewResolver resolver = new InternalResourceViewResolver();resolver.setPrefix("/WEB-INF/views/");resolver.setSuffix(".jsp");return resolver;}
}

四、控制器开发实践

4.1 基础控制器示例

@Controller
@RequestMapping("/user")
public class UserController {@GetMapping("/profile")public String showProfile(Model model) {User user = userService.getCurrentUser();model.addAttribute("user", user);return "profile";}@PostMapping("/update")public String updateProfile(@Valid UserForm form, BindingResult result) {if (result.hasErrors()) {return "edit-profile";}userService.updateUser(form);return "redirect:/user/profile";}
}

4.2 请求映射注解

  • @RequestMapping：通用请求映射
  • @GetMapping/@PostMapping：特定HTTP方法映射
  • @PathVariable：URL模板变量
  • @RequestParam：请求参数绑定
@GetMapping("/articles/{id}")
public String getArticle(@PathVariable Long id,@RequestParam(defaultValue = "desc") String sort,Model model) {// 业务逻辑return "article-detail";
}

在这里插入图片描述

五、数据处理与绑定

5.1 表单处理示例

@Controller
@RequestMapping("/product")
public class ProductController {@GetMapping("/create")public String showForm(Model model) {model.addAttribute("product", new Product());return "product-form";}@PostMapping("/save")public String saveProduct(@ModelAttribute("product") Product product,BindingResult result) {if (result.hasErrors()) {return "product-form";}productService.save(product);return "redirect:/product/list";}
}

5.2 数据验证

public class Product {@NotBlank(message = "产品名称不能为空")@Size(max = 50, message = "名称长度不能超过50字符")private String name;@Min(value = 0, message = "价格不能为负数")private BigDecimal price;// getters/setters
}

六、视图技术集成

6.1 Thymeleaf配置

@Configuration
@EnableWebMvc
public class ThymeleafConfig {@Beanpublic SpringResourceTemplateResolver templateResolver() {SpringResourceTemplateResolver resolver = new SpringResourceTemplateResolver();resolver.setPrefix("/WEB-INF/views/");resolver.setSuffix(".html");resolver.setTemplateMode("HTML5");resolver.setCharacterEncoding("UTF-8");return resolver;}@Beanpublic SpringTemplateEngine templateEngine() {SpringTemplateEngine engine = new SpringTemplateEngine();engine.setTemplateResolver(templateResolver());return engine;}
}

6.2 JSP视图示例

<%@ page contentType="text/html;charset=UTF-8" %>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<html>
<head><title>用户列表</title>
</head>
<body><h2>用户列表</h2><table><tr><th>ID</th><th>用户名</th><th>邮箱</th></tr><c:forEach items="${users}" var="user"><tr><td>${user.id}</td><td>${user.username}</td><td>${user.email}</td></tr></c:forEach></table>
</body>
</html>

七、RESTful API开发

在这里插入图片描述

7.1 REST控制器

@RestController
@RequestMapping("/api/users")
public class UserApiController {@Autowiredprivate UserService userService;@GetMappingpublic ResponseEntity<List<User>> getAllUsers() {return ResponseEntity.ok(userService.findAll());}@GetMapping("/{id}")public ResponseEntity<User> getUserById(@PathVariable Long id) {return userService.findById(id).map(ResponseEntity::ok).orElse(ResponseEntity.notFound().build());}@PostMappingpublic ResponseEntity<User> createUser(@RequestBody @Valid User user) {User savedUser = userService.save(user);return ResponseEntity.created(URI.create("/api/users/" + savedUser.getId())).body(savedUser);}
}

在这里插入图片描述

八、高级特性

在这里插入图片描述

8.1 拦截器实现

public class AuthInterceptor implements HandlerInterceptor {@Overridepublic boolean preHandle(HttpServletRequest request, HttpServletResponse response,Object handler) throws Exception {if (request.getSession().getAttribute("user") == null) {response.sendRedirect("/login");return false;}return true;}
}// 注册拦截器
@Configuration
public class WebConfig implements WebMvcConfigurer {@Overridepublic void addInterceptors(InterceptorRegistry registry) {registry.addInterceptor(new AuthInterceptor()).addPathPatterns("/**").excludePathPatterns("/login", "/register");}
}

8.2 全局异常处理

@ControllerAdvice
public class GlobalExceptionHandler {@ExceptionHandler(ResourceNotFoundException.class)public ResponseEntity<ErrorResponse> handleNotFound(ResourceNotFoundException ex) {ErrorResponse error = new ErrorResponse();error.setTimestamp(LocalDateTime.now());error.setStatus(HttpStatus.NOT_FOUND.value());error.setMessage(ex.getMessage());return new ResponseEntity<>(error, HttpStatus.NOT_FOUND);}@ExceptionHandler(MethodArgumentNotValidException.class)public ResponseEntity<ErrorResponse> handleValidationException(MethodArgumentNotValidException ex) {List<String> errors = ex.getBindingResult().getFieldErrors().stream().map(FieldError::getDefaultMessage).collect(Collectors.toList());ErrorResponse error = new ErrorResponse();error.setStatus(HttpStatus.BAD_REQUEST.value());error.setMessage("Validation failed");error.setDetails(errors);return new ResponseEntity<>(error, HttpStatus.BAD_REQUEST);}
}

九、最佳实践建议

  1. 遵循分层架构原则：

    • Controller层保持精简
    • 业务逻辑放在Service层
    • 数据访问使用Repository模式

  2. 使用DTO进行数据传输：

    public class UserDTO {private String username;private String email;// 省略getter/setter
}@PostMapping
public ResponseEntity<User> createUser(@RequestBody UserDTO dto) {User user = userConverter.convertToEntity(dto);// ...
}

  3. 性能优化建议：

    • 合理使用缓存（@Cacheable）
    • 启用GZIP压缩
    • 异步处理（@Async）

  4. 安全注意事项：

    • 使用CSRF保护
    • 输入验证和输出编码
    • 参数化查询防止SQL注入

十、常见问题排查

  1. 404错误排查步骤：

    • 检查@RequestMapping注解路径
    • 确认视图解析器配置
    • 查看组件扫描范围

  2. 数据绑定失败处理：

    • 检查字段名称是否匹配
    • 验证数据类型是否兼容
    • 使用@InitBinder进行自定义绑定

  3. 性能问题分析：

    • 使用Spring Actuator监控端点
    • 分析数据库查询性能
    • 检查视图渲染时间

相关文章：

  • MySQL最新安装、连接、卸载教程（Windows下）
  • 汽车网络安全 -- 理解暴露面、攻击面和攻击向量
  • ppt流程图怎么？ppt流程图模板大全
  • 阿里云直接对系统云盘扩容
  • 李沐动手深度学习（pycharm中运行笔记）——07.自动求导
  • 用Function Calling让GPT查询数据库（含示例）
  • 视觉“解锁”触觉操控：Franka机器人如何玩转刚柔物体？
  • 【上位机——MFC】视图
  • 贪吃蛇游戏demo
  • 重塑编程体验边界：明基RD280U显示器深度体验
  • Git和Gitlab的部署和操作
  • 小球在摆线上下落的物理过程MATLAB代码
  • Kotlin中的also、apply、invoke用法详解
  • 【音视频】SDL事件
  • 操作系统：计算机世界的基石与演进
  • 内耗型选手如何能做到不内耗？
  • 力扣4-最长公共前缀
  • 每天五分钟深度学习框架pytorch:使用visdom绘制损失函数图像
  • LCD1602液晶显示屏详解（STM32)
  • 误触网络重置，笔记本电脑wifi连接不上解决方法（Win10，Win11通用）
  • 我驻阿巴斯总领馆：将持续跟踪港口爆炸事件进展，全力确保中方人员安全
  • 特朗普将举行集会庆祝重返白宫执政百日，被指时机不当
  • 2025年上海空间信息大会举行，重大项目集中签约
  • 阿联酋启动第三届全球航空奖评选，奖金总额达百万美元
  • 欢迎回家！日本和歌山县4只大熊猫将于6月底送返中国
  • 专访｜攸佳宁：手机只是矛盾导火索，重要的是看见孩子的内心