SpringMVC
学习目标
1.Spring MVC是什么?
Spring MVC是Spring家族中的⼀个web成员,它是⼀种基于Java的实现了Web MVC设计思想的请求驱动
类型的轻量级Web框架,即使⽤了MVC架构模式的思想,将web层进⾏职责解耦,基于请求驱动指的就是使⽤请求-响应模型。
框架的⽬的就是帮助我们简化开发,Spring MVC也是要简化我们⽇常Web开发的。
Spring MVC能帮我们做什么?
1. 让我们能⾮常简单的设计出⼲净的Web层;
2. 进⾏更简洁的Web层的开发;
3. 天⽣与Spring框架集成(如IOC容器、AOP等);
4. 提供强⼤的约定⼤于配置的契约式编程⽀持;
5. 能简单的进⾏Web层的单元测试;
6. ⽀持灵活的URL到⻚⾯控制器的映射;
7. ⾮常容易与其他视图技术集成,如jsp、Velocity、FreeMarker等等,因为模型数据不放在特定的
API⾥,⽽是放在⼀个Model⾥(Map数据结构实现,因此很容易被其他框架使⽤);
8. ⾮常灵活的数据验证、格式化和数据绑定机制,能使⽤任何对象进⾏数据绑定,不必实现特定框架的API;
9. ⽀持灵活的本地化等解析;
10. 更加简单的异常处理;
11. 对静态资源的⽀持;
12. ⽀持Restful⻛格。
2.SpringMVC 请求流程
Spring MVC框架也是⼀个基于请求驱动的Web框架,并且使⽤了前端控制器模式(是⽤来提供⼀个集
中的请求处理机制,所有的请求都将由⼀个单⼀的处理程序处理来进⾏设计,再根据请求映射规则分发
给相应的⻚⾯控制器(动作/处理器)进⾏处理。⾸先让我们整体看⼀下Spring MVC处理请求的流程:
1. ⾸先⽤户发送请求,请求被SpringMvc前端控制器(DispatherServlet)捕获;
2. 前端控制器(DispatherServlet)对请求URL解析获取请求URI,根据URI, 调⽤HandlerMapping;
3. 前端控制器(DispatherServlet)获得返回的HandlerExecutionChain(包括Handler对象以及Handler对
象对应的拦截器);
4. DispatcherServlet 根据获得的HandlerExecutionChain,选择⼀个合适的HandlerAdapter。(附注:
如果成功获得HandlerAdapter后,此时将开始执⾏拦截器的preHandler(...)⽅法);
5. HandlerAdapter根据请求的Handler适配并执⾏对应的Handler;HandlerAdapter(提取Request中的
模型数据,填充Handler⼊参,开始执⾏Handler(Controller)。 在填充Handler的⼊参过程中,根据配置,Spring将做⼀些额外的⼯作:
HttpMessageConveter: 将请求消息(如Json、xml等数据)转换成⼀个对象,将对象转换为指定的响应信息。
数据转换:对请求消息进⾏数据转换。如String转换成Integer、Double等数据格式化:
数据格式化。 如将字符串转换成格式化数字或格式化⽇期等
数据验证: 验证数据的有效性(⻓度、格式等),验证结果存储到BindingResult或Error中)
6. Handler执⾏完毕,返回⼀个ModelAndView(即模型和视图)给HandlerAdaptor
7. HandlerAdaptor适配器将执⾏结果ModelAndView返回给前端控制器。
8. 前端控制器接收到ModelAndView后,请求对应的视图解析器。
9. 视图解析器解析ModelAndView后返回对应View;
10. 渲染视图并返回渲染后的视图给前端控制器。
11、最终前端控制器将渲染后的⻚⾯响应给⽤户或客户端
3.Spring MVC 环境搭建
- 开发环境
Idea + Maven + Jdk1.8 + Jetty - 新建 Maven webApp
Idea 下创建 springmvc01 ⼯程 - pom.xml 配置
先删除没有必有的
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<maven.compiler.source>1.8</maven.compiler.source>
<maven.compiler.target>1.8</maven.compiler.target>
</properties>
<dependencies>
<!-- spring web -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-web</artifactId>
<version>5.2.4.RELEASE</version>
</dependency>
<!-- spring mvc -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>5.2.4.RELEASE</version>
</dependency>
<!-- web servlet -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>3.0.1</version>
<scope>provided</scope>
</dependency>
</dependencies>
<build>
<plugins>
<!-- 编译环境插件 -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>2.3.2</version>
<configuration>
<source>1.8</source>
<target>1.8</target>
<encoding>UTF-8</encoding>
</configuration>
</plugin>
<!-- jetty插件 -->
<plugin>
<groupId>org.eclipse.jetty</groupId>
<artifactId>jetty-maven-plugin</artifactId>
<version>9.4.27.v20200227</version>
<configuration>
<scanIntervalSeconds>10</scanIntervalSeconds>
<!-- 设置端⼝ -->
<httpConnector>
<port>8080</port>
</httpConnector>
<!-- 设置项⽬路径 -->
<webAppConfig>
<contextPath>/springmvc01</contextPath>
</webAppConfig>
</configuration>
</plugin>
</plugins>
</build>
- 配置 web.xml
<?xml version="1.0" encoding="UTF-8"?>
<web-app id="WebApp_ID" version="3.0"
xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd">
<!-- 编码过滤 utf-8 -->
<filter>
<description>char encoding filter</description>
<filter-name>encodingFilter</filter-name>
<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filterclass>
<init-param>
<param-name>encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>encodingFilter</filter-name>
<url-pattern> /* </url-pattern>
</filter-mapping>
<!-- servlet请求分发器 -->
<servlet>
<servlet-name>springMvc</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:servlet-context.xml</param-value>
</init-param>
<!-- 表示启动容器时初始化该Servlet -->
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>springMvc</servlet-name>
<!-- 这是拦截请求, "/"代表拦截所有请求,"*.do"拦截所有.do请求 -->
<!-- <url-pattern>/</url-pattern> -->
<url-pattern>*.do</url-pattern>
</servlet-mapping>
</web-app>
要想启动我们的 SpringMVC 环境,⽬前对于 mvc 框架的配置还未进⾏。以上在 web.xml 中引⽤了
servlet-context.xml ⽂件。
- servlet-context.xml 配置
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:mvc="http://www.springframework.org/schema/mvc"
xmlns:context="http://www.springframework.org/schema/context"
xsi:schemaLocation="
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc.xsd
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.xxxx.springmvc.controller"/>
<!-- 使⽤默认的 Servlet 来响应静态⽂件 -->
<mvc:default-servlet-handler/>
<!-- 开启注解驱动-->
<mvc:annotation-driven/>
<!-- 配置视图解析器 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"
id="internalResourceViewResolver">
<!-- 前缀:在WEB-INF⽬录下的jsp⽬录下 -->
<property name="prefix" value="/WEB-INF/jsp/"/>
<!-- 后缀:以.jsp结尾的资源 -->
<property name="suffix" value=".jsp"/>
</bean>
</beans>
- ⻚⾯控制器的编写
- 添加视图⻚⾯
在 WEB-INF 下新建 jsp ⽂件夹 ,并在⽂件夹下新建 hello.jsp
- 启动 jetty 服务器
运行:
路径:http://localhost:8080/springmvc01/hello.do
如果这样写
这样就可以运行成功:
4. URL 地址映射配置
@RequestMapping
通过注解 @RequestMapping 将请求地址与⽅法进⾏绑定,可以在类级别和⽅法级别声明。
类级别的注解负责将⼀个特定的请求路径映射到⼀个控制器上,将 url 和类绑定;
通过⽅法级别的注解可以细化映射,能够将⼀个特定的请求路径映射到某个具体的⽅法上,将 url 和类的⽅法绑定。
映射单个 URL
@RequestMapping(“”) 或 @RequestMapping(value=“”)
/**
* @RequestMapping 声明在⽅法上⾯,映射单个 URL
* 访问地址:(如果有类路径需要写在⽅法路径前⾯)
* http://ip:port/springmvc01/test01
* @return
*/
@RequestMapping("/test01")
// @RequestMapping(value = "/test01")
public ModelAndView test01(){
ModelAndView modelAndView = new ModelAndView();
modelAndView.addObject("hello","test01");
modelAndView.setViewName("hello");
return modelAndView;
}
/**
* 路径开头是否加 斜杠"/" 均可
* @RequestMapping("/请求路径") 与 @RequestMapping("请求路径")均可
* 建议加上,如:@RequestMapping("/test02")
* 访问地址:(如果有类路径需要写在⽅法路径前⾯)
* http://ip:port/springmvc01/test02
* @return
*/
@RequestMapping("test02")
public ModelAndView test02(){
ModelAndView modelAndView = new ModelAndView();
modelAndView.addObject("hello","test02");
modelAndView.setViewName("hello");
return modelAndView;
}
映射多个 URL
@RequestMapping({“”,“”}) 或 @RequestMapping(value={“”,“”})
/**
* @RequestMapping 声明在⽅法上⾯,映射多个 URL
* ⽀持⼀个⽅法绑定多个 url 的操作
* 访问地址:(如果有类路径需要写在⽅法路径前⾯)
* http://ip:port/springmvc01/test03_01
* http://ip:port/springmvc01/test03_02
* @return
*/
@RequestMapping({"/test03_01","/test03_02"})
// @RequestMapping(value = {"/test03_01","/test03_02"})
public ModelAndView test03(){
ModelAndView modelAndView = new ModelAndView();
modelAndView.addObject("hello","test03");
modelAndView.setViewName("hello");
return modelAndView;
}
映射 URL 在控制器上
⽤于类上,表示类中的所有响应请求的⽅法都是以该地址作为⽗路径。
@Controller
@RequestMapping("/url")
public class UrlController {
/**
* @RequestMapping 声明在类上⾯,类中的的⽅法都是以该地址作为⽗路径
* 声明级别:
* 类级别 + ⽅法级别 (/类路径/⽅法路径)
* 访问地址:
* http://ip:port/springmvc01/url/test04
* @return
*/
@RequestMapping("/test04")
public ModelAndView test04(){
ModelAndView modelAndView = new ModelAndView();
modelAndView.addObject("hello","test04");
modelAndView.setViewName("hello");
return modelAndView;
}
}
通过参数名称映射 URL
/**
* 通过参数名称访问
* 通过参数的形式访问
* 访问地址:
* http://ip:port/springmvc01/url?test06
* @return
*/
@RequestMapping(params = "test06")
public ModelAndView test06(){
ModelAndView modelAndView = new ModelAndView();
modelAndView.addObject("hello","test06");
modelAndView.setViewName("hello");
return modelAndView;
}
5.参数绑定
客户端请求的参数到控制器功能处理⽅法上的参数的绑定,对于参数绑定⾮常灵活。
基本数据类型
/**
* 基本类型数据绑定
* 参数值必须存在。如果没有指定参数值,也没有设置参数默认值,则会报500异常。
* @param age
* @param money
*/
@RequestMapping("data01")
public void data01(int age, double money){
System.out.println("age:" + age + ", money:" + money);
}
/**
* 基本类型数据绑定
* 通过注解 @RequestParam 标记⼀个形参为请求参数。(注解声明在形参的前⾯)
* 可以通过注解的属性设置相关内容
* 设置参数的默认值 defaultValue
* @param age
* @param money
*/
@RequestMapping("data02")
public void data02(@RequestParam(defaultValue = "18") int age,
@RequestParam(defaultValue = "10.0") double money){
System.out.println("age:" + age + ", money:" + money);
}
/**
* 基本类型数据绑定
* 通过注解 @RequestParam 标记⼀个形参为请求参数。(注解声明在形参的前⾯)
* 可以通过注解的属性设置相关内容
* 设置参数的参数名(别名) name
* @param age
* @param money
*/
@RequestMapping("data03")
public void data03(@RequestParam(defaultValue = "18", name = "userAge") int age,
@RequestParam(defaultValue = "10.0", name = "userMoney") double money){
System.out.println("age:" + age + ", money:" + money);
}
包装类型
/**
* 包装类型数据绑定 (如果数据是基本类型,建议使⽤包装类型)
* 客户端请求参数名与⽅法形参名保持⼀致,默认参数值为null
* 可以通过 @RequestParam 的name属性设置参数的别名,defaultValue属性设置参数默认值
* @param age
* @param money
*/
@RequestMapping("data05")
public void data05(Integer age, Double money){
System.out.println("age:" + age + ", money:" + money);
}
字符串类型
/**
* 字符串数据绑定
* 客户端请求参数名与⽅法形参名保持⼀致,默认参数值为null
* 可以通过 @RequestParam 的name属性设置参数的别名,defaultValue属性设置参数默认值
* @param userName
* @param userPwd
*/
@RequestMapping("data04")
public void data04(String userName, String userPwd){
System.out.println("userName:" + userName + ", userPwd:" + userPwd);
}
数组类型
/**
* 数组类型数据绑定
* 客户端传参形式:ids=1&ids=2&ids=3
* @param ids
*/
@RequestMapping("/data06")
public void data06(String[] ids){
for(String id : ids){
System.out.println(id + "---");
}
}
JavaBean 类型
/**
* JavaBean 数据绑定
* 客户端请求的参数名与JavaBean对象的属性字段名保持⼀致
* @param user
*/
@RequestMapping("/data07")
public void data07(User user) {
System.out.println(user);
}
User.java
package com.xxxx.springmvc.po;
public class User {
private int id;
private String userName;
private String userPwd;
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getUserName() {
return userName;
}
public void setUserName(String userName) {
this.userName = userName;
}
public String getUserPwd() {
return userPwd;
}
public void setUserPwd(String userPwd) {
this.userPwd = userPwd;
}
@Override
public String toString() {
return "User [id=" + id + ", userName=" + userName + ", userPwd="
+ userPwd + "]";
}
}
6.JSON 数据开发
Json 在企业开发中已经作为通⽤的接⼝参数类型,在⻚⾯(客户端)解析很⽅便。
SpringMVC 对于json 提供了良好的⽀持,这⾥需要修改相关配置,添加 json 数据⽀持功能
@ResponseBody
该注解⽤于将 Controller 的⽅法返回的对象,通过适当的 HttpMessageConverter 转换为指定格式后,写⼊到 Response 对象的 body 数据区。
返回的数据不是 html 标签的⻚⾯,⽽是其他某种格式的数据时(如 json、xml 等)使⽤(通常⽤于ajax 请求)。
@RequestBody
该注解⽤于读取 Request 请求的 body 部分数据,使⽤系统默认配置的 HttpMessageConverter 进⾏解
析,然后把相应的数据绑定到要返回的对象上 ,再把 HttpMessageConverter 返回的对象数据绑定到controller 中⽅法的参数上。
使⽤配置
添加 json相关坐标:pom.xml
<!-- 添加json 依赖jar包 -->
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-core</artifactId>
<version>2.10.0</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.10.0</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-annotations</artifactId>
<version>2.10.0</version>
</dependency>
修改配置⽂件:servlet-context.xml
<!-- mvc 请求映射 处理器与适配器配置 -->
<mvc:annotation-driven>
<mvc:message-converters>
<bean class="org.springframework.http.converter.StringHttpMessageConverter" />
<bean
class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter" />
</mvc:message-converters>
</mvc:annotation-driven>
注解使⽤
@ResponseBody
启动访问:
@RequestBody
- @RequestBody接受的是⼀个 json 格式的字符串,⼀定是⼀个字符串