java大数据开发训练营--Java Web 后端技术基础（下）之SpringMVC基本应用
一 SpringMVC简介
1.1 MVC模式
MVC是软件工程中的一种软件架构模式，它是一种分离业务逻辑与显示界面的开发思想。
* M（model）模型：处理业务逻辑，封装实体
* V（view） 视图：展示内容
* C（controller）控制器：负责调度分发（1.接收请求、2.调用模型、3.转发到视图）
1.2 SpringMVC概述
SpringMVC 是一种基于 Java 的实现 MVC 设计模式的轻量级 Web 框架，属于SpringFrameWork 的后续产品，已经融合在 Spring Web Flow 中。
SpringMVC 已经成为目前最主流的MVC框架之一，并且随着Spring3.0 的发布，全面超越 Struts2，成为最优秀的 MVC 框架。它通过一套注解，让一个简单的 Java 类成为处理请求的控制器，而无须实现任何接口。同时它还支持 RESTful 编程风格的请求。
总结
* SpringMVC是对MVC设计模式的一种实现，属于轻量级的WEB框架。
* SpringMVC的框架就是封装了原来Servlet中的共有行为；例如：参数封装，视图转发等。
1.3 SpringMVC快速入门
需求
客户端发起请求，服务器接收请求，执行逻辑并进行视图跳转。
步骤分析
1. 创建web项目，导入SpringMVC相关坐标
2. 配置SpringMVC前端控制器 DispathcerServlet
3. 编写Controller类和视图页面
4. 使用注解配置Controller类中业务方法的映射地址
5. 配置SpringMVC核心文件 spring-mvc.xml
1）创建web项目，导入SpringMVC相关坐标
war
11
11
org.springframework
spring-webmvc
5.1.5.RELEASE
javax.servlet
javax.servlet-api
3.1.0
provided
javax.servlet.jsp
jsp-api
2.2
provided
2）配置SpringMVC前端控制器DispathcerServlet ，添加到web.xml中
dispatcherServlet
org.springframework.web.servlet.DispatcherServlet
contextConfigLocation
classpath:spring-mvc.xml
2
dispatcherServlet
/
3）编写视图页面
/WEB-INF/pages/ success.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
success
请求成功！
4）使用注解配置Controller类中业务方法的映射地址
@Controller
public class userController {
@RequestMapping("/q")
public String quick(){
System.out.println("quick正在进行");
return "/WEB-INF/pages/success.jsp";
}
}5）配置SpringMVC核心文件spring-mvc.xml
1.4 web工程执行流程
二 SpringMVC组件概述
2.1 SpringMVC的执行流程
1. 用户发送请求至前端控制器DispatcherServlet。
2. DispatcherServlet收到请求调用HandlerMapping处理器映射器。
3. 处理器映射器找到具体的处理器(可以根据xml配置、注解进行查找)，生成处理器对象及处理器拦截器(如果有则生成)一并返回给DispatcherServlet。
4. DispatcherServlet调用HandlerAdapter处理器适配器。
5. HandlerAdapter经过适配调用具体的处理器(Controller，也叫后端控制器)。6. Controller执行完成返回ModelAndView。
7. HandlerAdapter将controller执行结果ModelAndView返回给DispatcherServlet。
8. DispatcherServlet将ModelAndView传给ViewReslover视图解析器。
9. ViewReslover解析后返回具体View。
10. DispatcherServlet根据View进行渲染视图（即将模型数据填充至视图中）。
11. DispatcherServlet将渲染后的视图响应响应用户。
2.2 SpringMVC组件解析
1. 前端控制器：DispatcherServlet
用户请求到达前端控制器，它就相当于 MVC 模式中的 C，DispatcherServlet 是整个流程控制的中心，由它调用其它组件处理用户的请求，DispatcherServlet 的存在降低了组件之间的耦合性。
2. 处理器映射器：HandlerMapping
HandlerMapping 负责根据用户请求找到 Handler 即处理器，SpringMVC 提供了不同的映射器实现不同的映射方式，例如：配置文件方式，实现接口方式，注解方式等。
3. 处理器适配器：HandlerAdapter
通过 HandlerAdapter 对处理器进行执行，这是适配器模式的应用，通过扩展适配器可以对更多类型的处理器进行执行。
4. 处理器：Handler【**开发者编写**】
它就是我们开发中要编写的具体业务控制器。由 DispatcherServlet 把用户请求转发到Handler。由Handler 对具体的用户请求进行处理。
5. 视图解析器：ViewResolver
View Resolver 负责将处理结果生成 View 视图，View Resolver 首先根据逻辑视图名解析成物理视图名，即具体的页面地址，再生成 View 视图对象，最后对 View 进行渲染将处理结果通过页面展示给用户。
6. 视图：View 【**开发者编写**】
SpringMVC 框架提供了很多的 View 视图类型的支持，包括：jstlView、freemarkerView、pdfView等。最常用的视图就是 jsp。一般情况下需要通过页面标签或页面模版技术将模型数据通过页面展示给用户，需要由程序员根据业务需求开发具体的页面。
2.3 SpringMVC注解解析
@Controller
SpringMVC基于Spring容器，所以在进行SpringMVC操作时，需要将Controller存储到Spring容器中，如果使用@Controller注解标注的话，就需要使用：
@RequestMapping
* 作用：
用于建立请求 URL 和处理请求方法之间的对应关系
* 位置：
1.类上：请求URL的第一级访问目录。此处不写的话，就相当于应用的根目录。写的话需要以/开头。
它出现的目的是为了使我们的URL可以按照模块化管理:
用户模块
/user/add
/user/update
/user/delete
...
账户模块
/account/add
/account/update
/account/delete
2.方法上：请求URL的第二级访问目录，和一级目录组成一个完整的 URL 路径。* 属性：
1.value：用于指定请求的URL。它和path属性的作用是一样的
2.method：用来限定请求的方式
3.params：用来限定请求参数的条件
例如：params={"accountName"} 表示请求参数中必须有accountName
pramss={"money!100"} 表示请求参数中money不能是100
2.4 知识小结
* SpringMVC的三大组件
处理器映射器：HandlerMapping
处理器适配器：HandlerAdapter
视图解析器：View Resolver
* 开发者编写
处理器：Handler
视图：View
三 SpringMVC的请求
3.1 请求参数类型介绍
客户端请求参数的格式是： name=value&name=value……
服务器要获取请求的参数的时候要进行类型转换，有时还需要进行数据的封装
SpringMVC可以接收如下类型的参数：
基本类型参数
对象类型参数
数组类型参数
集合类型参数
3.2 获取基本类型参数
Controller中的业务方法的参数名称要与请求参数的name一致，参数值会自动映射匹配。并且能自动做类型转换；自动的类型转换是指从String向其他类型的转换。
${pageContext.request.contextPath}动态的来获取当前的项目路径
3---bigload@Controller
@RequestMapping("/user")
public class userController {
@RequestMapping("/simpleParam")
public String simpleParam(Integer id,String userName){
System.out.println(id+"---"+userName);
return "success";
}
}
3.3 获取对象类型参数
Controller中的业务方法参数的POJO属性名与请求参数的name一致，参数值会自动映射匹配。
user实体类
public class user {
private Integer id;
private String userName;
get,set,tostring...
}html
Controller
@RequestMapping("/pojoParam")
public String pojoParam(User user){
System.out.println(user);
return "success";
}3.4 中文乱码过滤器
当post请求时，数据会出现乱码，我们可以设置一个过滤器来进行编码的过滤。
web.xml
CharacterEncodingFilter
org.springframework.web.filter.CharacterEncodingFilter
encoding
UTF-8
CharacterEncodingFilter
/*
3.5 获取数组类型参数
Controller中的业务方法数组名称与请求参数的name一致，参数值会自动映射匹配。
@RequestMapping("/arrayParam")
public String arrayParam(Integer[] ids){
for (Integer id : ids) {
System.out.println(id);
}
return "success";
}3.6 获取集合（复杂）类型参数
获得集合参数时，要将集合参数包装到一个POJO中才可以。
html
QueryVo类
public class QueryVo {
private String keyword;
private User user;
private List userList;
private Map userMap;
get,set,tostring...
} @RequestMapping("/queryParam")
public String queryParam(QueryVo queryVo) {
System.out.println(queryVo);
return "success";
}3.7 自定义类型转换器
SpringMVC 默认已经提供了一些常用的类型转换器；例如：客户端提交的字符串转换成int型进行参数设置，日期格式类型要求为：yyyy/MM/dd 不然的话会报错，对于特有的行为，SpringMVC提供了自定义类型转换器方便开发者自定义处理。
将date的格式自定义要求为yyyy-MM-dd
日期格式化类dateConverter
public class dateConverter implements Converter {
@Override
public Date convert(String dateString) {
SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd");
Date date=null;
try {
date=simpleDateFormat.parse(dateString);
} catch (ParseException e) {
e.printStackTrace();
}
return date;
}
} spring-mvc.xml
userController
@RequestMapping("/forDate")
public String forDate(Date date){
System.out.println(date);
return "success";
}3.8 相关注解
@RequestParam
当请求的参数name名称与Controller的业务方法参数名称不一致时，就需要通过@RequestParam注解显示的绑定
自定义变量名和默认值 /*
@RequestParam() 注解
defaultValue 设置参数默认值
name 匹配页面传递参数的名称
required 设置是否必须传递参数，默认值为true；如果设置了默认值，值自动改为false
*/
@RequestMapping("/findByPage")
public String findByPage(@RequestParam(name = "pageNo",defaultValue = "1") Integer pageNum,@RequestParam(defaultValue = "5") Integer pageSize){
System.out.println(pageNum);
System.out.println(pageSize);
return "success";
}@RequestHeader
获取请求头的数据。
@RequestMapping("/findByPage")
public String findByPage(@RequestHeader("cookie") String cookie){
System.out.println(cookie);
return "success";
}@CookieValue
获取cookie中的数据。
@RequestMapping("/findByPage")
public String findByPage(@RequestHeader("cookie") String cookie,@CookieValue("JSESSIONID") String jesessionId){
System.out.println(cookie);
System.out.println(jesessionId);
return "success";
}3.9 获取Servlet相关API
SpringMVC支持使用原始ServletAPI对象作为控制器方法的参数进行注入，常用的对象如下：
@RequestMapping("/servletAPI")
public String servletAPI(HttpServletRequest request, HttpServletResponse response, HttpSession session) {
System.out.println(request);
System.out.println(response);
System.out.println(session);
return "success";
}四 SpringMVC的响应
4.1 SpringMVC响应方式介绍
页面跳转
1. 返回字符串逻辑视图
2. void原始ServletAPI
3. ModelAndView返回数据
1. 直接返回字符串数据
2. 将对象或集合转为json返回（任务二演示）
4.2 返回字符串逻辑视图
直接返回字符串：此种方式会将返回的字符串与视图解析器的前后缀拼接后跳转到指定页面
@RequestMapping("/returnString")
public String returnString() {
return "success";
}
4.3 void原始ServletAPI
我们可以通过request、response对象实现响应
1.通过response直接响应数据
@RequestMapping("/returnVoid")
public void returnVoid(HttpServletRequest request,HttpServletResponse response) throws IOException {
response.setContentType("text/html;charset=utf-8");
response.getWriter().write("hello,我的大佳仔");
}2.通过request实现转发
@RequestMapping("/returnVoid")
public void returnVoid(HttpServletRequest request,HttpServletResponse response) throws IOException, ServletException {
request.setAttribute("userName","大佳仔");
request.getRequestDispatcher("/WEB-INF/pages/success.jsp").forward(request,response);
}请求成功！hello,${userName}
3.通过response实现重定向
借助response对象完成重定向 两次请求 WEB-INF：安全目录：不允许外部请求直接访问该目录资源，只可以进行服务器内部转发 @RequestMapping("/returnVoid")
public void returnVoid(HttpServletRequest request,HttpServletResponse response) throws IOException, ServletException {
response.sendRedirect(request.getContextPath() + "/index.jsp");
}4.4 转发和重定向
企业开发我们一般使用返回字符串逻辑视图实现页面的跳转，这种方式其实就是请求转发。
我们也可以写成：forward转发
如果用了forward：则路径必须写成实际视图url，不能写逻辑视图。它相当于：request.getRequestDispatcher("url").forward(request,response)
使用请求转发，既可以转发到jsp，也可以转发到其他的控制器方法。
@RequestMapping("/forward")
public String forward(Model model){
model.addAttribute("userName","大佳仔");
return "forward:/WEB-INF/pages/success.jsp";
}Redirect重定向
我们可以不写虚拟目录，springMVC框架会自动拼接，并且将Model中的数据拼接到url地址上
@RequestMapping("/redirect")
public String redirect(Model model){
// 底层使用的还是reqeust.setAttribute("username","拉勾教育") 域范围：一次请求
// 所以这个不会传递过去
model.addAttribute("userName","大佳仔");
return "redirect:/index.jsp";
}4.5 ModelAndView
4.4.1 方式一
在Controller中方法创建并返回ModelAndView对象，并且设置视图名称
@RequestMapping("/modelandView")
public ModelAndView modelAndView(){
/*
Model:模型 作用封装数据
View：视图 作用展示数据
*/
ModelAndView modelAndView = new ModelAndView();
modelAndView.addObject("userName","bigload");
modelAndView.setViewName("success");
return modelAndView;
}4.4.2 方式二
在Controller中方法形参上直接声明ModelAndView，无需在方法中自己创建，在方法中直接使用该对象设置视图，同样可以跳转页面
@RequestMapping("/modelandView2")
public ModelAndView modelAndView2(ModelAndView modelAndView){
//设置模型数据
modelAndView.addObject("userName","bigload");
//设置视图名称
modelAndView.setViewName("success");
return modelAndView;
}4.6 @SessionAttributes
如果在多个请求之间共用数据，则可以在控制器类上标注一个 @SessionAttributes,配置需要在session中存放的数据范围，Spring MVC将存放在model中对应的数据暂存到 HttpSession 中。
注意：@SessionAttributes只能定义在类上
@Controller
@RequestMapping("/user")
@SessionAttributes("userName") //向request域存入的key为username时，同步到session域中
public class userController {
@RequestMapping("/modelandView2")
public ModelAndView modelAndView2(ModelAndView modelAndView){
//设置模型数据
modelAndView.addObject("userName","bigload");
//设置视图名称
modelAndView.setViewName("success");
return modelAndView;
}
@RequestMapping("/redirect")
public String redirect(Model model){
return "redirect:/index.jsp";
}
}五 静态资源访问的开启
当有静态资源需要加载时，比如jquery文件，通过谷歌开发者工具抓包发现，没有加载到jquery文件，原因是SpringMVC的前端控制器DispatcherServlet的url-pattern配置的是 /（缺省）,代表对所有的静态资源都进行处理操作，这样就不会执行Tomcat内置的DefaultServlet处理，我们可以通过以下两种方式指定放行静态资源：
spring-mvc.xml
方式一
方式二
六 ajax异步交互
Springmvc默认用MappingJackson2HttpMessageConverter对json数据进行转换，需要加入jackson的包；
同时使用
com.fasterxml.jackson.core
jackson-databind
2.9.8
com.fasterxml.jackson.core
jackson-core
2.9.8
com.fasterxml.jackson.core
jackson-annotations
2.9.0
6.1 @RequestBody
该注解用于Controller的方法的形参声明，当使用ajax提交并指定contentType为json形式时，通过HttpMessageConverter接口转换为对应的POJO对象。
@RequestMapping("/ajaxRequest")
public String forJson(@RequestBody List user){
System.out.println(user);
return "success";
} 6.2 @ResponseBody
该注解用于将Controller的方法返回的对象，通过HttpMessageConverter接口转换为指定格式的数据如：json,xml等，通过Response响应给客户端。
/*
@RequestMapping
produces = "application/json;charset=utf-8" 响应返回数据的mime类型和编码，默认为 json
*/
@RequestMapping("/ajaxRequest")
@ResponseBody
public List forJson(@RequestBody List user){
System.out.println(user);
return user;
} 七 RESTful
7.1 什么是RESTful
Restful是一种软件架构风格、设计风格，而不是标准，只是提供了一组设计原则和约束条件。主要用于客户端和服务器交互类的软件，基于这个风格设计的软件可以更简洁，更有层次，更易于实现缓存机制等。
Restful风格的请求是使用“url+请求方式”表示一次请求目的的，HTTP 协议里面四个表示操作方式的动词如下：
- GET：读取（Read）
- POST：新建（Create）
- PUT：更新（Update）
- DELETE：删除（Delete）
| 客户端请求 |
原来风格URL地址 | RESTful风格URL地址 |
| 查询所有 | /user/findAll | GET /user |
| 根据ID查询 | /user/findById?id=1 | GET /user/{1} |
| 新增 | /user/save | POST /user |
| 修改 | /user/update | PUT /user |
| 删除 | /user/delete?id=1 | DELETE /user/{1} |
7.2 代码实现
@PathVariable
用来接收RESTful风格请求地址中占位符的值
@RestController
RESTful风格多用于前后端分离项目开发，前端通过ajax与服务器进行异步交互，我们处理器通常返回的是json数据所以使用@RestController来替代@Controller和@ResponseBody两个注解。
请求方式不同可以使用不同的注解
@GetMapping
@PostMapping
@PutMapping
@DeleteMapping
@RestController
public class RestFulController {
@GetMapping(value = "/user/{id}")
@ResponseBody
public Integer getMapping(@PathVariable Integer id){
System.out.println("get:"+id);
return id;
}
@PostMapping(value = "/user")
@ResponseBody
public String postMapping(Integer id){
return "post";
}
@PutMapping(value = "/user")
@ResponseBody
public String putMapping(Integer id){
return "put";
}
@DeleteMapping(value = "/user/{id}")
@ResponseBody
public Integer delMapping(@PathVariable Integer id){
System.out.println("del:"+id);
return id;
}
}
八 文件上传
8.1 文件上传三要素
- 表单项 type="file"
- 表单的提交方式 method="POST"
- 表单的enctype属性是多部分表单形式 enctype=“multipart/form-data"
8.2 文件上传原理
当form表单修改为多部分表单时，request.getParameter()将失效。
当form表单的enctype取值为application/x-www-form-urlencoded 时，form表单的正文内容格式是： name=value&name=value
当form表单的enctype取值为mutilpart/form-data时，请求正文内容就变成多部分形式：
8.3 单文件上传
步骤分析
1. 导入fileupload和io坐标
2. 配置文件上传解析器
3. 编写文件上传代码
1）导入fileupload和io坐标
commons-fileupload
commons-fileupload
1.3.3
commons-io
commons-io
2.6
2）配置文件上传解析器
3）编写文件上传代码
@RequestMapping("/uploadFile")
public String uploadFile(String userName, MultipartFile file) throws IOException {
// 获取文件名
String originalFilename = file.getOriginalFilename();
//创建用户名的文件夹，不存在就创建
File dir = new File("g:/file/" + userName);
if (!dir.exists()){
dir.mkdirs();
}
//保存文件
file.transferTo(new File(dir.toPath()+"/"+originalFilename));
System.out.println(dir.getAbsolutePath());
return "success";
}8.4 多文件上传
@RequestMapping("/uploadFile")
public String uploadFile(String userName, MultipartFile[] file) throws IOException {
//创建用户名的文件夹，不存在就创建
File dir = new File("g:/file/" + userName);
if (!dir.exists()){
dir.mkdirs();
}
for (MultipartFile multipartFile : file) {
// 获取文件名
String originalFilename = multipartFile.getOriginalFilename();
//保存文件
multipartFile.transferTo(new File(dir.toPath()+"/"+originalFilename));
}
return "success";
}九 异常处理
9.1 异常处理的思路
在Java中，对于异常的处理一般有两种方式:
一种是当前方法捕获处理（try-catch），这种处理方式会造成业务代码和异常处理代码的耦合。
另一种是自己不处理，而是抛给调用者处理（throws），调用者再抛给它的调用者，也就是一直向上抛。
在这种方法的基础上，衍生出了SpringMVC的异常处理机制。
系统的dao、service、controller出现都通过throws Exception向上抛出，最后由springmvc前端控制器交由异常处理器进行异常处理，如下图：
9.2 自定义异常处理器
步骤分析
1. 创建异常处理器类实现HandlerExceptionResolver
2. 配置异常处理器
3. 编写异常页面
4. 测试异常跳转
1）创建异常处理器类实现HandlerExceptionResolver
@Component
public class GlobalExecptionResovler implements HandlerExceptionResolver {
@Override
public ModelAndView resolveException(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse, Object o, Exception e) {
ModelAndView modelAndView = new ModelAndView();
modelAndView.addObject("error",e.getMessage());
//配置视图的名称
modelAndView.setViewName("error");
return modelAndView;
}
}
2）配置异常处理器
3）编写异常页面 \WEB-INF\pages\error.jsp 和在处理器类中填写的视图名称保持一致
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
error
错误显示页面
${error}
4）测试异常跳转
@RequestMapping("/quick")
public String quick() {
int a=1/0;
return "success";
}9.3 web的处理异常机制
500
/WEB-INF/pages/500.jsp
404
/WEB-INF/pages/404.jsp
十 拦截器
10.1 拦截器（interceptor）的作用
Spring MVC 的拦截器类似于 Servlet 开发中的过滤器 Filter，用于对处理器进行预处理和后处理。
将拦截器按一定的顺序联结成一条链，这条链称为拦截器链（InterceptorChain）。在访问被拦截的方法或字段时，拦截器链中的拦截器就会按其之前定义的顺序被调用。拦截器也是AOP思想的具体实现。
10.2 拦截器和过滤器区别
关于interceptor和filter的区别，如图所示：
10.3 快速入门
步骤分析
1. 创建拦截器类实现HandlerInterceptor接口
2. 配置拦截器
3. 测试拦截器的拦截效果
1）创建拦截器类实现HandlerInterceptor接口
public class myInterceptor implements HandlerInterceptor {
// 在目标方法执行之前 拦截 true放行，false拦截
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
return true;
}
// 在目标方法执行之后,视图对象返回之前 执行
@Override
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
System.out.println("postHandle执行了");
}
// 在流程都执行完毕后 执行
@Override
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
System.out.println("afterCompletion执行了");
}
}
2）配置拦截器
3）测试拦截器的拦截效果
编写Controller,发请求到controller,跳转页面
@Controller
@RequestMapping("/user")
@SessionAttributes("userName") //向request域存入的key为username时，同步到session域中
public class userController {
@RequestMapping("/quick")
public String quick() {
System.out.println("quick执行了");
return "success";
}
}10.4 拦截器链
开发中拦截器可以单独使用，也可以同时使用多个拦截器形成一条拦截器链。开发步骤和单个拦截器是一样的，只不过注册的时候注册多个，注意这里注册的顺序就代表拦截器执行的顺序。
同上，再编写一个MyHandlerInterceptor2操作，测试执行顺序：
10.5 知识小结
拦截器中的方法说明如下：
当preHandle都为true时
当1为true，2为false
当拦截器1的preHanle为false，2是什么也无所谓都走不到
