image.png
SpringMVC 是一种基于 Java 的实现 MVC 设计模式的轻量级 Web 框架,属于SpringFrameWork 的后续产品,已经融合在 Spring Web Flow 中。
SpringMVC 已经成为目前最主流的MVC框架之一,并且随着Spring3.0 的发布,全面超越 Struts2, 成为最优秀的 MVC 框架。它通过一套注解,让一个简单的 Java 类成为处理请求的控制器,而无须实现任何接口。同时它还支持 RESTful 编程风格的请求。
image.png

入门案例

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

步骤分析

  1. 创建web项目,导入SpringMVC相关坐标
  2. 配置SpringMVC前端控制器 DispathcerServlet
  3. 编写Controller类和视图页面
  4. 使用注解配置Controller类中业务方法的映射地址
  5. 配置SpringMVC核心文件 spring-mvc.xml

pom

  1. <dependencies>
  2. <!--springMVC坐标-->
  3. <dependency>
  4. <groupId>org.springframework</groupId>
  5. <artifactId>spring-webmvc</artifactId>
  6. <version>5.1.5.RELEASE</version>
  7. </dependency>
  8. <!--servlet坐标-->
  9. <dependency>
  10. <groupId>javax.servlet</groupId>
  11. <artifactId>javax.servlet-api</artifactId>
  12. <version>3.1.0</version>
  13. <scope>provided</scope>
  14. </dependency>
  15. <!--jsp坐标-->
  16. <dependency>
  17. <groupId>javax.servlet.jsp</groupId>
  18. <artifactId>jsp-api</artifactId>
  19. <version>2.2</version>
  20. <scope>provided</scope>
  21. </dependency>
  22. </dependencies>

