1. Spring集成web环境

1.1 ApplicationContext应用上下文获取方式

应用上下文对象是通过new ClasspathXmlApplicationContext(spring配置文件) 方式获取的
但是每次从容器中获得Bean时都要编写new ClasspathXmlApplicationContext(spring配置文件)
这样的弊端是配置文件加载多次,应用上下文对象创建多次。

在Web项目中,可以使用ServletContextListener监听Web应用的启动,我们可以在Web应用启动时,
就加载Spring的配置文件,创建应用上下文对象ApplicationContext,在将其存储到最大的域servletContext域 中,
这样就可以在任意位置从域中获得应用上下文ApplicationContext对象了。

1.2 Spring提供获取应用上下文的工具

上面的分析不用手动实现,Spring提供了一个监听器ContextLoaderListener就是对上述功能的封装
该监听器内部加载Spring配置文件,创建应用上下文对象,并存储到ServletContext域中
提供了一个客户端工 具WebApplicationContextUtils供使用者获得应用上下文对象

所以我们需要做的只有两件事:

  1. 在web.xml中配置ContextLoaderListener监听器(导入spring-web坐标)
  2. 使用WebApplicationContextUtils获得应用上下文对象ApplicationContext

1.3 导入Spring集成web的坐标

1
2
3
4
5
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-web</artifactId>
<version>5.0.5.RELEASE</version>
</dependency>

1.4 配置ContextLoaderListener监听器

1
2
3
4
5
6
7
8
9
10
11
<!--全局参数-->
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:applicationContext.xml</param-value>
</context-param>
<!--Spring的监听器-->
<listener>
<listener-class>
org.springframework.web.context.ContextLoaderListener
</listener-class>
</listener>

1.5 通过工具获得应用上下文对象

1
ApplicationContext applicationContext =  WebApplicationContextUtils.getWebApplicationContext(servletContext); Object obj = applicationContext.getBean("id");

2. SpringMVC 简介

2.1 SpringMVC概述

SpringMVC 是一种基于 Java 的实现 MVC 设计模型的请求驱动类型的轻量级 Web 框架,属于 SpringFrameWork 的后续产品,已经融合在 Spring Web Flow 中

SpringMVC 已经成为目前最主流的MVC框架之一,并且随着Spring3.0 的发布,全面超越 Struts2,成为最优秀的 MVC 框架。
它通过一套注解,让一个简单的 Java 类成为处理请求的控制器,而无须实现任何接口。同时 它还支持 RESTful 编程风格的请求。

2.2 SpringMVC快速入门

需求:客户端发起请求,服务器端接收请求,执行逻辑并进行视图跳转。

SpringMVC入门步骤

1. 导入坐标

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
<!--Spring坐标-->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>5.0.5.RELEASE</version>
</dependency>
<!--SpringMVC坐标-->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>5.0.5.RELEASE</version>
</dependency>
<!--Servlet坐标-->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>servlet-api</artifactId>
<version>2.5</version>
</dependency>
<!--Jsp坐标-->
<dependency>
<groupId>javax.servlet.jsp</groupId>
<artifactId>jsp-api</artifactId>
<version>2.0</version>
</dependency>

2. 在web.xml配置SpringMVC的核心控制器

1
2
3
4
5
6
7
8
9
10
11
12
13
<!--配置SpringMVC的前端控制器-->
<servlet>
<servlet-name>DispatcherServlet</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:spring-mvc.xml</param-value>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>DispatcherServlet</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>

3. 创建Controller和业务方法

1
2
3
4
5
6
7
public class UserController {

public String save(){
System.out.println("Controller save running......");
return "success.jsp";
}
}
1
2
3
4
5
6
7
8
9
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<h1>Ciallo</h1>
</body>
</html>

4. 配置注解

1
2
3
4
5
6
7
8
9
@Controller
public class UserController {

@RequestMapping("/quick")
public String save(){
System.out.println("Controller save running......");
return "success.jsp";
}
}

5. 创建spring-mvc.xml

1
2
3
4
5
6
7
8
9
10
11
12
13
 <beans xmlns="http://www.springframework.org/schema/beans"
xmlns:mvc="http://www.springframework.org/schema/mvc"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context.xsd">
<!--配置注解扫描-->
<context:component-scan base-package="cn.jyw"/>
</beans>

Spring MVC流程视图

