1. SpringMVC基础应用
1.1 SpringMVC概述
1.1.1 MVC模式
-
MVC是软件工程中的一种软件架构模式,它是一种分离业务逻辑与显示界面的开发思想
-
M(model)模型:处理业务逻辑,封装实体
-
V(view) 视图:展示内容
-
C(controller)控制器:负责调度分发(1.接收请求、2.调用模型、3.转发到视图)
-
-
三层结构
1.1.2 SpringMVC概述
-
SpringMVC 是一种基于 Java 的实现 MVC 设计模式的轻量级 Web 框架,属于SpringFrameWork 的
后续产品,已经融合在 Spring Web Flow 中。
-
SpringMVC 已经成为目前最主流的MVC框架之一,并且随着Spring3.0 的发布,全面超越 Struts2,成为最优秀的 MVC 框架。它通过一套注解,让一个简单的 Java 类成为处理请求的控制器,而无须实现任何接口。同时它还支持 RESTful 编程风格的请求
-
浏览器与Tomact
-
SpringMVC的框架就是封装了原来Servlet中的共有行为;例如:参数封装,视图转发等。
1.2 SpringMVC快速入门
1.2.1 maven配置
-
创建一个普通的maven项目, 在pom文件里添加
<packaging>war</packaging>
-
添加下面依赖即可
<dependencies> <!--springMVC坐标--> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>5.1.5.RELEASE</version> </dependency> <!--servlet坐标--> <dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> <version>3.1.0</version> <scope>provided</scope> </dependency> <!--jsp坐标--> <dependency> <groupId>javax.servlet.jsp</groupId> <artifactId>jsp-api</artifactId> <version>2.2</version> <scope>provided</scope> </dependency> </dependencies>
1.2.2 添加web.xml文件[重点]
-
找到 File => Project Structure
-
点击 + 号 添加web.xml文件, 注意可能需要手动确定web.xml的位置
-
默认的可能直接创建在根目录下了
-
需要特别注意的是 配置一定要是下图两个目录, 第一个是 WEB-INF下的 web.xml文件
-
第二个是 webapp 目录, 如果这个配置的不对会出现找不到jsp文件,404等问题
1.2.3 创建SpringMvc配置文件
-
在resources目录下面创建spring-mcv.xml文件
-
添加如下内容, 配置注解扫描路径主要是扫描
@Controller
之类的注解<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.knightzz.controller"/> </beans>
1.2.4 配置前端控制器
-
找到 web.xml 配置前端控制器
<?xml version="1.0" encoding="UTF-8"?> <web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd" version="4.0"> <!--前端控制器--> <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> <load-on-startup>2</load-on-startup> </servlet> <servlet-mapping> <servlet-name>dispatcherServlet</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping> </web-app>
-
在应用启动时,就完成servlet的实例化及初始化操作 :
<load-on-startup>2</load-on-startup>
-
<url-pattern>/</url-pattern>
/ 会匹配到所有的访问路径, -
但是不会匹配到像*.jsp这样的方法url /login/add /update /a.jsp
1.2.5 编写success.jsp
-
在 webapp 下的 pages 文件夹下创建 success.jsp 文件
<%@ page contentType="text/html;charset=UTF-8" language="java" %> <html> <head> <title>success</title> </head> <body> <h3>请求成功!</h3> </body> </html>
1.2.6 编写Controller
-
编写Controller
package cn.knightzz.controller; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.RequestMapping; /** * @author 王天赐 * @title: QuickController * @projectName springmvc-apply-01 * @description: * @website http://knightzz.cn/ * @github https://github.com/knightzz1998 * @date 2022/2/1 20:14 */ @Controller public class QuickController { @RequestMapping("/quick") public String quick(){ System.out.println("quick .... "); return "pages/success.jsp"; } }
1.2.7 使用tomcat启动
-
添加 war 包
-
红框部分是访问根路径, 需要修改成自己的, 我的是
/springmvc-apply-01
所以访问时直接访问 -
http://localhost:8080/springmvc-apply-01/quick
即可
1.3 Web工程执行流程
2. SpringMVC组件概述
2.1 SpringMVC执行流程
2.2 执行流程解析
-
用户发送请求至前端控制器DispatcherServlet。
-
DispatcherServlet收到请求调用HandlerMapping处理器映射器。
-
处理器映射器找到具体的处理器(可以根据xml配置、注解进行查找),生成处理器对象及处理器拦截器(如
果有则生成)一并返回给DispatcherServlet。
-
DispatcherServlet调用HandlerAdapter处理器适配器。
-
HandlerAdapter经过适配调用具体的处理器(Controller,也叫后端控制器)。
-
Controller执行完成返回ModelAndView。
-
HandlerAdapter将controller执行结果ModelAndView返回给DispatcherServlet。
-
DispatcherServlet将ModelAndView传给ViewReslover视图解析器。
-
ViewReslover解析后返回具体View。
-
DispatcherServlet根据View进行渲染视图(即将模型数据填充至视图中)。
-
DispatcherServlet将渲染后的视图响应响应用户。
2.3 SpringMVC组件解析
-
前端控制器:DispatcherServlet
- 用户请求到达前端控制器,它就相当于 MVC 模式中的 C,
- DispatcherServlet 是整个流程控制的 中心,由它调用其它组件处理用户的请求,DispatcherServlet 的存在降低了组件之间的耦合性
-
处理器映射器:HandlerMapping
- HandlerMapping 负责根据用户请求找到 Handler 即处理器,
- SpringMVC 提供了不同的映射器实现不同的映射方式,例如:配置文件方式,实现接口方式,注解方式等。
-
处理器适配器:HandlerAdapter
- 通过 HandlerAdapter 对处理器进行执行,这是适配器模式的应用,通过扩展适配器可以对更多类型 的处理器进行执行。
-
处理器:Handler【开发者编写】
- 它就是我们开发中要编写的具体业务控制器。由 DispatcherServlet 把用户请求转发到 Handler。由Handler 对具体的用户请求进行处理。
-
视图解析器:ViewResolver
- View Resolver 负责将处理结果生成 View 视图,View Resolver 首先根据逻辑视图名解析成物 理视图名,即具体的页面地址,再生成 View 视图对象,最后对 View 进行渲染将处理结果通过页面展示给 用户。
-
视图:View 【开发者编写】
- SpringMVC 框架提供了很多的 View 视图类型的支持,包括:jstlView、freemarkerView、 pdfView等。最常用的视图就是 jsp。一般情况下需要通过页面标签或页面模版技术将模型数据通过页面展 示给用户,需要由程序员根据业务需求开发具体的页面
2.4 SpringMVC注解
2.4.1 @Controller
-
SpringMVC基于Spring容器,所以在进行SpringMVC操作时,需要将
Controller
存储到Spring容器中,如果使用
@Controller
注解标注的话,就需要使用:<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.knightzz"/> </beans>
2.4.2 @RequestMapping
-
用于建立请求 URL 和处理请求方法之间的对应关系
-
类上:请求URL的第一级访问目录。此处不写的话,就相当于应用的根目录。写的话需要以/开头。
它出现的目的是为了使我们的URL可以按照模块化管理:
用户模块 /user/add /user/update /user/delete ... 账户模块 /account/add /account/update /account/delete
-
方法上:请求URL的第二级访问目录,和一级目录组成一个完整的 URL 路径。
-
注解属性 :
- value:用于指定请求的URL。它和path属性的作用是一样的
- method:用来限定请求的方式
- params:用来限定请求参数的条件
- 例如:
params={"accountName"}
表示请求参数中必须有accountNamepramss={"money!100"}
表示请求参数中money不能是100
3. SpringMVC请求解析
3.1 请求参数类型
- 客户端请求参数的格式是:
name=value&name=value……
- 服务器要获取请求的参数的时候要进行类型转换,有时还需要进行数据的封装
- SpringMVC可以接收如下类型的参数:
- 基本类型参数
- 对象类型参数
- 数组类型参数
- 集合类型参数
3.2 基本参数获取
-
页面直接跳转的话需要添加
${pageContext.request.contextPath}
, 否则会直接以根路径访问 -
index.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %> <html> <head> <title>Index</title> </head> <body> <h3>Index</h3> <a href="${pageContext.request.contextPath}/simpleParam?id=101&username=TOM">simpleParam</a> </body> </html>
-
UserController
package cn.knightzz.controller; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.RequestMapping; /** * @author 王天赐 * @title: UserController * @projectName springmvc-apply-01 * @description: * @website http://knightzz.cn/ * @github https://github.com/knightzz1998 * @date 2022/2/1 21:35 */ @Controller public class UserController { @RequestMapping("/simpleParam") public String simpleParam(Integer id, String username){ System.out.println(id); System.out.println(username); return "pages/success.jsp"; } }
3.3 对象类型参数
-
Controller中的业务方法参数的POJO属性名与请求参数的name一致,参数值会自动映射匹配。
-
index.jsp
<h3>对象类型参数获取</h3> <form action="${pageContext.request.contextPath}/entityParam" method="post"> 编号:<input type="text" name="id"> <br> 用户名:<input type="text" name="username"> <br> <input type="submit" value="对象类型"> </form>
-
UserController
package cn.knightzz.controller; import cn.knightzz.entity.User; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.RequestMapping; @Controller public class UserController { @RequestMapping("/entityParam") public String simpleParam(User user){ System.out.println(user); return "pages/success.jsp"; } }
3.4 中文乱码过滤器
-
上面的post请求, 如果输入的username是中文的话,数据会出现乱码
-
所以我们可以设置一个过滤器来进行编码的过滤
-
在
web.xml
文件中添加如下配置<!--配置全局过滤的filter--> <filter> <filter-name>CharacterEncodingFilter</filter-name> <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class> <init-param> <param-name>encoding</param-name> <!-- 根据具体情况设置为 GBK 或者UTF-8--> <param-value>GBK</param-value> </init-param> </filter> <filter-mapping> <filter-name>CharacterEncodingFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping>
3.5 数据类型参数
-
Controller中的业务方法数组名称与请求参数的name一致,参数值会自动映射匹配。
-
index.jsp
<h3>数组类型参数获取</h3> <form action="${pageContext.request.contextPath}/arrayParam"> 编号:<br> <input type="checkbox" name="ids" value="1">1<br> <input type="checkbox" name="ids" value="2">2<br> <input type="checkbox" name="ids" value="3">3<br> <input type="checkbox" name="ids" value="4">4<br> <input type="checkbox" name="ids" value="5">5<br> <input type="submit" value="数组类型"> </form>
-
UserController
@RequestMapping("/arrayParam") public String arrayParam(Integer[] ids){ for (Integer id : ids) { System.out.println(id); } return "pages/success.jsp"; }
3.6 视图解析器配置
-
当我们处理完请求想要跳转到某个页面, 需要返回页面的全路径比如 :
/pages/success.jsp
-
如果我们配置了视图解析, 可以直接使用
success
即可 -
在 spring-mvc.xml 里面添加如下配置即可
<bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <!-- 用于解析视图名, /pages/success.jsp => 直接使用 success 即可--> <property name="prefix" value="/pages/"></property> <property name="suffix" value=".jsp"></property> </bean>
3.7 自定义类型转换器
-
SpringMVC 默认已经提供了一些常用的类型转换器;
-
例如:客户端提交的字符串转换成int型进行参数设置,日期格式类型要求为:yyyy/MM/dd 不然的话会报错,对于特有的行为,SpringMVC提供了自定义类型转换器方便开发者自定义处理
-
创建转换器
package cn.knightzz.convert; import org.springframework.core.convert.converter.Converter; import java.text.ParseException; import java.text.SimpleDateFormat; import java.util.Date; public class DateConverter implements Converter<String, Date> { @Override public Date convert(String s) { SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd"); Date date = null; try { date = simpleDateFormat.parse(s); System.out.println(date); System.out.println(s); } catch (ParseException e) { e.printStackTrace(); } return new Date(); } }
-
在 spring-mvc.xml 中添加配置
<!-- 处理器适配器, 增强了功能, 支持 json 的读写--> <mvc:annotation-driven conversion-service="conversionService"></mvc:annotation-driven> <!--自定义转换器配置--> <bean id="conversionService" class="org.springframework.context.support.ConversionServiceFactoryBean"> <property name="converters"> <set> <bean class="cn.knightzz.convert.DateConverter"></bean> </set> </property> </bean>
-
Controller
@RequestMapping("/converterParam") public String converterParam(Date birthday){ // 注意 birthday 需要和请求的name值一致, 否则无法获取到数据 System.out.println("converterParam => "); System.out.println(birthday); return "success"; }
-
index.jsp
<h3>自定义类型转换器</h3> <form action="${pageContext.request.contextPath}/converterParam" > 生日:<input type="text" name="birthday"> <input type="submit" value="自定义类型转换器"> </form>
3.8 参数注解
3.8.1 @RequestParam
-
当请求的参数name名称与Controller的业务方法参数名称不一致时,就需要通过@RequestParam注
解显示的绑定
-
Controller
@RequestMapping("/requestParam") public String requestParam(@RequestParam(name = "id", defaultValue = "1", required = false) Integer uid, @RequestParam("username") String name){ // @RequestParam() 注解 defaultValue 设置参数默认值 name 匹配页面传递参数的名称 // required 设置是否必须传递参数,默认值为true;如果设置了默认值,值自动改为false System.out.println("uid = " + uid); System.out.println("name = " + name); return "success"; }
-
index.jsp
<h3>@RequestParam</h3> <a href="${pageContext.request.contextPath}/requestParam?id=101&username=张飞">@requestParam</a>
3.8.2 @RequestHeader
-
获取请求头的数据。
@RequestMapping("/requestHead") public String requestHead(@RequestHeader("cookie") String cookie) { System.out.println(cookie); return "success"; }
3.8.3 @CookieValue
-
获取cookie中的数据
@RequestMapping("/cookieValue") public String cookieValue(@CookieValue("JSESSIONID") String jesessionId) { System.out.println(jesessionId); return "success"; }
-
index.jsp
<h3>@RequestHeader</h3> <a href="${pageContext.request.contextPath}/requestHead">@RequestHeader</a> <h3>@HeaderParam</h3> <a href="${pageContext.request.contextPath}/cookieValue">@CookieValue</a>
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"; }
4. SpringMVC响应解析
4.1 响应方式介绍
4.1.1. 页面跳转
- 返回字符串逻辑视图
- void原始ServletAPI
- ModelAndView
4.1.2 返回数据
- 直接返回字符串数据
- 将对象或集合转为json返回
4.2 返回字符串逻辑视图
-
直接返回字符串:此种方式会将返回的字符串与视图解析器的前后缀拼接后跳转到指定页面
-
视图解析器配置 : 配置在 spring-mvc.xml
<bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <!-- 用于解析视图名, /pages/success.jsp => 直接使用 success 即可--> <property name="prefix" value="/pages/"></property> <property name="suffix" value=".jsp"></property> </bean>
-
代码
@RequestMapping("/returnString") public String returnString() { return "success"; }
4.3 初始API
-
使用ServletAPI实现对象相响应
@RequestMapping("/returnVoid") public void returnVoid(HttpServletRequest request, HttpServletResponse response) throws Exception { // 1.通过response直接响应数据 response.setContentType("text/html;charset=utf-8"); response.getWriter().write("returnVoid"); // ---------------------------------------- request.setAttribute("username", "root"); // 2.通过request实现转发 request.getRequestDispatcher("/pages/success.jsp").forward(request, response); // ---------------------------------------- // 3.通过response实现重定向 response.sendRedirect(request.getContextPath() + "/index.jsp"); }
4.4 转发与重定向
4.4.1 转发
-
发我们一般使用返回字符串逻辑视图实现页面的跳转,这种方式其实就是请求转发
-
如果用了forward:则路径必须写成实际视图url,不能写逻辑视图。它相当于
request.getRequestDispatcher("/pages/success.jsp").forward(request, response);
-
使用请求转发,既可以转发到jsp,也可以转发到其他的控制器方法。
@RequestMapping("/forward") public String forward(Model model) { model.addAttribute("username", "root"); return "forward:/pages/success.jsp"; }
4.4.2 重定向
-
我们可以不写虚拟目录,springMVC框架会自动拼接,并且将Model中的数据拼接到url地址上
@RequestMapping("/redirect") public String redirect(Model model) { model.addAttribute("username", "张飞"); return "redirect:/index.jsp"; }
4.5 ModelAndView
4.5.1 方式一
-
在Controller中方法创建并返回ModelAndView对象,并且设置视图名称
@RequestMapping("/returnModelAndView1") public ModelAndView returnModelAndView1() { // Model:模型 作用封装数据 View:视图 作用展示数据 ModelAndView modelAndView = new ModelAndView(); //设置模型数据 modelAndView.addObject("username", "方式一"); //设置视图名称, 跳转到 result 页面 modelAndView.setViewName("result"); return modelAndView; }
-
result.jsp
<%-- Created by IntelliJ IDEA. User: knightzz98 Date: 2022/2/2 Time: 16:13 To change this template use File | Settings | File Templates. --%> <%@ page contentType="text/html;charset=UTF-8" language="java" %> <html> <head> <title>Result</title> </head> <body> <h3>${username}</h3> </body> </html>
4.5.2 方式二
-
在Controller中方法形参上直接声明ModelAndView,无需在方法中自己创建,在方法中直接使用该
对象设置视图,同样可以跳转页面
@RequestMapping("/returnModelAndView2") public ModelAndView returnModelAndView1(ModelAndView modelAndView) { //设置模型数据 modelAndView.addObject("username", "方式二"); //设置视图名称, 跳转到 result 页面 modelAndView.setViewName("result"); return modelAndView; }
4.6 @SessionAttributes
4.6.1 注解作用
- 如果在多个请求之间共用数据,则可以在控制器类上标注一个 @SessionAttributes
- 配置需要在session中存放的数据范围,Spring MVC将存放在model中对应的数据暂存到 HttpSession 中。
4.6.2 代码案例
-
SessionController
package cn.knightzz.controller; import org.springframework.stereotype.Controller; import org.springframework.ui.Model; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.SessionAttributes; /** * @author 王天赐 * @title: SessionController * @projectName springmvc-apply-01 * @description: * @website http://knightzz.cn/ * @github https://github.com/knightzz1998 * @date 2022/2/2 16:22 */ @Controller @SessionAttributes("username") public class SessionController { // @SessionAttributes("username") 向request域存入的key为username时,同步到session域中 @RequestMapping("/forward2") public String forward(Model model) { // 添加到 request 域中 model.addAttribute("username", "SessionAttributes"); return "forward:/pages/result.jsp"; } @RequestMapping("/returnString2") public String returnString() { return "result"; } }
-
result.jsp
<%-- Created by IntelliJ IDEA. User: knightzz98 Date: 2022/2/2 Time: 16:13 To change this template use File | Settings | File Templates. --%> <%@ page contentType="text/html;charset=UTF-8" language="java" %> <html> <head> <title>Result</title> </head> <body> <h3>${username}</h3> </body> </html>
-
我们先请求
/forward2
然后再请求/returnString2
二者显示的结果是一样的, 因为 username 是共享的数据
5. 静态资源访问开启
5.1 基本介绍
-
当有静态资源需要加载时,比如jquery文件,通过谷歌开发者工具抓包发现没有加载到jquery文件
-
原因是SpringMVC的前端控制器DispatcherServlet的url-pattern配置的是 /(缺省)
-
代表对所有的静态资源都进行处理操作,这样就不会执行Tomcat内置的DefaultServlet处理,我们可以通过以下两种方式指定放行静态资源:
5.2 存放静态资源的方法
- 在 spring-mvc.xml 中配置
5.2.1 方式一
<!--在springmvc配置文件中指定放行资源-->
<mvc:resources mapping="/js/**" location="/js/"/>
<mvc:resources mapping="/css/**" location="/css/"/>
<mvc:resources mapping="/img/**" location="/img/"/>
5.2.2 方式二
<!--在springmvc配置文件中开启DefaultServlet处理静态资源-->
<mvc:default-servlet-handler/>