web.xml

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
  3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  4. xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
  5. version="4.0">
  6. <servlet>
  7. <servlet-name>DispatcherServlet</servlet-name>
  8. <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
  9. <init-param>
  10. <param-name>contextConfigLocation</param-name>
  11. <param-value>classpath:spring-mvc.xml</param-value>
  12. </init-param>
  13. <load-on-startup>2</load-on-startup>
  14. </servlet>
  15. <servlet-mapping>
  16. <servlet-name>DispatcherServlet</servlet-name>
  17. <!-- 这里url写细线,只能匹配到像/login /update这种,匹配不到/a.jsp这种。如果写/* 就什么都能匹配到-->
  18. <url-pattern>/</url-pattern>
  19. </servlet-mapping>
  20. </web-app>

spring-mvc.xml

  1. <beans xmlns="http://www.springframework.org/schema/beans"
  2. xmlns:mvc="http://www.springframework.org/schema/mvc"
  3. xmlns:context="http://www.springframework.org/schema/context"
  4. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  5. xsi:schemaLocation="http://www.springframework.org/schema/beans
  6. http://www.springframework.org/schema/beans/spring-beans.xsd
  7. http://www.springframework.org/schema/mvc
  8. http://www.springframework.org/schema/mvc/spring-mvc.xsd
  9. http://www.springframework.org/schema/context
  10. http://www.springframework.org/schema/context/spring-context.xsd">
  11. <context:component-scan base-package="com.ning"/>
  12. </beans>
  1. Controller
  1. @Controller
  2. public class UserController {
  3. @RequestMapping("/quick")
  4. public String quick() {
  5. System.out.println("quick running.....");
  6. return "/WEB-INF/pages/success.jsp";
  7. }
  8. }
  1. success.jsp
  1. <%@ page contentType="text/html;charset=UTF-8" language="java" %>
  2. <html>
  3. <head>
  4. <title>Success</title>
  5. </head>
  6. <body>
  7. <h3>Spring MVC!</h3>
  8. </body>
  9. </html>

Web工程执行流程

image.png

Spring MVC执行流程

image.png

  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将渲染后的视图响应响应用户。

Spring MVC组件详解

  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。一般情况下需要通过页面标签或页面模版技术将模型数据通过页面展
    示给用户,需要由程序员根据业务需求开发具体的页面。
    *笔试题:springmvc中的三大组件是什么?

2 3 5

  1. <beans xmlns="http://www.springframework.org/schema/beans"
  2. xmlns:mvc="http://www.springframework.org/schema/mvc"
  3. xmlns:context="http://www.springframework.org/schema/context"
  4. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  5. xsi:schemaLocation="http://www.springframework.org/schema/beans
  6. http://www.springframework.org/schema/beans/spring-beans.xsd
  7. http://www.springframework.org/schema/mvc
  8. http://www.springframework.org/schema/mvc/spring-mvc.xsd
  9. http://www.springframework.org/schema/context
  10. http://www.springframework.org/schema/context/spring-context.xsd">
  11. <context:component-scan base-package="com.ning"/>
  12. <!-- 配置了处理器适配器、映射器,还支持json的读写-->
  13. <mvc:annotation-driven/>
  14. <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
  15. <property name="prefix" value="/WEB-INF/pages/"></property>
  16. <property name="suffix" value=".jsp"></property>
  17. </bean>
  18. </beans>

注解解析

@Controller

SpringMVC基于Spring容器,所以在进行SpringMVC操作时,需要将Controller存储到Spring容器中,如果使用@Controller注解标注的话,就需要使用:

  1. <!--配置注解扫描-->
  2. <context:component-scan base-package="com.ning.controller"/>

@RequestMapping

  1. * 作用:
  2. 用于建立请求 URL 和处理请求方法之间的对应关系
  3. * 位置:
  4. 1.类上:请求URL的第一级访问目录。此处不写的话,就相当于应用的根目录。写的话需要以/开头。
  5. 它出现的目的是为了使我们的URL可以按照模块化管理:
  6. 用户模块
  7. /user/add
  8. /user/update
  9. /user/delete
  10. ...
  11. 账户模块
  12. /account/add
  13. /account/update
  14. /account/delete
  15. 2.方法上:请求URL的第二级访问目录,和一级目录组成一个完整的 URL 路径。
  16. * 属性:
  17. 1.value:用于指定请求的URL。它和path属性的作用是一样的
  18. 2.method:用来限定请求的方式
  19. 3.params:用来限定请求参数的条件
  20. 例如:params={"accountName"} 表示请求参数中必须有accountName
  21. prams={"money!100"} 表示请求参数中money不能是100

请求参数解析

客户端请求参数的格式是: name=value&name=value……
服务器要获取请求的参数的时候要进行类型转换,有时还需要进行数据的封装
SpringMVC可以接收如下类型的参数:
基本类型参数
对象类型参数
数组类型参数
集合类型参数

基本类型参数

Controller中的业务方法的参数名称要与请求参数的name一致,参数值会自动映射匹配。并且能自动做类型转换;自动的类型转换是指从String向其他类型的转换。

  1. <a href="${pageContext.request.contextPath}/user/simpleParam?id=1&username=杰克">
  2. 基本类型
  3. </a>
  4. @RequestMapping("/simpleParam")
  5. public String simpleParam(Integer id,String username) {
  6. System.out.println(id);
  7. System.out.println(username);
  8. return "success";
  9. }

对象类型参数

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

  1. <form action="${pageContext.request.contextPath}/user/pojoParam" method="post">
  2. 编号:<input type="text" name="id"> <br>
  3. 用户名:<input type="text" name="username"> <br>
  4. <input type="submit" value="对象类型">
  5. </form>
  1. public class User {
  2. Integer id;
  3. String username;
  4. // setter getter...
  5. }
  6. @RequestMapping("/pojoParam")
  7. public String pojoParam(User user) {
  8. System.out.println(user);
  9. return "success";
  10. }

当post请求时,数据会出现乱码,我们可以设置一个过滤器来进行编码的过滤。
可以把这一段加在web.xml里

  1. <!--配置全局过滤的filter-->
  2. <filter>
  3. <filter-name>CharacterEncodingFilter</filter-name>
  4. <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
  5. <init-param>
  6. <param-name>encoding</param-name>
  7. <param-value>UTF-8</param-value>
  8. </init-param>
  9. </filter>
  10. <filter-mapping>
  11. <filter-name>CharacterEncodingFilter</filter-name>
  12. <url-pattern>/*</url-pattern>
  13. </filter-mapping>

数组类型参数

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

  1. <form action="${pageContext.request.contextPath}/user/arrayParam">
  2. 编号:<br>
  3. <input type="checkbox" name="ids" value="1">1<br>
  4. <input type="checkbox" name="ids" value="2">2<br>
  5. <input type="checkbox" name="ids" value="3">3<br>
  6. <input type="checkbox" name="ids" value="4">4<br>
  7. <input type="checkbox" name="ids" value="5">5<br>
  8. <input type="submit" value="数组类型">
  9. </form>
  1. @RequestMapping(path = "/arrayParam")
  2. public String arrayParam(Integer[] ids) {
  3. System.out.println(Arrays.toString(ids));
  4. return "success";
  5. }

集合(复杂)类型参数

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

  1. <form action="${pageContext.request.contextPath}/user/queryParam" method="post">
  2. 搜索关键字:
  3. <input type="text" name="keyword"> <br>
  4. user对象:
  5. <input type="text" name="user.id" placeholder="编号">
  6. <input type="text" name="user.username" placeholder="姓名"><br>
  7. list集合<br>
  8. 第一个元素:
  9. <input type="text" name="userList[0].id" placeholder="编号">
  10. <input type="text" name="userList[0].username" placeholder="姓名"><br>
  11. 第二个元素:
  12. <input type="text" name="userList[1].id" placeholder="编号">
  13. <input type="text" name="userList[1].username" placeholder="姓名"><br>
  14. map集合<br>
  15. 第一个元素:
  16. <input type="text" name="userMap['u1'].id" placeholder="编号">
  17. <input type="text" name="userMap['u1'].username" placeholder="姓名"><br>
  18. 第二个元素:
  19. <input type="text" name="userMap['u2'].id" placeholder="编号">
  20. <input type="text" name="userMap['u2'].username" placeholder="姓名"><br>
  21. <input type="submit" value="复杂类型">
  22. </form>
  1. public class QueryVo {
  2. private String keyword;
  3. private User user;
  4. private List<User> userList;
  5. private Map<String, User> userMap;
  6. }
  7. @RequestMapping("/queryParam")
  8. public String queryParam(QueryVo queryVo) {
  9. System.out.println(queryVo);
  10. return "success";
  11. }

自定义类型转换器

SpringMVC 默认已经提供了一些常用的类型转换器;
例如:客户端提交的字符串转换成int型进行参数设置,日期格式类型要求为:yyyy/MM/dd 不然的话会报错,对于特有的行为,SpringMVC提供了自定义类型转换器方便开发者自定义处理。

  1. <form action="${pageContext.request.contextPath}/user/converterParam">
  2. 生日:<input type="text" name="birthday">
  3. <input type="submit" value="自定义类型转换器">
  4. </form>
  1. @RequestMapping(path = "/converterParam")
  2. public String converterParam(Date birthday) {
  3. System.out.println(birthday);
  4. return "success";
  5. }
  1. public class DateConverter implements Converter<String, Date> {
  2. public Date convert(String dateStr) {
  3. //将日期字符串转换成日期对象 返回
  4. SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd");
  5. Date date = null;
  6. try {
  7. date = format.parse(dateStr);
  8. } catch (ParseException e) {
  9. e.printStackTrace();
  10. }
  11. return date;
  12. }
  13. }
  1. <beans xmlns="http://www.springframework.org/schema/beans"
  2. xmlns:mvc="http://www.springframework.org/schema/mvc"
  3. xmlns:context="http://www.springframework.org/schema/context"
  4. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  5. xsi:schemaLocation="http://www.springframework.org/schema/beans
  6. http://www.springframework.org/schema/beans/spring-beans.xsd
  7. http://www.springframework.org/schema/mvc
  8. http://www.springframework.org/schema/mvc/spring-mvc.xsd
  9. http://www.springframework.org/schema/context
  10. http://www.springframework.org/schema/context/spring-context.xsd">
  11. <context:component-scan base-package="com.ning"/>
  12. <!-- 配置了处理器适配器、映射器,还支持json的读写-->
  13. <!-- conversion service是让日期转换器生效-->
  14. <mvc:annotation-driven conversion-service="conversionServiceFactoryBean"/>
  15. <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
  16. <property name="prefix" value="/WEB-INF/pages/"></property>
  17. <property name="suffix" value=".jsp"></property>
  18. </bean>
  19. <!-- 自定义日期转换器-->
  20. <bean id="conversionServiceFactoryBean" class="org.springframework.context.support.ConversionServiceFactoryBean">
  21. <property name="converters">
  22. <set>
  23. <bean class="com.ning.converter.DateConverter"/>
  24. </set>
  25. </property>
  26. </bean>
  27. </beans>

其他注解

@RequestParam

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

  1. <a href="${pageContext.request.contextPath}/user/findByPage?pageNo=2">
  2. 分页查询
  3. </a>
  1. /*
  2. @RequestParam() 注解
  3. defaultValue 设置参数默认值
  4. name 匹配页面传递参数的名称
  5. required 设置是否必须传递参数,默认值为true;如果设置了默认值,值自动改为false
  6. */
  7. @RequestMapping("/findByPage")
  8. public String findByPage(@RequestParam(name = "pageNo", defaultValue = "1")
  9. Integer pageNum, @RequestParam(defaultValue = "5") Integer pageSize) {
  10. System.out.println(pageNum);
  11. System.out.println(pageSize);
  12. return "success";
  13. }