2.3 知识要点

SpringMVC的开发步骤

  1. 导入SpringMVC相关坐标
  2. 配置SpringMVC核心控制器DispathcerServlet
  3. 创建Controller类和视图页面
  4. 使用注解配置Controller类中业务方法的映射地址
  5. 配置SpringMVC核心文件 spring-mvc.xml
  6. 客户端发起请求测试

3. 组件解析MVC

3.1 SpringMVC的执行流程

SpringMVC的执行流程

① 用户发送请求至前端控制器DispatcherServlet

② DispatcherServlet收到请求调用HandlerMapping处理器映射器

③ 处理器映射器找到具体的处理器(可以根据xml配置、注解进行查找),生成处理器对象及处理器拦截器(如果 有则生成)一并返回给DispatcherServlet

④ DispatcherServlet调用HandlerAdapter处理器适配器

⑤ HandlerAdapter经过适配调用具体的处理器(Controller,也叫后端控制器)

⑥ Controller执行完成返回ModelAndView

⑦ HandlerAdapter将controller执行结果ModelAndView返回给DispatcherServlet

⑧ DispatcherServlet将ModelAndView传给ViewReslover视图解析器

⑨ ViewReslover解析后返回具体View

⑩ DispatcherServlet根据View进行渲染视图(即将模型数据填充至视图中)。DispatcherServlet响应用户。

把整个流程分成三个阶段

  • 准备阶段
  • 匹配阶段
  • 执行阶段

准备阶段

  1. 在 Web 容器第一次用到 DispatcherServlet 的时候,会创建其对象并执行 init 方法
  2. init 方法内会创建 Spring Web 容器,并调用容器 refresh 方法
  3. refresh 过程中会创建并初始化 SpringMVC 中的重要组件, 例如 MultipartResolver,HandlerMapping,HandlerAdapter,HandlerExceptionResolver、ViewResolver 等
  4. 容器初始化后,会将上一步初始化好的重要组件,赋值给 DispatcherServlet 的成员变量,留待后用

SpringMVC 准备阶段

匹配阶段

  1. 用户发送的请求统一到达前端控制器 DispatcherServlet

  2. DispatcherServlet 遍历所有 HandlerMapping ,找到与路径匹配的处理器

    ① HandlerMapping 有多个,每个 HandlerMapping 会返回不同的处理器对象,谁先匹配,返回谁的处理器。其中能识别 @RequestMapping 的优先级最高

    ② 对应 @RequestMapping 的处理器是 HandlerMethod,它包含了控制器对象和控制器方法信息

    ③ 其中路径与处理器的映射关系在 HandlerMapping 初始化时就会建立好

    SpringMVC 匹配阶段 匹配路径

  3. 将 HandlerMethod 连同匹配到的拦截器,生成调用链对象 HandlerExecutionChain 返回

  4. 遍历HandlerAdapter 处理器适配器,找到能处理 HandlerMethod 的适配器对象,开始调用

    SpringMVC 匹配阶段 处理适配器

调用阶段

  1. 执行拦截器 preHandle

    Spring MVC 执行拦截器preHandle

  2. 由 HandlerAdapter 调用 HandlerMethod

    ① 调用前处理不同类型的参数

    ② 调用后处理不同类型的返回值

    SpringMVC 调用阶段 调用HandlerMethod

  3. 第 2 步没有异常

    ① 返回 ModelAndView

    ② 执行拦截器 postHandle 方法

    ③ 解析视图,得到 View 对象,进行视图渲染

    SpringMVC 调用阶段 返回视图

  4. 第 2 步有异常,进入 HandlerExceptionResolver 异常处理流程

    SpringMVC 调用阶段 异常处理

  5. 最后都会执行拦截器的 afterCompletion 方法

  6. 如果控制器方法标注了 @ResponseBody 注解,则在第 2 步,就会生成 json 结果,并标记 ModelAndView 已处理,这样就不会执行第 3 步的视图渲染

