1. 引言
1.1 Spring MVC 概述
Spring MVC(Model-View-Controller)是 Spring 框架的一部分,专门用于设计创建分层的 Java Web 应用。它是一个全功能的 MVC 模块,能够提供强大的配置选项,并利用默认的约定,使基本项目的配置降至最低。Spring MVC 提供了一种分离的方式,使得能够通过控制器(Controller)进行业务处理,模型(Model)进行数据处理,视图(View)进行展示处理,这样使得 Web 层的开发变得更加简洁明了。
1.2 Spring MVC 在 MVC 架构中的位置
MVC(Model-View-Controller)是一种设计模式,用于将应用程序的数据(Model),用户界面(View),和处理用户输入(Controller)的逻辑分离开。Spring MVC 作为 MVC 中的 “C” - 控制器,它的主要任务是将用户的请求路由到相应的服务接口,然后再将处理结果返回给用户。
在 MVC 架构中,Spring MVC 通过控制器接收用户请求,根据请求的 URL,将请求路由到相应的服务处理逻辑。服务处理完请求后,会返回一个模型(Model)和对应的视图名称给控制器,控制器再通过视图解析器找到相应的视图,将模型数据填充到视图中,生成响应返回给用户。
通过这样的设计,我们可以将请求处理逻辑、数据处理逻辑和展示逻辑清晰地分开,极大地提高了代码的可读性和可维护性,这也是使用 Spring MVC 的一大优势。
2. Spring MVC 的工作流程
Spring MVC 的工作流程是一种典型的前端控制器设计模式,当一个请求到达 Spring MVC 框架时,其主要流程如下:
2.1 DispatcherServlet (前端控制器)
DispatcherServlet 是整个 Spring MVC 框架的入口,它负责接收所有的 HTTP 请求并分发给对应的处理器。在具体的工作过程中,DispatcherServlet 扮演着前端控制器的角色,其主要职责包括:
请求的拦截:所有经过 DispatcherServlet 的请求都会被拦截,它将作为请求的第一站。
请求的分发:根据处理器映射器(HandlerMapping)找到的处理器(Handler,通常是一个 Controller),DispatcherServlet 将请求转发给对应的处理器进行处理。
2.2 HandlerMapping (处理器映射器)
处理器映射器 HandlerMapping 的主要任务是根据请求的 URL 找到对应的处理器(Handler)。在 Spring MVC 中,Handler 通常就是我们的 Controller 控制器,HandlerMapping 负责将请求 URL 和对应的 Controller 进行关联。
一般情况下,我们会在 Controller 的类或方法上使用 @RequestMapping 注解来映射 URL 和处理器。这种映射关系会在服务器启动时被解析并保存,当一个请求到来时,HandlerMapping 会根据这些映射关系找到最匹配的 Controller。
2.3 Handler (处理器)
找到对应的 Handler(Controller)后,DispatcherServlet 会将请求传递给该 Handler 进行处理。Handler 会处理请求,并返回一个 ModelAndView 对象。ModelAndView 包含了视图名和模型数据,视图名用于之后的视图解析,模型数据则用于填充到视图中。
这个部分我们会在接下来的章节中进行详细的讨论,包括如何编写 Controller,如何处理请求参数,如何返回视图等等。
以上就是 Spring MVC 工作流程中的前两个重要组件,接下来我们将讨论 HandlerAdapter,ViewResolver 和 View。## 2.3 Controller (控制器)
在 Spring MVC 中,Controller 负责处理由 DispatcherServlet 分发的请求。它将业务处理逻辑和数据封装在 ModelAndView 中,并将其返回给 DispatcherServlet。Controller 是一个接口,而我们通常会使用它的实现类,如 @Controller 或 @RestController 来创建控制器类。
在 Controller 中,我们可以定义方法来处理不同的 HTTP 请求,如 GET、POST、PUT、DELETE 等。这些方法可以直接将结果返回(例如,返回一个 JSON 对象或字符串),也可以返回一个 ModelAndView 对象,包含了视图名称和数据模型。
2.4 ModelAndView
ModelAndView 是 Spring MVC 中一个非常重要的概念。它包含了视图名(View name)和模型(Model)。视图名是一个字符串,用来标识需要渲染的视图,而模型则是一个 Map 类型的对象,用来保存渲染视图时所需要的数据。
当我们在 Controller 中处理完一个请求后,可以创建一个 ModelAndView 对象,将处理结果放入模型中,然后设置视图名。当 DispatcherServlet 接收到 ModelAndView 后,会使用视图解析器(ViewResolver)来找到对应的视图,并将模型中的数据填充到视图中。
2.5 ViewResolver (视图解析器)
视图解析器的主要任务是根据视图名找到对应的视图。在 Spring MVC 中,视图并不仅仅是 JSP 或 Thymeleaf 这样的模板文件,还可以是 JSON、XML 或其他格式的数据。
在 Spring MVC 配置中,我们可以定义视图解析器,并指定其前缀和后缀。例如,如果我们设置了前缀为 /WEB-INF/views/,后缀为 .jsp,那么当视图名为 home 时,视图解析器会解析为 /WEB-INF/views/home.jsp。这样,我们就可以将视图文件统一放在 /WEB-INF/views/ 目录下,而在控制器中,我们只需要返回视图名,而不需要关心视图文件的具体位置和后缀。
至此,我们已经了解了 Spring MVC 工作流程中的五个主要部分,接下来我们将进一步深入了解如何在实际开发中使用 Spring MVC。
3. Spring MVC 基础应用
3.1 环境搭建
首先,我们需要搭建 Spring MVC 的开发环境。这通常包括以下步骤:
创建一个新的 Maven 或 Gradle 项目。
- 添加 Spring MVC 的依赖。在 Maven 的 pom.xml 文件中,我们可以添加如下依赖:
<dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>5.3.8</version> </dependency>
创建 Java 源代码目录和资源文件目录。Java 源代码通常位于 src/main/java 目录,而 JSP、静态资源和配置文件则位于 src/main/webapp 目录。
创建 Spring 配置文件。我们可以创建一个 src/main/webapp/WEB-INF/appContext.xml 文件,用来配置 Spring MVC 的组件。
3.2 创建 Controller
在 src/main/java
目录下,我们可以创建一个 Controller 类来处理请求。以下是一个简单的例子:
import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.servlet.ModelAndView; @Controller public class HelloController { @RequestMapping("/hello") public ModelAndView hello() { ModelAndView mav = new ModelAndView(); mav.addObject("message", "Hello Spring MVC!"); mav.setViewName("hello"); return mav; } }
在上述代码中,@Controller
注解表明这是一个 Controller 类,@RequestMapping("/hello")
注解将 hello
方法映射到 /hello
路径。
3.3 配置 DispatcherServlet 和 Spring MVC
我们需要在 src/main/webapp/WEB-INF/web.xml
文件中配置 DispatcherServlet。以下是一个例子:
<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>/WEB-INF/appContext.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>
在上述配置中,我们设置了 DispatcherServlet 的初始化参数 contextConfigLocation,指向了我们的 Spring 配置文件 appContext.xml。同时,我们将 / 路径映射到了 DispatcherServlet,这意味着所有的请求都会被 DispatcherServlet 处理。
在 appContext.xml 文件中,我们需要配置 Spring MVC 的组件,如 Controller、ViewResolver 等。
3.4 运行和测试
在完成了以上配置后,我们就可以运行和测试我们的 Spring MVC 应用了。可以使用内置的 Tomcat、Jetty 等服务器,或者将应用部署到独立的服务器上进行测试。
通过在浏览器中访问 `http
😕/localhost:8080/hello`,我们就可以看到 Controller 返回的 “Hello Spring MVC!” 消息了。
4. Spring MVC 高级应用
4.1 数据绑定
Spring MVC 提供了强大的数据绑定功能,可以将请求参数自动绑定到 Controller 方法的参数上。例如,我们可以在 Controller 方法的参数中使用 @RequestParam
注解来绑定请求参数:
@RequestMapping("/greet") public String greet(@RequestParam String name) { return "Hello, " + name; }
Spring MVC 还支持复杂类型的数据绑定。例如,我们可以定义一个 User 类,然后在 Controller 方法的参数中使用 User 类型的参数,Spring MVC 会自动将请求参数绑定到 User 对象的属性上:
@RequestMapping("/register") public String register(User user) { // ... }