@RequestHeader

获取请求头的数据。

  1. @RequestMapping("/requestHead")
  2. public String requestHead(@RequestHeader("cookie") String cookie) {
  3. System.out.println(cookie);
  4. return "success";
  5. }

@CookieValue

获取Cookie中的值

  1. @RequestMapping("/cookieValue")
  2. public String cookieValue(@CookieValue("JSESSIONID") String jesessionId) {
  3. System.out.println(jesessionId);
  4. return "success";
  5. }

获取Servlet API

  1. @RequestMapping("/servletAPI")
  2. public String servletAPI(HttpServletRequest request, HttpServletResponse
  3. response, HttpSession session) {
  4. System.out.println(request);
  5. System.out.println(response);
  6. System.out.println(session);
  7. return "success";
  8. }

SpringMVC的响应

页面跳转

  1. 返回字符串逻辑视图
  2. void原始ServletAPI
  3. ModelAndView

返回数据

  1. 直接返回字符串数据
  2. 将对象或集合转为json返回
  1. //返回逻辑视图 会在配置文件里拼接前缀和后缀
  2. @RequestMapping("/returnString")
  3. public String returnString() {
  4. return "success";
  5. }
  1. @RequestMapping("/returnVoid")
  2. public void returnVoid(HttpServletRequest request, HttpServletResponse response)
  3. throws Exception {
  4. // 1.通过response直接响应数据
  5. response.setContentType("text/html;charset=utf-8");
  6. response.getWriter().write("拉勾网");
  7. ----------------------------------------
  8. request.setAttribute("username", "拉勾教育");
  9. // 2.通过request实现转发
  10. request.getRequestDispatcher("/WEB-INF/pages/success.jsp").forward(request,
  11. response);
  12. ----------------------------------------
  13. // 3.通过response实现重定向
  14. response.sendRedirect(request.getContextPath() + "/index.jsp");
  15. }