3.2 SpringMVC组件解析

  1. 前端控制器:DispatcherServlet

    用户请求到达前端控制器,它就相当于 MVC 模式中的 C
    DispatcherServlet 是整个流程控制的中心,由它调用其它组件处理用户的请求
    DispatcherServlet 的存在降低了组件之间的耦合性

  2. 处理器映射器:HandlerMapping

    HandlerMapping 负责根据用户请求找到 Handler 即处理器
    SpringMVC 提供了不同的映射器实现不同的映射方式
    例如:配置文件方式,实现接口方式,注解方式等

  3. 处理器适配器:HandlerAdapter

    通过 HandlerAdapter 对处理器进行执行,这是适配器模式的应用,通过扩展适配器可以对更多类型的处理器进行执行

  4. 处理器:Handler

    它就是我们开发中要编写的具体业务控制器
    由 DispatcherServlet 把用户请求转发到 Handler
    由 Handler 对具体的用户请求进行处理

  5. 视图解析器:View Resolver

    View Resolver 负责将处理结果生成 View 视图
    View Resolver 首先根据逻辑视图名解析成物理视图名,即具体的页面地址
    再生成 View 视图对象
    最后对 View 进行渲染将处理结果通过页面展示给用户

  6. 视图:View

    SpringMVC 框架提供了很多的 View 视图类型的支持
    包括:jstlView、freemarkerView、pdfView等,最常用的视图就是 jsp
    一般情况下需要通过页面标签或页面模版技术将模型数据通过页面展示给用户,需要由程序员根据业务需求开发具体的页面

3.3 SpringMVC注解解析

@RequestMapping

作用:用于建立请求 URL 和处理请求方法之间的对应关系

位置:

  • 类上,请求URL 的第一级访问目录
    此处不写的话,就相当于应用的根目录
  • 方法上,请求 URL 的第二级访问目录,与类上的使用@ReqquestMapping标注的一级目录一起组成访问虚拟路径

属性:

  • value:用于指定请求的URL
    它和path属性的作用是一样的

  • method:用于指定请求的方式

    例如:method = RequestMethod.POST

  • params:用于指定限制请求参数的条件
    它支持简单的表达式
    要求请求参数的key和value必须和配置的一模一样

    例如:

    • params = {“accountName”},表示请求参数必须有accountName
    • params = {“moeny!100”},表示请求参数中money不能是100

1. mvc命名空间引入

1
2
3
4
5
6
7
8
<!--命名空间:-->
xmlns:context="http://www.springframework.org/schema/context"
xmlns:mvc="http://www.springframework.org/schema/mvc"
<!--约束地址:-->
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context.xsd
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc.xsd

2. 组件扫描

SpringMVC基于Spring容器,所以在进行SpringMVC操作时,需要将Controller存储到Spring容器中
如果使用@Controller注解标注的话,就需要使用<context:component-scan base-package=“cn.jyw.controller"/>进行组件扫描

3.4 SpringMVC的XML配置解析

1. 视图解析器

SpringMVC有默认组件配置,默认组件都是DispatcherServlet.properties配置文件中配置的
该配置文件地址 org/springframework/web/servlet/DispatcherServlet.properties
该文件中配置了默认的视图解析器,如下:

1
org.springframework.web.servlet.ViewResolver=org.springframework.web.servlet.view.InternalResourceViewResolver

翻看该解析器源码,可以看到该解析器的默认设置,如下:

1
2
3
4
REDIRECT_URL_PREFIX = "redirect:" //重定向前缀
FORWARD_URL_PREFIX = "forward:" //转发前缀(默认值)
prefix = ""; //视图名称前缀
suffix = "";//视图名称后缀

我们可以通过属性注入的方式修改视图的的前后缀

1
2
3
4
5
<!--配置内部资源视图解析器-->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/views/"/>
<property name="suffix" value=".jsp"/>
</bean>

4. SpringMVC的数据响应

4.1 SpringMVC的数据响应方式

  1. 页面跳转
  • 直接返回字符串
  • 通过ModeAndView对象返回
  1. 回写数据
  • 直接返回字符串
  • 返回对象或集合

4.2 页面跳转

直接返回字符串:此种方式会将返回的字符串与视图解析器的前后缀拼接后跳转

1
2
3
4
@RequestMapping("/quick")
public String quickMethod(){
return "index";
}
1
2
3
4
5
<!--配置内部资源视图解析器-->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/views/"/>
<property name="suffix" value=".jsp"/>
</bean>

转发资源地址:/WEB-INF/views/index.jsp

返回带有前缀的字符串:

  • 转发:forward:/WEB-INF/views/index.jsp
  • 重定向:redirect:/index.jsp
