1. SpringMVC 简介
SpringMVC 是 Spring 框架中的一个 Web 层框架，基于 MVC（Model-View-Controller） 设计模式，提供了清晰的分层结构，适用于 Web 应用开发
SpringMVC 主要组件
- DispatcherServlet（前端控制器）：拦截所有请求并进行分发
- HandlerMapping（处理器映射器）：确定请求由哪个控制器方法来处理
- Controller（控制器）：负责处理具体的请求逻辑
- ViewResolver（视图解析器）：解析视图，渲染最终页面
- ModelAndView（模型和视图）：封装数据和视图信息
SpringMVC 执行流程
2. SpringMVC 项目搭建（Spring 6.1.14）
2.1 引入 Maven 依赖
在 pom.xml 文件中添加以下依赖：
java
<dependencies>
<!-- Spring Web -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>6.1.14</version>
</dependency>
<!-- Servlet API -->
<dependency>
<groupId>jakarta.servlet</groupId>
<artifactId>jakarta.servlet-api</artifactId>
<version>6.0.0</version>
<scope>provided</scope>
</dependency>
<!-- Jackson 用于 JSON 解析 -->
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.16.0</version>
</dependency>
</dependencies>2.2 配置 SpringMVC（Java 配置方式）
2.2.1 Web 初始化配置
使用 WebApplicationInitializer 代替 web.xml，实现 SpringMVC 自动初始化
java
import jakarta.servlet.ServletContext;
import jakarta.servlet.ServletException;
import jakarta.servlet.ServletRegistration;
import org.springframework.web.WebApplicationInitializer;
import org.springframework.web.context.support.AnnotationConfigWebApplicationContext;
import org.springframework.web.servlet.DispatcherServlet;
public class WebAppInitializer implements WebApplicationInitializer {
@Override
public void onStartup(ServletContext servletContext) throws ServletException {
AnnotationConfigWebApplicationContext context = new AnnotationConfigWebApplicationContext();
context.register(SpringMvcConfig.class);
ServletRegistration.Dynamic dispatcher = servletContext.addServlet("dispatcher", new DispatcherServlet(context));
dispatcher.setLoadOnStartup(1);
dispatcher.addMapping("/*");
}
}2.2.2 SpringMVC 配置类
java
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.ViewResolver;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
import org.springframework.web.servlet.view.InternalResourceViewResolver;
@Configuration
@EnableWebMvc
@ComponentScan("com.alivinfer.controller")
public class SpringMvcConfig implements WebMvcConfigurer {
@Bean
public ViewResolver viewResolver() {
InternalResourceViewResolver resolver = new InternalResourceViewResolver();
resolver.setPrefix("/WEB-INF/views/");
resolver.setSuffix(".jsp");
return resolver;
}
@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
registry.addResourceHandler("/static/**").addResourceLocations("/static/");
}
}2.3 创建 Controller 处理请求
java
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
@RequestMapping("/user")
public class UserController {
@GetMapping("/hello")
public String sayHello() {
return "Hello, SpringMVC!";
}
}2.4 创建 JSP 视图
在 webapp/WEB-INF/views/hello.jsp 文件中：
jsp
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<html>
<head>
<title>Hello SpringMVC</title>
</head>
<body>
<h2>Hello, SpringMVC</h2>
</body>
</html>3. 运行与测试
- 启动 Tomcat 或其他 Servlet 容器
- 访问
http://localhost:8080/user/hello，返回Hello, SpringMVC! - 访问
http://localhost:8080/hello.jsp，查看 JSP 视图
4. 可能遇到的问题
4.1 NoSuchMethodError: java.util.LinkedHashSet
如果运行时报 java.util.LinkedHashSet 相关错误，可能是 Spring 版本与 Jakarta 依赖不兼容，请检查以下内容：
- Spring 6+ 需要 Jakarta EE 9+，务必使用
**jakarta.servlet-api 6.0.0+** - 确保
spring-webmvc和spring-context版本一致
4.2 404 Not Found
- 检查
WebAppInitializer是否正确注册了DispatcherServlet - 确保
@ComponentScan扫描到了Controller - 试试清理项目
mvn clean，然后mvn package重新部署
5. 总结
本文主要介绍了 SpringMVC 的基本概念，并基于 Spring 6.1.14 搭建了一个简单的 MVC 应用，包括：
- Maven 依赖
DispatcherServlet配置Controller控制器- 视图解析
- 可能遇到的错误及解决方案