ModelAndView

方式一

在Controller中方法创建并返回ModelAndView对象,并且设置视图名称

  1. @RequestMapping("/returnModelAndView1")
  2. public ModelAndView returnModelAndView1() {
  3. /*
  4. Model:模型 作用封装数据
  5. View:视图 作用展示数据
  6. */
  7. ModelAndView modelAndView = new ModelAndView();
  8. //设置模型数据
  9. modelAndView.addObject("username", " lagou");
  10. //设置视图名称 会去找/WEB-INF/pages/success.jsp
  11. //写了forward或者redirect就不会去走视图解析器了。
  12. modelAndView.setViewName("success");
  13. return modelAndView;
  14. }

方式二

在Controller中方法形参上直接声明ModelAndView,无需在方法中自己创建,在方法中直接使用该对象设置视图,同样可以跳转页面

  1. @RequestMapping("/returnModelAndView2")
  2. public ModelAndView returnModelAndView2(ModelAndView modelAndView) {
  3. //设置模型数据
  4. modelAndView.addObject("username", "itheima");
  5. //设置视图名称
  6. modelAndView.setViewName("success");
  7. return modelAndView;
  8. }

转发和重定向

企业开发我们一般使用返回字符串逻辑视图实现页面的跳转,这种方式其实就是请求转发。
我们也可以写成:forward转发 如果用了forward:则路径必须写成实际视图url,不能写逻辑视图。
它相当于:

  1. request.getRequestDispatcher("url").forward(request,response)