1
2
3
4
5
6
7
8
9
10
11
12
@RequestMapping("/quick2")
public ModelAndView quickMethod2(){
ModelAndView modelAndView = new ModelAndView();
modelAndView.setViewName("redirect:/WEB-INF/views/index.jsp");
return modelAndView;
}
@RequestMapping("/quick3")
public ModelAndView quickMethod3(){
ModelAndView modelAndView = new ModelAndView();
modelAndView.setViewName("index.jsp");
return modelAndView;
}

在进行转发时,往往要向request域中存储数据,在jsp页面中显示
那么Controller中怎样向request 域中存储数据呢?

  1. 通过SpringMVC框架注入的request对象setAttribute()方法设置 (不常用)
1
2
3
4
5
@RequestMapping("/quick")
public String quickMethod(HttpServletRequest request){
request.setAttribute("name","zhangsan");
return "index";
}
  1. 通过ModelAndView的addObject()方法设置
1
2
3
4
5
6
7
@RequestMapping("/quick3")
public ModelAndView quickMethod3(){
ModelAndView modelAndView = new ModelAndView();
modelAndView.setViewName("index.jsp");
modelAndView.addObject("name","lisi");
return modelAndView;
}

4.3 回写数据

Web基础阶段,客户端访问服务器端,如果想直接回写字符串作为响应体返回的话
只需要使用 response.getWriter().print(“hello world”) 即可
那么在Controller中想直接回写字符串该怎样呢?

  1. 通过SpringMVC框架注入的response对象
    使用response.getWriter().print(“hello world”) 回写数据
    此时不需要视图跳转,业务方法返回值为void。
1
2
3
4
5
@RequestMapping("/quick4")
public void quickMethod4(HttpServletResponse response) throws
IOException {
response.getWriter().print("hello world");
}
  1. 将需要回写的字符串直接返回
    但此时需要通过@ResponseBody注解告知SpringMVC框架
    方法返回的字符串不是跳转是直接在http响应体中返回。
1
2
3
4
5
@RequestMapping("/quick5")
@ResponseBody
public String quickMethod5() throws IOException {
return "hello springMVC!!!";
}

在异步项目中,客户端与服务器端往往要进行json格式字符串交互,此时我们可以手动拼接json字符串返回

1
2
3
4
5
@RequestMapping("/quick6")
@ResponseBody
public String quickMethod6() throws IOException {
return "{\"name\":\"zhangsan\",\"age\":18}";
}

上述方式手动拼接json格式字符串的方式很麻烦,开发中往往要将复杂的java对象转换成json格式的字符串
我们可以使用web阶段学习过的json转换工具jackson进行转换,导入jackson坐标

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
<!--jackson-->
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-core</artifactId>
<version>2.9.0</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.9.0</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-annotations</artifactId>
<version>2.9.0</version>
</dependency>

通过jackson转换json格式字符串,回写字符串

1
2
3
4
5
6
7
8
9
10
@RequestMapping("/quick7")
@ResponseBody
public String quickMethod7() throws IOException {
User user = new User();
user.setUsername("zhangsan");
user.setAge(18);
ObjectMapper objectMapper = new ObjectMapper();
String s = objectMapper.writeValueAsString(user);
return s;
}

通过SpringMVC帮助我们对对象或集合进行json字符串的转换并回写,为处理器适配器配置消息转换参数
指定使用jackson进行对象或集合的转换,因此需要在spring-mvc.xml中进行如下配置

注意此处配置后后面返回字符串都会带上引号 尽量不要使用这种繁琐而且效果不好的办法

1
2
3
4
5
6
7
8
<!--配置处理器映射器-->
<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>
1
2
3
4
5
6
7
8
@RequestMapping("/quick8")
@ResponseBody
public User quickMethod8() throws IOException {
User user = new User();
user.setUsername("zhangsan");
user.setAge(18);
return user;
}

在方法上添加@ResponseBody就可以返回json格式的字符串
但是这样配置比较麻烦,配置的代码比较多
因此,我们可以使用MVC的注解驱动代替上述配置(引入mvc的引入空间)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
<!--mvc的注解驱动-->
<mvc:annotation-driven/>

<!--配置处理器映射器-->
<!--<bean class="org.springframework.web.servlet.mvc.method.annotation
.RequestMappingHandlerAdapter">
<property name="messageConverters">
<list>
<bean class="org.springframework.http.converter.json
.MappingJackson2HttpMessageConverter">
</bean>
</list>
</property>
</bean>-->

