SpringMVC 概述
基于mvc的轻量级框架
入门案例
入门案例制作
导入SpringMVC相关坐标
1 | <!-- servlet3.1规范的坐标 --> |
创建spring-mvc.xml
1 |
|
web.xml中配置SpringMVC核心控制器
用于将请求转发到对应的具体业务处理器Controller中(等同于Servlet配置)
1 | <servlet> |
设定具体Controller的访问路径
1 |
|
设置返回页面
在webapp根目录新建success.jsp页面
访问测试地址
入门案例工作流程分析
- 服务器启动
- 加载web.xml中DispatcherServlet
- 读取spring-mvc.xml中的配置,加载所有com.itheima包中所有标记为bean的类
- 读取bean中方法上方标注@RequestMapping的内容
- 处理请求
- DispatcherServlet配置拦截所有请求 /
- 使用请求路径与所有加载的@RequestMapping的内容进行比对
- 执行对应的方法
- 根据方法的返回值在webapp目录中查找对应的页面并展示
SpringMVC 技术架构图
- DispatcherServlet:前端控制器, 是整体流程控制的中心,由其调用其它组件处理用户的请求, 有
效的降低了组件间的耦合性 - HandlerMapping:处理器映射器, 负责根据用户请求找到对应具体的Handler处理器
- Handler:处理器,业务处理的核心类,通常由开发者编写,描述具体的业务
- HandlAdapter:处理器适配器,通过它对处理器进行执行
- View Resolver:视图解析器, 将处理结果生成View视图
- View:视图,最终产出结果, 常用视图如jsp、 html
基本配置
常规配置(性能优化)
只扫描含有@Controller注解的类,提升性能。也可以写成<context:component-scan base-package="com.itheima.controller">
,更推荐下面的写法。因为有可能按照模块分包,比如cn.itcast.user.controller,cn.itcast.dept.controller
1 | <context:component-scan base-package="com.itheima"> |
静态资源加载
1 | <!--方式一:不推荐。放行指定类型静态资源配置方式--> |
中文乱码处理
SpringMVC提供专用的中文字符过滤器,用于处理乱码问题
配置在 web.xml 里面
1 | <!--乱码处理过滤器,与Servlet中使用的完全相同,差异之处在于处理器的类由Spring提供--> |
全注解配置SpringMVC
- 使用注解形式转化SpringMVC核心配置文件为配置类
1 |
|
- 基于servlet3.0规范,自定义Servlet容器初始化配置类,加载SpringMVC核心配置类
1 | public class ServletContainersInitConfig extends AbstractDispatcherServletInitializer { |
删除web.xml
删除spring-mvc.xml
小节
基于servlet3.0规范,配置Servlet容器初始化配置类,初始化时加载SpringMVC配置类
转化SpringMVC核心配置文件
转化为注解(例如: spring处理器加载过滤)
转化为bean进行加载
按照标准接口进行开发并加载(例如:中文乱码处理、静态资源加载过滤)
获取请求数据
普通类型参数传参
Controller中的业务方法的参数名称要与请求参数的name一致,参数值会自动映射匹配。并且能自动做类型转换;
POJO类型参数传参
Controller中的业务方法的POJO参数的属性名与请求参数的name一致,参数值会自动映射匹配。
复杂POJO类型参数
当POJO中出现对象属性时,参数名称与对象层次结构名称保持一致
访问URL: http://localhost/requestParam5?address.province=beijing
1 | public class User { |
1 | "/requestParam5") ( |
当POJO中出现List,保存对象数据,参数名称与对象层次结构名称保持一致,使用数组格式描述集合中对象的位置
访问URL: http://localhost/requestParam7?addresses[0].province=bj&addresses[1].province=tj
1 | public class User { |
1 | "/requestParam7") ( |
当POJO中出现Map,保存对象数据,参数名称与对象层次结构名称保持一致,使用映射格式描述集合中对象的位置
访问URL: http://localhost/requestParam8?addressMap[’home’].province=bj&addressMap[’job’].province=tj
1 | public class User { |
1 | "/requestParam8") ( |
数组与集合类型参数传参
数组类型参数
Controller中的业务方法数组名称与请求参数的name一致,参数值会自动映射匹配。
集合类型参数
方式1:
保存简单类型数据,请求参数名与处理器方法形参名保持一致,且请求参数数量> 1个
访问URL: http://localhost/requestParam10?nick=Jockme&nick=zahc
1 | "/requestParam10") ( |
注意: SpringMVC默认将List作为对象处理,赋值前先创建对象,然后将nick作为对象的属性进行处理。由于
List是接口,无法创建对象,报无法找到构造方法异常;修复类型为可创建对象的ArrayList类型后,对象可
以创建,但没有nick属性,因此数据为空。此时需要告知SpringMVC的处理器nick是一组数据,而不是一个单
一数据。通过@RequestParam注解,将数量大于1个names参数打包成参数数组后, SpringMVC才能识别该数
据格式,并判定形参类型是否为数组或集合,并按数组或集合对象的形式操作数据。
方式2 一般不用
获得集合参数时,将集合参数包装到一个POJO中
方式3
当使用ajax提交时,可以指定contentType为json形式,那么在方法参数位置使用@RequestBody可以直接接收集合数据而无需使用POJO进行包装
jquery在线地址:https://cdn.bootcss.com/jquery/3.4.1/jquery.min.js
JSON.stringfy()功能是吧任意对象变成JSON格式的字符串
contentType表示浏览器告诉服务器发送给服务器的是utf-8编码的JSON格式的数据
@RequestParam
当请求的参数名称与Controller的业务方法参数名称不一致时,就需要通过@RequestParam注解显示的绑定,除此以为还可以为表单参数设置默认值,比如分页
类型转换器
SpringMVC对接收的数据进行自动类型转换,该工作通过Converter接口实现
标量转换器
StringToBooleanConverter String→Boolean
ObjectToStringConverter Object→String
StringToNumberConverterFactory String→Number( Integer、 Long等)
NumberToNumberConverterFactory Number子类型之间(Integer、 Long、 Double等)
StringToCharacterConverter String→java.lang.Character
NumberToCharacterConverter Number子类型(Integer、 Long、 Double等)→java.lang.Character
CharacterToNumberFactory java.lang.Character→Number子类型(Integer、 Long、 Double等)
StringToEnumConverterFactory String→enum类型
EnumToStringConverter enum类型→String
StringToLocaleConverter String→java.util.Local
PropertiesToStringConverter java.util.Properties→String
StringToPropertiesConverter String→java.util.Properties集合、数组相关转换器
ArrayToCollectionConverter 数组→集合( List、 Set)
CollectionToArrayConverter 集合( List、 Set) →数组
ArrayToArrayConverter 数组间
CollectionToCollectionConverter 集合间( List、 Set)
MapToMapConverter Map间
ArrayToStringConverter 数组→String类型
StringToArrayConverter String→数组, trim后使用“,”split
ArrayToObjectConverter 数组→Object
ObjectToArrayConverter Object→单元素数组
CollectionToStringConverter 集合( List、 Set) →String
StringToCollectionConverter String→集合( List、 Set), trim后使用“,”split
CollectionToObjectConverter 集合→Object
ObjectToCollectionConverter Object→单元素集合默认转换器
ObjectToObjectConverter Object间
IdToEntityConverter Id→Entity
FallbackObjectToStringConverter Object→StringSpringMVC对接收的数据进行自动类型转换,该工作通过Converter接口实现
日期类型格式转换
声明自定义的转换格式并覆盖系统转换格式
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17<!--5.启用自定义Converter-->
<mvc:annotation-driven conversion-service="conversionService"/>
<!--1.设定格式类型Converter,注册为Bean,受SpringMVC管理-->
<bean id="conversionService"
class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
<!--2.自定义Converter格式类型设定,该设定使用的是同类型覆盖的思想-->
<property name="formatters">
<!--3.使用set保障相同类型的转换器仅保留一个,避免冲突-->
<set>
<!--4.设置具体的格式类型-->
<bean class="org.springframework.format.datetime.DateFormatter">
<!--5.类型规则-->
<property name="pattern" value="yyyy-MM-dd"/>
</bean>
</set>
</property>
</bean>日期类型格式转换(简化版)
名称: @DateTimeFormat
类型: 形参注解、成员变量注解
位置:形参前面 或 成员变量上方
作用:为当前参数或变量指定类型转换规则
范例:1
2
3
4public String requestParam12(@DateTimeFormat(pattern = "yyyy-MM-dd") Date date){
System.out.println("date="+date);
return "page.jsp";
}1
2"yyyy-MM-dd") (pattern =
private Date birthday;注意:依赖注解驱动支持 ,这句话永远放在配置文件最上面!!!
<mvc:annotation-driven />
自定义类型转换器
自定义类型转换器,实现Converter接口,并制定转换前与转换后的类型
1
2
3
4
5
6
7
8
9
10
11
12
13
14<!--1.将自定义Converter注册为Bean,受SpringMVC管理-->
<bean id="myDateConverter" class="com.itheima.converter.MyDateConverter"/>
<!--2.设定自定义Converter服务bean-->
<bean id="conversionService"
class="org.springframework.context.support.ConversionServiceFactoryBean">
<!--3.注入所有的自定义Converter,该设定使用的是同类型覆盖的思想-->
<property name="converters">
<!--4.set保障同类型转换器仅保留一个,去重规则以Converter<S,T>的泛型为准-->
<set>
<!--5.具体的类型转换器-->
<ref bean="myDateConverter"/>
</set>
</property>
</bean>1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16//自定义类型转换器,实现Converter接口,接口中指定的泛型即为最终作用的条件
//本例中的泛型填写的是String,Date,最终出现字符串转日期时,该类型转换器生效
public class MyDateConverter implements Converter<String, Date> {
//重写接口的抽象方法,参数由泛型决定
public Date convert(String source) {
DateFormat df = new SimpleDateFormat("yyyy-MM-dd");
Date date = null;
//类型转换器无法预计使用过程中出现的异常,因此必须在类型转换器内部捕获,不允许抛出,框架无法预计此类异常如何处理
try {
date = df.parse(source);
} catch (ParseException e) {
e.printStackTrace();
}
return date;
}
}
通过注册自定义转换器,将该功能加入到SpringMVC的转换服务ConverterService中
1
2<!--开启注解驱动,加载自定义格式化转换器对应的类型转换服务-->
<mvc:annotation-driven conversion-service="conversionService"/>注意事项:
<mvc:annotation-driven>
标签要放在spring-mvc配置文件的最前面
响应
页面跳转
返回字符串形式
- 转发(默认)
1 | "/showPage1") ( |
- 重定向
1 | "/showPage2") ( |
将相同的路径抽取到配置文件中:
展示页面的保存位置通常固定,且结构相似,可以设定通用的访问路径,简化页面配置格式
1 | <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> |
1 | public String showPage3() { |
原理图
如果未设定了返回值,使用void类型,则默认使用访问路径作页面地址的前缀后缀
1 | //最简页面配置方式,使用访问路径作为页面名称,省略返回值 |
返回ModelAndView
方式一:使用HttpServletRequest类型形参进行数据传递
1
2
3
4
5"/showPageAndData1") (
public String showPageAndData1(HttpServletRequest request) {
request.setAttribute("name","itheima");
return "page";
}
方式二:使用Model类型形参进行数据传递
1
2
3
4
5
6
7
8
9"/showPageAndData2") (
public String showPageAndData2(Model model) {
model.addAttribute("name","itheima");
Book book = new Book();
book.setName("SpringMVC入门实战");
book.setPrice(66.6d);
model.addAttribute("book",book);
return "page";
}
方式三:使用ModelAndView类型形参进行数据传递,将该对象作为返回值传递给调用者
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16//使用ModelAndView形参传递参数,该对象还封装了页面信息
"/showPageAndData3") (
public ModelAndView showPageAndData3(ModelAndView modelAndView) {
//ModelAndView mav = new ModelAndView(); 替换形参中的参数
Book book = new Book();
book.setName("SpringMVC入门案例");
book.setPrice(66.66d);
//添加数据的方式,key对value
modelAndView.addObject("book",book);
//添加数据的方式,key对value
modelAndView.addObject("name","Jockme");
//设置页面的方式,该方法最后一次执行的结果生效
modelAndView.setViewName("page");
//返回值设定成ModelAndView对象
return modelAndView;
}
返回json数据
方式一:基于response返回数据的简化格式,返回JSON数据
1
2
3
4
5
6
7
8
9
10
11//使用jackson进行json数据格式转化
"/showData3") (
public String showData3() throws JsonProcessingException {
Book book = new Book();
book.setName("SpringMVC入门案例");
book.setPrice(66.66d);
ObjectMapper om = new ObjectMapper();
return om.writeValueAsString(book);
}使用SpringMVC提供的消息类型转换器将对象与集合数据自动转换为JSON数据
1
2
3
4
5
6
7
8
9//使用SpringMVC注解驱动,对标注@ResponseBody注解的控制器方法进行结果转换,由于返回值为引用类型,自动调用jackson提供的类型转换器进行格式转换
"/showData4") (
public Book showData4() {
Book book = new Book();
book.setName("SpringMVC入门案例");
book.setPrice(66.66d);
return book;
}需要手工添加信息类型转换器
1
2
3
4
5
6
7<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
<property name="messageConverters">
<list>
<bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter"/>
</list>
</property>
</bean方式三:使用SpringMVC注解驱动简化配置
1
2<!--开启springmvc注解驱动,对@ResponseBody的注解进行格式增强,追加其类型转换的功能,具体实现由MappingJackson2HttpMessageConverter进行-->
<mvc:annotation-driven/>注意:该标签写在配置文件最上面,扫完包马上写该注解
Servlet相关接口-Servlet相关接口替换方案
HttpServletRequest / HttpServletResponse / HttpSession
SpringMVC提供访问原始Servlet接口API的功能,通过形参声明即可
1
2
3
4
5
6
7
8
9
10"/servletApi") (
public String servletApi(HttpServletRequest request,
HttpServletResponse response, HttpSession session){
System.out.println(request);
System.out.println(response);
System.out.println(session);
request.setAttribute("name","itheima");
System.out.println(request.getAttribute("name"));
return "page.jsp";
}Head数据获取
名称: @RequestHeader
类型: 形参注解
位置:处理器类中的方法形参前方
作用:绑定请求头数据与对应处理方法形参间的关系
范例:1
2
3
4
5"/headApi") (
public String headApi(@RequestHeader("Accept-Language") String head){
System.out.println(head);
return "page.jsp";
}Cookie数据获取
名称: @CookieValue
类型: 形参注解
位置:处理器类中的方法形参前方
作用:绑定请求Cookie数据与对应处理方法形参间的关系
范例:1
2
3
4
5"/cookieApi") (
public String cookieApi(@CookieValue("JSESSIONID") String jsessionid){
System.out.println(jsessionid);
return "page.jsp";
}Session数据获取
名称: @SessionAttribute
类型: 形参注解
位置:处理器类中的方法形参前方
作用:绑定请求Session数据与对应处理方法形参间的关系
范例:1
2
3
4
5"/sessionApi") (
public String sessionApi(@SessionAttribute("name") String name){
System.out.println(name);
return "page.jsp";
}Session数据设置(了解)
名称: @SessionAttributes
类型: 类注解
位置:处理器类上方
作用:声明放入session范围的变量名称,适用于Model类型数据传参
范例:1
2
3
4
5
6
7
8
9
"name"}) (names={
public class ServletController {
"/setSessionData2") (
public String setSessionDate2(Model model) {
model.addAttribute("name", "Jock2");
return "page.jsp";
}
}注解式参数数据封装底层原理
数据的来源不同,对应的处理策略要进行区分
Head
Cookie
Session
SpringMVC使用策略模式进行处理分发
顶层接口: HandlerMethodArgumentResolver
实现类: ……
面试题
MVC是什么
MVC全名是Model View Controller,是一种软件设计模式。其中可分为模型(model)-视图(view)-控制器(controller)三要素