使用请求转发,既可以转发到jsp,也可以转发到其他的控制器方法。

  1. @RequestMapping("/forward")
  2. public String forward(Model model) {
  3. model.addAttribute("username", "拉勾招聘");
  4. return "forward:/WEB-INF/pages/success.jsp";
  5. }

Redirect重定向

我们可以不写虚拟目录,springMVC框架会自动拼接,并且将Model中的数据拼接到url地址上

  1. @RequestMapping("/redirect")
  2. public String redirect(Model model) {
  3. //底层使用的还是request.setAttribute() 所以不好用
  4. model.addAttribute("username", "拉勾教育");
  5. return "redirect:/index.jsp";
  6. }

@SessionAttributes

如果在多个请求之间共用数据,则可以在控制器类上标注一个 @SessionAttributes,配置需要在 session中存放的数据范围,Spring MVC将存放在model中对应的数据暂存到 HttpSession中。

  1. @Controller
  2. @SessionAttributes("username") //向request域存入的key为username时,同步到session域中
  3. public class UserController {
  4. @RequestMapping("/forward")
  5. public String forward(Model model) {
  6. model.addAttribute("username", "子慕");
  7. return "forward:/WEB-INF/pages/success.jsp";
  8. }
  9. @RequestMapping("/returnString")
  10. public String returnString() {
  11. return "success";
  12. }
  13. }

静态资源访问的开启

当有静态资源需要加载时,比如jquery文件,通过谷歌开发者工具抓包发现,没有加载到jquery文 件,原因是SpringMVC的前端控制器DispatcherServlet的url-pattern配置的是 /(缺省),代表对所有的 静态资源都进行处理操作,这样就不会执行Tomcat内置的DefaultServlet处理,我们可以通过以下两种 方式指定放行静态资源:

方式一

  1. <!--在springmvc配置文件中指定放行资源-->
  2. <mvc:resources mapping="/js/**" location="/js/"/>
  3. <mvc:resources mapping="/css/**" location="/css/"/>
  4. <mvc:resources mapping="/img/**" location="/img/"/>

方式二

  1. <!--在springmvc配置文件中开启DefaultServlet处理静态资源-->
  2. <mvc:default-servlet-handler/>

Ajax异步交互