在 SpringMVC 的各个组件中,处理器映射器、处理器适配器、视图解析器称为 SpringMVC 的三大组件

使用自动加载 RequestMappingHandlerMapping(处理映射器)和 RequestMappingHandlerAdapter( 处理 适 配 器 ),可用在Spring-xml.xml配置文件中使用 替代注解处理器和适配器的配置

同时使用默认底层就会集成jackson进行对象或集合的json格式字符串的转换

5. SpringMVC获得请求数据

5.1 获得请求参数

客户端请求参数的格式是:name=value&name=value… … 服务器端要获得请求的参数,有时还需要进行数据的封装
SpringMVC可以接收如下类型的参数:

  • 基本类型参数
  • POJO类型参数
  • 数组类型参数
  • 集合类型参数

Controller中的业务方法的参数名称要与请求参数的name一致,参数值会自动映射匹配

springmvc1/quick9?username=zhangsan&age=12

1
2
3
4
5
6
@RequestMapping("/quick9")
@ResponseBody
public void quickMethod9(String username,int age) throws IOException {
System.out.println(username);
System.out.println(age);
}

Controller中的业务方法的POJO参数的属性名与请求参数的name一致,参数值会自动映射匹配

springmvc1/quick9?username=zhangsan&age=12

1
2
3
4
5
6
7
8
9
10
public class User {
private String username;
private int age;
getter/setter…
}
@RequestMapping("/quick10")
@ResponseBody
public void quickMethod10(User user) throws IOException {
System.out.println(user);
}

Controller中的业务方法数组名称与请求参数的name一致,参数值会自动映射匹配

springmvc1/quick11?strs=111&strs=222&strs=333

1
2
3
4
5
@RequestMapping("/quick11")
@ResponseBody
public void quickMethod11(String[] strs) throws IOException {
System.out.println(Arrays.asList(strs));
}

获得集合参数时,要将集合参数包装到一个POJO中才可以

1
2
3
4
5
6
7
<form action="${pageContext.request.contextPath}/quick12" method="post">
<input type="text" name="userList[0].username"><br>
<input type="text" name="userList[0].age"><br>
<input type="text" name="userList[1].username"><br>
<input type="text" name="userList[1].age"><br>
<input type="submit" value="提交"><br>
</form>
1
2
3
4
public calss Vo{
private List<User> userList
getter/setter...方法
}
1
2
3
4
5
@RequestMapping("/quick12")
@ResponseBody
public void quickMethod12(Vo vo) throws IOException {
System.out.println(vo.getUserList());
}

当使用ajax提交时,可以指定contentType为json形式,那么在方法参数位置使用@RequestBody可以直接接收集合数据而无需使用POJO进行包装

1
2
3
4
5
6
7
8
9
10
11
12
13
<script src="${pageContext.request.contextPath}/js/jquery-3.3.1.js"></script>
<script>
//模拟数据
var userList = new Array();
userList.push({username: "zhangsan",age: "20"});
userList.push({username: "lisi",age: "20"});
$.ajax({
type: "POST",
url: "/springmvc1/quick13",
data: JSON.stringify(userList),
contentType : 'application/json;charset=utf-8'
});
</script>
1
2
3
4
5
6
@RequestMapping("/quick13")
@ResponseBody
public void quickMethod13(@RequestBody List<User> userList) throws
IOException {
System.out.println(userList);
}

5.2 放行静态资源

注意:通过谷歌开发者工具抓包发现,没有加载到jquery文件
原因是SpringMVC的前端控制器 DispatcherServlet的url-pattern配置的是/
代表对所有的资源都进行过滤操作
我们可以通过以下两种方式指定放行静态资源:

  • 在spring-mvc.xml配置文件中指定放行的资源

    <mvc:resources mapping="/js/**" location="/js/"/>

  • 使用<mvc:default-servlet-handler/>标签

    代表原始容器去寻找资源

5.3 请求数据乱码问题

当post请求时,数据会出现乱码,我们可以设置一个过滤器来进行编码的过滤

1
2
3
4
5
6
7
8
9
10
11
12
<filter>
<filter-name>CharacterEncodingFilter</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>
</filter>
<filter-mapping>
<filter-name>CharacterEncodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>

5.4 参数绑定注解@requestParam

