Spring MVC 的入门案例
MVC 模式是一种应用程序架构,它将应用程序分为控制器(Controller)、模型(Model)、视图(View) 3个部分。而 Spring MVC 就是对 MVC 模式的一种实现,它是围绕着 DispatcherServlet 进行设计的。DispatcherServlet 是一个 Java Servlet ,它根据用户提交的 HTTP 请求指派不同的处理程序。
Spring MVC 核心组件
- DispatcherServlet:前端控制器,是整个流程控制的核心,控制其他组件的执行,进行统一调度,降低组件之间的耦合性。
- Handler:处理器,完成具体的业务逻辑,相当于 Servlet 或 Action。
- HandlerMapping:DispatcherServlet 接收到请求之后,通过 HandlerMapping 将不同的请求映射到不同的 Handler。
- HandlerInterceptor:处理器拦截器,是一个接口,如果需要完成一些拦截处理,可以实现该接口。
- HandlerExecutionChain:处理器执行链,包括两部分内容:Handler 和 HandlerInterceptor(系统会有一个默认的 HandlerInterceptor,如果需要额外设置拦截,可以添加拦截器)。
- HandlerAdapter:处理器适配器。在 Handler 执行业务方法之前,完成数据类型的转换、表单数据的验证、将表单数据封装到 JavaBean 等操作。
- ModelAndView:装载了模型数据和视图信息,作为 Handler 的处理结果,返回给 DispatcherServlet。
- ViewResolver:视图解析器,DispatcheServlet 通过它将逻辑视图解析为物理视图,最终将渲染结果响应给客户端。
执行流程
-
DisptacherServlet 接收用户的 HTTP 请求,根据 HandlerMapping 将请求映射到对应的Handler,再通过 HandlerAdpater 调用 Handler 的方法完成业务逻辑处理。
-
DispatcherServlet 将 Handler 返回的 ModelAndView 对象传给 ViewRosolver 视图解析器,让其将逻辑视图转化为物理视图。
-
DispatcherServlet 将模型数据填充进 ViewResolver 返回的 View 中,最后渲染后的结果返回给客户端。
入门案例
使用 SpringMVC 实现添加产品信息和展示产品信息的简单案例。
- pom.xml 导入相关依赖
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>5.0.2.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-web</artifactId>
<version>5.0.2.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-aop</artifactId>
<version>5.0.2.RELEASE</version>
</dependency>
<dependency>
<groupId>commons-logging</groupId>
<artifactId>commons-logging</artifactId>
<version>1.2</version>
</dependency>
- springmvc.xml spring配置文件
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:context="http://www.springframework.org/schema/context"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">
<!-- 扫描组件 -->
<context:component-scan base-package="com.ored.controller" />
<!-- 视图解析器:将业务方法返回的逻辑视图转换为物理视图 -->
<!-- 举个例子:业务方法返回 input,它会将其转换为 /WEB-INF/jsp/input.jsp -->
<bean id="resolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/jsp/" />
<property name="suffix" value=".jsp" />
</bean>
</beans>
- web.xml 配置前置控制器 DispatcherServlet
<!DOCTYPE web-app PUBLIC
"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd" >
<web-app>
<display-name>Archetype Created Web Application</display-name>
<!-- 过滤器:用来指定请求或响应的编码格式 -->
<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>
<init-param>
<!-- 是否强制response的编码格式也是encoding格式 -->
<param-name>forceEncoding</param-name>
<param-value>true</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>encodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
<!-- 配置前置控制器,它用于拦截并处理所有的请求 -->
<servlet>
<servlet-name>dispatcherServlet</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<!-- 初始化参数:用于指定Spring配置文件的路径 -->
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:springmvc.xml</param-value>
</init-param>
<!-- 默认情况下,servlet是第一次被访问时才会创建对象 -->
<!-- load-on-startup:服务器启动时创建该对象,数值越小,优先级越高 -->
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>dispatcherServlet</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
</web-app>
- 实体类 Product
package com.wind.domain;
import java.math.BigDecimal;
public class Product {
private String name;
private String description;
private BigDecimal price;
// set and get methods not shown.
}
- 视图 index.jsp 用于跳转到表单页面
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<p><a href="/input">添加产品</a></p>
</body>
</html>
- 视图 input.jsp 添加产品信息
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<form action="/save" method="post">
<p>
<label for="name">产品名称:</label>
<input type="text" id="name" name="name" />
</p>
<p>
<label for="description">产品描述</label>
<input type="text" id="description" name="description">
</p>
<p>
<lable for="price">产品价格:</lable>
<input type="text" id="price" name="price" placeholder="格式:##.#" step="any" />
</p>
<p>
<input type="reset" value="重置" />
<input type="submit" value="提交" />
</p>
</form>
</body>
</html>
- 视图 details.jsp 展示产品信息
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%@ page isELIgnored="false" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<h4>详细信息:</h4>
<p>产品名称:${product.name}</p>
<p>产品描述:${product.description}</p>
<p>产品价格:${product.price}</p>
</body>
</html>
- ProductHandler 处理业务
package com.ored.controller;
import com.ored.pojo.Product;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
@Controller
public class ProductHandler {
// value="/input" 表名了该方法用于处理URL路径为/input的用户请求
// method=RequestMethod.GET 指定了 HTTP 请求的方法必须为 GET
@RequestMapping(value = "/input",method = RequestMethod.GET)
public String input(){
return "input";
}
@RequestMapping(value = "/save",method = RequestMethod.POST)
public String save(Product product,Model model){
model.addAttribute("product",product);
return "details";
}
}
参考资料:
① 基于 Spring MVC 的 Web 应用开发
②《Spring MVC从入门到实战》课程笔记