Springmvc默认用MappingJackson2HttpMessageConverter对json数据进行转换,需要加入 jackson的包;同时使用

  1. <mvc:annotation-driven />
  1. <dependency>
  2. <groupId>com.fasterxml.jackson.core</groupId>
  3. <artifactId>jackson-databind</artifactId>
  4. <version>2.9.8</version>
  5. </dependency>
  6. <dependency>
  7. <groupId>com.fasterxml.jackson.core</groupId>
  8. <artifactId>jackson-core</artifactId>
  9. <version>2.9.8</version>
  10. </dependency>
  11. <dependency>
  12. <groupId>com.fasterxml.jackson.core</groupId>
  13. <artifactId>jackson-annotations</artifactId>
  14. <version>2.9.0</version>
  15. </dependency>
  1. 写个jsp
  1. <%@ page contentType="text/html;charset=UTF-8" language="java" %>
  2. <html>
  3. <head>
  4. <title>ajax</title>
  5. </head>
  6. <body>
  7. <script src="${pageContext.request.contextPath}/js/jquery-3.5.1.js"/>
  8. <button id="btn1">ajax异步提交</button>
  9. <script>
  10. $("btn1").click(function (){
  11. let url = '${pageContext.request.contextPath}/user/ajaxRequest';
  12. let data = '[{"id":1, "username":"张三"},{"id":2, "username":"李四"}]';
  13. $.ajax({
  14. type: 'POST',
  15. url: url,
  16. data: data,
  17. contentType: 'application/json;charset=utf-8',
  18. success: function (resp) {
  19. alert(resp);
  20. }
  21. });
  22. });
  23. </script>
  24. </body>
  25. </html>

@RequestBody

该注解用于Controller的方法的形参声明,当使用ajax提交并指定contentType为json形式时,通过 HttpMessageConverter接口转换为对应的entity对象。

  1. @RequestMapping("/ajaxRequest")
  2. public void ajaxRequest(@RequestBody List<User> list) {
  3. System.out.println(list);
  4. }

注意这个注解只能有一个,如果不想用VO对象,就要用Map。

@ResponseBody

该注解用于将Controller的方法返回的对象,通过HttpMessageConverter接口转换为指定格式的数 据如:json,xml等,通过Response响应给客户端。

  1. @RequestMapping("/ajaxRequest")
  2. @ResponseBody
  3. public List<User> ajaxRequest(@RequestBody List<User> list) {
  4. System.out.println(list);
  5. return list;
  6. }

REST ful

Restful是一种软件架构风格、设计风格,而不是标准,只是提供了一组设计原则和约束条件。
主要用于客户端和服务器交互类的软件,基于这个风格设计的软件可以更简洁,更有层次,更易于实现缓存机制等。 Restful风格的请求是使用“url+请求方式”表示一次请求目的的,HTTP 协议里面四个表示操作方式的动词如下:
GET:读取(Read) POST:新建(Create) PUT:更新(Update) DELETE:删除(Delete)
image.png

代码实现

@PathVariable 用来接收RESTful风格请求地址中占位符的值
@RestController RESTful风格多用于前后端分离项目开发,前端通过ajax与服务器进行异步交互,我们处理器通常返回的是json数据所以使用@RestController来替代@Controller和@ResponseBody两个注解。

  1. // @Controller
  2. @RestController
  3. public class RestFulController {
  4. @GetMapping(value = "/user/{id}")
  5. // 相当于 @RequestMapping(value = "/user/{id}",method = RequestMethod.GET)
  6. // @ResponseBody
  7. public String get(@PathVariable Integer id) {
  8. return "get:" + id;
  9. }
  10. @PostMapping(value = "/user")
  11. // @ResponseBody
  12. public String post() {
  13. return "post";
  14. }
  15. @PutMapping(value = "/user")
  16. // @ResponseBody
  17. public String put() {
  18. return "put";
  19. }
  20. @DeleteMapping(value = "/user/{id}")
  21. // @ResponseBody
  22. public String delete(@PathVariable Integer id) {
  23. return "delete:"+ id;
  24. }
  25. }