当请求的参数名称与Controller的业务方法参数名称不一致时,就需要通过@RequestParam注解显示的绑定

1
2
3
4
<form action="${pageContext.request.contextPath}/quick14" method="post">
<input type="text" name="name"><br>
<input type="submit" value="提交"><br>
</form>
1
2
3
4
5
6
@RequestMapping("/quick14")
@ResponseBody
public void quickMethod14(@RequestParam("name") String username) throws
IOException {
System.out.println(username);
}

注解@RequestParam还有如下参数可以使用

  • value:与请求参数名称
  • required:此在指定的请求参数是否必须包括,默认是true,提交时如果没有此参数则报错
  • defaultValue:当没有指定请求参数时,则使用指定的默认值赋值
1
2
3
4
5
6
@RequestMapping("/quick14")
@ResponseBody
public void quickMethod14(@RequestParam(value="name",required =
false,defaultValue = "你好!") String username) throws IOException {
System.out.println(username);
}

5.5 获得Restful风格的参数

Restful是一种软件架构风格、设计风格,而不是标准,只是提供了一组设计原则和约束条件
主要用于客户端和服务 器交互类的软件,基于这个风格设计的软件可以更简洁,更有层次,更易于实现缓存机制等

Restful风格的请求是使用“url+请求方式”表示一次请求目的的,HTTP 协议里面四个表示操作方式的动词如下:

  • GET:用于获取资源 /user/1 GET : 得到 id = 1 的 user
  • POST:用于新建资源 /user POST: 新增 user
  • PUT:用于更新资源 /user/1 PUT: 更新 id = 1 的 user
  • DELETE:用于删除资源 /user/1 DELETE: 删除 id = 1 的 user

上述url地址/user/1中的1就是要获得的请求参数,在SpringMVC中可以使用占位符进行参数绑定

地址/user/1可以写成 /user/{id},占位符{id}对应的就是1的值

在业务方法中我们可以使用@PathVariable注解进行占位符的匹配获取工作

springmvc1/quick19/zhangsan

1
2
3
4
5
@RequestMapping("/quick19/{name}")
@ResponseBody
public void quickMethod19(@PathVariable(value = "name",required = true) String name){
System.out.println(name);
}

5.6 自定义类型转换器

  • SpringMVC 默认已经提供了一些常用的类型转换器,例如客户端提交的字符串转换成int型进行参数设置

  • 但是不是所有的数据类型都提供了转换器,没有提供的就需要自定义转换器
    例如:日期类型的数据就需要自 定义转换器。

1. 定义转换器类实现Converter接口

1
2
3
4
5
6
7
8
9
10
11
12
13
public class DateConverter implements Converter<String,Date>{
@Override
public Date convert(String source) {
SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd");
try {
Date date = format.parse(source);
return date;
} catch (ParseException e) {
e.printStackTrace();
}
return null;
}
}

2. 在配置文件中声明转换器

1
2
3
4
5
6
7
8
<bean id="converterService" 
class="org.springframework.context.support.ConversionServiceFactoryBean">
<property name="converters">
<list>
<bean class="cn.jyw.converter.DateConverter"/>
</list>
</property>
</bean>

3. 在< annotation-driven>中引用转换器

1
<mvc:annotation-driven conversion-service="converterService"/>

5.7 获得Servlet相关API

SpringMVC支持使用原始ServletAPI对象作为控制器方法的参数进行注入,常用的对象如下

  • HttpServletRequest
  • HttpServletResponse
  • HttpSession
1
2
3
4
5
6
7
8
@RequestMapping("/quick16")
@ResponseBody
public void quickMethod16(HttpServletRequest request,HttpServletResponse
response,HttpSession session){
System.out.println(request);
System.out.println(response);
System.out.println(session);
}

5.8 获得请求头

使用@RequestHeader可以获得请求头信息,相当于web阶段学习的request.getHeader(name) @RequestHeader注解的属性如下:

  • value:请求头的名称
  • required:是否必须携带此请求头
1
2
3
4
5
6
@RequestMapping("/quick17")
@ResponseBody
public void quickMethod17(@RequestHeader(value = "User-Agent",required = false) String
headerValue){
System.out.println(headerValue);
}

使用@CookieValue可以获得指定Cookie的值 @CookieValue注解的属性如下:

  • value:指定cookie的名称
  • required:是否必须携带此cookie