文件上传

三要素

表单项 type=”file”
表单的提交方式 method=”POST”
表单的enctype属性是多部分表单形式 enctype=”multipart/form-data”

原理

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

实例(单文件上传)

  1. <dependency>
  2. <groupId>commons-fileupload</groupId>
  3. <artifactId>commons-fileupload</artifactId>
  4. <version>1.3.3</version>
  5. </dependency>
  6. <dependency>
  7. <groupId>commons-io</groupId>
  8. <artifactId>commons-io</artifactId>
  9. <version>2.6</version>
  10. </dependency>
  1. 配置解析器
  1. <!--文件上传解析器-->
  2. <bean id="multipartResolver"
  3. class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
  4. <!-- 设定文件上传的最大值为5MB,5*1024*1024 -->
  5. <property name="maxUploadSize" value="5242880"></property>
  6. <!-- 设定文件上传时写入内存的最大值,如果小于这个参数不会生成临时文件,默认为10240 -->
  7. <property name="maxInMemorySize" value="40960"></property>
  8. </bean>
  1. 编码
  1. <form action="${pageContext.request.contextPath}/fileUpload" method="post"
  2. enctype="multipart/form-data">
  3. 名称:<input type="text" name="username"> <br>
  4. 文件:<input type="file" name="filePic"> <br>
  5. <input type="submit" value="单文件上传">
  6. </form>

记得提前创建好文件夹

  1. @RequestMapping("/fileUpload")
  2. public String fileUpload(String username, MultipartFile filePic) throws
  3. IOException {
  4. System.out.println(username);
  5. // 获取文件名
  6. String originalFilename = filePic.getOriginalFilename();
  7. //保存文件
  8. filePic.transferTo(new File("d:/upload/"+originalFilename));
  9. return "success";
  10. }

多文件上传

  1. <form action="${pageContext.request.contextPath}/filesUpload" method="post"
  2. enctype="multipart/form-data">
  3. 名称:<input type="text" name="username"> <br>
  4. 文件1:<input type="file" name="filePic"> <br>
  5. 文件2:<input type="file" name="filePic"> <br>
  6. <input type="submit" value="多文件上传">
  7. </form>
  1. @RequestMapping("/filesUpload")
  2. public String filesUpload(String username, MultipartFile[] filePic) throws
  3. IOException {
  4. System.out.println(username);
  5. for (MultipartFile multipartFile : filePic) {
  6. // 获取文件名
  7. String originalFilename = multipartFile.getOriginalFilename();
  8. // 保存到服务器
  9. multipartFile.transferTo(new File("d:/upload/" + originalFilename));
  10. }
  11. return "success";
  12. }

异常处理

在Java中,对于异常的处理一般有两种方式:
一种是当前方法捕获处理(try-catch),这种处理方式会造成业务代码和异常处理代码的耦合。
另一种是自己不处理,而是抛给调用者处理(throws),调用者再抛给它的调用者,也就是一直向上抛。

在第二种方法的基础上,衍生出了SpringMVC的异常处理机制。 系统的dao、service、controller出现都通过throws Exception向上抛出,最后由springmvc前端控 制器交由异常处理器进行异常处理,如下图:
image.png

自定义异常处理器

  1. 创建异常处理器类实现HandlerExceptionResolver
  2. 配置异常处理器
  3. 编写异常页面
  4. 测试异常跳转
  1. @Component
  2. public class GlobalExceptionResolver implements HandlerExceptionResolver {
  3. @Override
  4. public ModelAndView resolveException(HttpServletRequest request,
  5. HttpServletResponse response, Object handler, Exception ex) {
  6. ModelAndView modelAndView = new ModelAndView();
  7. modelAndView.addObject("error", ex.getMessage());
  8. modelAndView.setViewName("error");
  9. return modelAndView;
  10. }
  11. }
  1. <bean id="globalExecptionResovler"
  2. class="com.ning.exception.GlobalExecptionResovler"></bean>
  1. <%@ page contentType="text/html;charset=UTF-8" language="java" %>
  2. <html>
  3. <head>
  4. <title>error</title>
  5. </head>
  6. <body>
  7. 出错啦!联系管理员!
  8. ${error}
  9. </body>
  10. </html>
  1. <br />最后做个测试方法即可
  1. @RequestMapping("/testException")
  2. public String testException() {
  3. int i = 1 / 0;
  4. return "success";
  5. }

Web异常处理机制

在web.xml里可以配置错误页面。这样404和500都可以处理的很好了。

  1. <!--处理500异常-->
  2. <error-page>
  3. <error-code>500</error-code>
  4. <location>/500.jsp</location>
  5. </error-page>
  6. <!--处理404异常-->
  7. <error-page>
  8. <error-code>404</error-code>
  9. <location>/404.jsp</location>
  10. </error-page>

拦截器

Spring MVC 的拦截器类似于 Servlet 开发中的过滤器 Filter,用于对处理器进行预处理和后处理。
将拦截器按一定的顺序联结成一条链,这条链称为拦截器链(InterceptorChain)。在访问被拦截的方法或字段时,拦截器链中的拦截器就会按其之前定义的顺序被调用。拦截器也是AOP思想的具体实现。

与filter的区别

image.png

快速上手

  1. 创建拦截器类实现HandlerInterceptor接口
  2. 配置拦截器
  3. 测试拦截器的拦截效果
  1. public class MyInterceptor1 implements HandlerInterceptor {
  2. @Override
  3. public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
  4. System.out.println("preHandler");
  5. //返回false不放行
  6. return true;
  7. }
  8. //目标方法执行后,视图方法执行之前
  9. @Override
  10. public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
  11. System.out.println("postHandler");
  12. }
  13. @Override
  14. public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
  15. System.out.println("afterHandler");
  16. }
  17. }
  1. <!--配置拦截器-->
  2. <mvc:interceptors>
  3. <mvc:interceptor>
  4. <!--对哪些资源执行拦截操作-->
  5. <mvc:mapping path="/**"/>
  6. <bean class="com.lagou.interceptor.MyInterceptor1"/>
  7. </mvc:interceptor>
  8. </mvc:interceptors>
  1. @Controller
  2. public class TargetController {
  3. @RequestMapping("/target")
  4. public String targetMethod() {
  5. System.out.println("目标方法执行了...");
  6. return "success";
  7. }
  8. }
  1. <%@ page contentType="text/html;charset=UTF-8" language="java" %>
  2. <html>
  3. <head>
  4. <title>success</title>
  5. </head>
  6. <body>
  7. <h3>success...</h3>
  8. <% System.out.println("视图执行了....");%>
  9. </body>
  10. </html>

最后结果
image.png

拦截器链

开发中拦截器可以单独使用,也可以同时使用多个拦截器形成一条拦截器链。
开发步骤和单个拦截器是一样的,只不过注册的时候注册多个,注意这里注册的顺序就代表拦截器执行的顺序。
同上,再编写一个MyHandlerInterceptor2操作,测试执行顺序:

  1. <mvc:interceptors>
  2. <mvc:interceptor>
  3. <!--拦截器路径配置-->
  4. <mvc:mapping path="/**"/>
  5. <!--自定义拦截器类-->
  6. <bean class="com.ning.interceptor.MyInterceptor1"></bean>
  7. </mvc:interceptor>
  8. <mvc:interceptor>
  9. <!--拦截器路径配置-->
  10. <mvc:mapping path="/**"/>
  11. <!--自定义拦截器类-->
  12. <bean class="com.ning.interceptor.MyInterceptor2"></bean>
  13. </mvc:interceptor>
  14. </mvc:interceptors>

image.png