1
2
3
4
5
@RequestMapping("/quick18")
@ResponseBody
public void quickMethod18(@CookieValue(value = "JSESSIONID",required = false) String jsessionid){
System.out.println(jsessionid);
}

6. 文件上传

6.1 文件上传客户端三要素

  • 表单项type=“file”
  • 表单的提交方式是post
  • 表单的enctype属性是多部分表单形式,及enctype=“multipart/form-data”

6.2 文件上传原理

  • 当form表单修改为多部分表单时,request.getParameter()将失效
  • enctype=“application/x-www-form-urlencoded”时,form表单的正文内容格式是key=value&key=value&key=value
  • 当form表单的enctype取值为Mutilpart/form-data时,请求正文内容就变成多部分形式:

6.3 单文件上传步骤

1. 导入fileupload和io坐标

1
2
3
4
5
6
7
8
9
10
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1.2.2</version>
</dependency>
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
<version>2.4</version>
</dependency>

2. 配置文件上传解析器

1
2
3
4
5
6
7
8
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
<!--上传文件总大小-->
<property name="maxUploadSize" value="5242800"/>
<!--上传单个文件的大小-->
<property name="maxUploadSizePerFile" value="5242800"/>
<!--上传文件的编码类型-->
<property name="defaultEncoding" value="UTF-8"/>
</bean>

3. 编写文件上传代码

1
2
3
4
5
6
7
8
9
@RequestMapping("/quick20")
@ResponseBody
public void quickMethod20(String name,MultipartFile uploadFile) throws
IOException {
//获得文件名称
String originalFilename = uploadFile.getOriginalFilename();
//保存文件
uploadFile.transferTo(new File("C:\\upload\\"+originalFilename));
}

6.4 多文件上传实现

多文件上传,只需要将页面修改为多个文件上传项,将方法参数MultipartFile类型修改为MultipartFile[]即可

1
2
3
4
5
6
7
8
<h1>多文件上传测试</h1>
<form action="${pageContext.request.contextPath}/quick21" method="post" enctype="multipart/form-data">
名称:<input type="text" name="name"><br>
文件1:<input type="file" name="uploadFiles"><br>
文件2:<input type="file" name="uploadFiles"><br>
文件3:<input type="file" name="uploadFiles"><br>
<input type="submit" value="提交"><br>
</form>
1
2
3
4
5
6
7
8
9
@RequestMapping("/quick21")
@ResponseBody
public void quickMethod21(String name,MultipartFile[] uploadFiles) throws
IOException {
for (MultipartFile uploadFile : uploadFiles){
String originalFilename = uploadFile.getOriginalFilename();
uploadFile.transferTo(new File("C:\\upload\\"+originalFilename));
}
}

7. SpringMVC拦截器

7.1 拦截器(interceptor)的作用

Spring MVC 的拦截器类似于 Servlet 开发中的过滤器 Filter,用于对处理器进行预处理和后处理

将拦截器按一定的顺序联结成一条链,这条链称为拦截器链(Interceptor Chain)

在访问被拦截的方 法或字段时,拦截器链中的拦截器就会按其之前定义的顺序被调用

拦截器也是AOP思想的具体实现

7.2 拦截器和过滤器区别

区别 过滤器(Filter) 拦截器(Interceptor)
使用范围 是servlet规范中的一部分,
任何Java Web 工程都能使用
是 SpringMVC 框架自己的,
只有使用了 SpringMVC 框架的工程才能用
拦截范围 在 url-pattern 中配置了/*之后,
可以对所有要访问的资源拦截
在< mvc:mapping path=””/>中配置了/**之后也可以多所有资源进行拦截
但是可以通过< mvc:exclude-mapping path=””/>标签排除不需要拦截的资源

7.3 拦截器快速入门

1. 创建拦截器类实现HandlerInterceptor接口

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
public class MyHandlerInterceptor1 implements HandlerInterceptor {
//在目标方法之前执行
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {
System.out.println("preHandle running...");
return true;
}
//在目标方法执行之后视图对象返回值执行
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) {
System.out.println("postHandle running...");
}
//在流程都执行完毕之后执行
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
System.out.println("afterCompletion running...");
}
}

2. 配置拦截器

1
2
3
4
5
6
7
8
<!--配置拦截器-->
<mvc:interceptors>
<mvc:interceptor>
<!--对哪些资源执行拦截操作-->
<mvc:mapping path="/**"/>
<bean class="cn.jyw.interceptor.MyHandlerInterceptor1"/>
</mvc:interceptor>
</mvc:interceptors>
1
2
3
4
5
6
7
8
9
@RequestMapping("/quick23")
@ResponseBody
public ModelAndView quickMethod23() throws IOException, ParseException {
System.out.println("目标方法执行....");
ModelAndView modelAndView = new ModelAndView();
modelAndView.addObject("name","itcast");
modelAndView.setViewName("index");
return modelAndView;
}

3. 测试拦截效果

1
2
3
4
5
6
7
8
9
@RequestMapping("/quick23")
@ResponseBody
public ModelAndView quickMethod23() {
System.out.println("目标方法执行....");
ModelAndView modelAndView = new ModelAndView();
modelAndView.addObject("name","Ciallo");
modelAndView.setViewName("index");
return modelAndView;
}

结果

1
2
3
4
preHandle running...
目标方法执行....
postHandle running...
afterCompletion running...

7.4 多拦截器操作

同上,在编写一个MyHandlerInterceptor2操作,测试执行顺序

1
2
3
4
5
6
7
preHandle running...
preHandle running222...
目标方法执行....
postHandle running222...
postHandle running...
afterCompletion running222...
afterCompletion running...

7.5 拦截器方法说明

方法名 说明
preHandle() 方法将在请求处理之前进行调用,该方法的返回值是布尔值Boolean类型的
当它返回为false 时,表示请求结束,后续的Interceptor 和Controller 都不会再执行
当返回值为true 时就会继续调用下一个Interceptor 的preHandle 方 法
postHandle() 该方法是在当前请求进行处理之后被调用,前提是preHandle 方法的返回值为 true 时才能被调用
且它会在DispatcherServlet 进行视图返回渲染之前被调用
所以我们可以在这个方法中对Controller 处理之后的ModelAndView 对象 进行操作
afterCompletion() 该方法将在整个请求结束之后,也就是在DispatcherServlet 渲染了对应的视图之后执行
前提是preHandle 方法的返回值为true 时才能被调用

8. SpringMVC异常处理机制

8.1 异常处理的思路

系统中异常包括两类:预期异常运行时异常RuntimeException,前者通过捕获异常从而获取异常信息,后者主要通过规范代码开发、测试等手段减少运行时异常的发生

系统的DaoServiceController出现都通过throws Exception向上抛出,最后由SpringMVC前端控制器交 由异常处理器进行异常处理,如下图

SpirngMVC异常处理

8.2 异常处理两种方式

  • 使用Spring MVC提供的简单异常处理器SimpleMappingExceptionResolver
  • 实现Spring的异常处理接口HandlerExceptionResolver 自定义自己的异常处理器

8.3 简单异常处理器SimpleMappingExceptionResolver

1
2
3
4
5
6
7
8
9
10
11
12
<!--配置简单映射异常处理器-->
<bean class=“org.springframework.web.servlet.handler.SimpleMappingExceptionResolver”>
<!--默认错误视图-->
<property name=“defaultErrorView” value=“error”/>
<property name=“exceptionMappings”>
<map>
<!--异常类型 错误视图-->
<entry key="cn.jyw.exception.MyException" value="error"/>
<entry key="java.lang.ClassCastException" value="error"/>
</map>
</property>
</bean>

8.4 自定义异常处理步骤

1. 创建异常处理器类实现HandlerExceptionResolver

1
2
3
4
5
6
7
8
9
10
public class MyExceptionResolver implements HandlerExceptionResolver {
@Override
public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
//处理异常的代码实现
//创建ModelAndView对象
ModelAndView modelAndView = new ModelAndView();
modelAndView.setViewName("exceptionPage");
return modelAndView;
}
}

2. 配置异常处理器

1
<bean id="exceptionResolver" class="cn.jyw.exception.MyExceptionResolver"/>

3. 编写异常页面

1
2
3
4
5
6
7
8
9
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
这是一个最终异常的显示页面
</body>
</html>

4. 测试异常跳转

1
2
3
4
5
6
@RequestMapping("/quick22")
@ResponseBody
public void quickMethod22() throws IOException, ParseException {
SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd");
simpleDateFormat.parse("abcde");
}