Spring mvc 框架

• DispatcherServlet

  前端控制器 ---- 整个流程控制的中心，由它调用其它组件处理用户的请求

• 三大组件

  • HandlerMapping

    处理器映射器 ---- 根据用户请求url找到处理器(Handler)，springmvc提供了不同的映射器实现不同的映射方式，例如：配置文件方式，实现接口方式，注解方式等

  • HandlAdapter

    处理器适配器 ---- 通过HandlerAdapter对处理器进行执行，通过扩展适配器可以对更多类型的处理器进行执行

  • ViewResolver

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

• Handler

  处理器 ---- 继DispatcherServlet前端控制器的后端控制器，在DispatcherServlet的控制下Handler对具体的用户请求进行处理

  默认支持的参数类型

  • HttpServletRequest

    通过request对象获取请求信息

  • HttpServletResponse

    通过response处理响应信息

  • HttpSession

    通过session对象得到session中存放的对象

• View

  视图 ---- springmvc框架提供了很多的View视图类型的支持，包括：jstlView、freemarkerView、pdfView等。我们最常用的视图就是jsp

  视图对象

  • ModelAndView

  • Model

    Model是一个接口，在参数里直接声明model即可,Model对象可以向页面传递数据，View对象则可以使用String返回值替代

  • ModelMap

    ModelMap是Model接口的实现类，也可以通过ModelMap向页面传递数据,使用Model和ModelMap的效果一样，如果直接使用Model，springmvc会实例化ModelMap

配置

• web.xml

  <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_3_1.xsd"
           version="3.1">
      <!-- 指定Spring 配置文件位置 -->
      <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>
      <!--spring mvc 前端控制器-->
      <servlet>
          <servlet-name>dispatcherServlet</servlet-name>
          <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
          <!-- spring MVC配置文件 -->
          <init-param>
              <param-name>contextConfigLocation</param-name>
              <param-value>classpath:dispatcher-servlet.xml</param-value>
          </init-param>
          <load-on-startup>1</load-on-startup>
      </servlet>
      <servlet-mapping>
          <servlet-name>dispatcherServlet</servlet-name>
          <!-- /* 拦截所有jsp js png css 全部拦截 -->
          <!-- *.action *.do 拦截已action,do结尾的请求 -->
          <!-- /* 拦截所有(不包含jsp)(包含js png css) -->
          <url-pattern>*.do</url-pattern>
      </servlet-mapping>
  </web-app>
  

• dispatcher-servlet.xml

  <!-- 组件扫描器，自动扫描注解组件 -->
  <!-- 配置扫描包，多个包之间用,分隔 -->
  <context:component-scan base-package="com.lirui.springmvc"/>
  
  <!-- 处理器映射器 -->
  <!--<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping"/>-->
  <!-- 处理器适配器 -->
  <!--<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter"/>-->
  
  <!-- 注解驱动,代替以上两种方式 -->
  <mvc:annotation-driven />
  
  <!-- 视图解析器 -->
  <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
      <!-- 配置逻辑视图的前缀 -->
      <property name="prefix" value="/WEB-INF/jsp/"/>
      <!-- 配置逻辑视图的后缀 -->
      <property name="suffix" value=".jsp"/>
      <!-- 前缀+逻辑视图名+后缀 -->
  </bean>
  

• 定义controller

  @Controller
  public class Test1Controller {
      @RequestMapping("/test1")
      public ModelAndView getList() {
          ModelAndView mav = new ModelAndView();
          mav.addObject("key", request域中的数据);
          mav.setViewName("视图路径");
          return mav;
      }
  

Handler支持的参数类型

• 默认支持的参数类型

  • HttpServletRequest

    通过request对象获取请求信息

  • HttpServletResponse

    通过response处理响应信息

  • HttpSession

    通过session对象得到session中存放的对象

• 绑定简单类型

  当请求的参数名称和处理器形参名称一致时会将请求参数与形参进行绑定,可以使用@RequestParam处理简单类型的绑定

  @RequestParam(value = "name",required = true,defaultValue = "value")

  ​ value:参数名称,即入参的请求参数名字

  ​ required :是否必须，默认是true，表示请求中一定要有相应的参数，否则将报错

  ​ defaultValue :默认值

• 绑定pojo对象

  如果提交的参数很多，或者提交的表单中的内容很多的时候,可以使用简单类型接受数据,也可以使用pojo接收数据。pojo对象中的属性名和表单中input的name属性一致

• 绑定包装pojo对象

• 自定义参数绑定

  实现参数格式的修改，例如由于日期数据有很多种格式，springmvc没办法把字符串转换成日期类型。所以需要自定义参数绑定

  • 自定义Converter

    实现Converter接口

  • 配置

    方式一

    <!-- 配置注解驱动 -->
    <!-- 如果配置此标签,可以不用配置... -->
    <mvc:annotation-driven conversion-service="conversionService" />
    
    <!-- 转换器配置 -->
    <bean id="conversionService" class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
        <property name="converters">
            <set>
                <bean class="cn.itcast.springmvc.converter.DateConverter" />
            </set>
        </property>
    </bean>
    

    方式二

    <!--注解适配器 -->
    <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
        <property name="webBindingInitializer" ref="customBinder"></property>
    </bean>
    
    <!-- 自定义webBinder -->
    <bean id="customBinder" class="org.springframework.web.bind.support.ConfigurableWebBindingInitializer">
        <property name="conversionService" ref="conversionService" />
    </bean>
    
    <!-- 转换器配置 -->
    <bean id="conversionService" class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
        <property name="converters">
            <set>
                <bean class="cn.itcast.springmvc.convert.DateConverter" />
            </set>
        </property>
    </bean>
    //此方法需要独立配置处理器映射器、适配器，不再使用<mvc:annotation-driven/>
    

• 高级参数绑定

  • 数组

    提交的数组，可以直接使用数组接收，或者pojo的数组属性接收。两种方式任选其一即可

  • list

    jsp页面name属性必须是list属性名+下标+元素属性

    接收List类型的数据必须是pojo的属性，如果方法的形参为ArrayList类型无法正确接收到数据

@RequestMapping()注解

• URL路径映射

  @RequestMapping(value="xxx")或@RequestMapping("/xxx"),value的值是数组，可以将多个url映射到同一个方法,例如：@RequestMapping(value = { "xxx", "xxxx" })

• 添加在类上面

  在class上添加@RequestMapping(url)指定通用请求前缀， 限制此类下的所有方法请求url必须以请求前缀开头

• 请求方法限定

  限定GET方法：@RequestMapping(method =RequestMethod.GET)

  限定POST方法：@RequestMapping(method =RequestMethod.POST)

  GET和POST都可以：@RequestMapping(method = {RequestMethod.GET,RequestMethod.POST})

Controller方法返回值

• ModelAndView

  controller方法中定义ModelAndView对象并返回，对象中可添加model数据、指定view

• Void

  在Controller方法形参上可以定义request和response，使用request或response指定响应结果

  • 使用request转发页面

    request.getRequestDispatcher("页面路径").forward(request,response);

  • 可以通过response页面重定向：

    response.sendRedirect("url")

  • 可以通过response指定响应结果，例如响应json数据如下：

    response.getWriter().print("{\"abc\":123}");

• String

  controller方法返回字符串可以指定逻辑视图名，通过视图解析器解析为物理视图地址

  • Redirect重定向

    return "redirect:xxx"

  • forward转发

    return "forward:xxx"

异常处理

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

​ 系统的dao、service、controller出现都通过throws Exception向上抛出，最后由springmvc前端控制器交由异常处理器(HandlerExceptionResolver)进行异常处理。

• 自定义异常处理器

  实现接口HandlerExceptionResolver

  public class CustomHandlerExceptionResolver implements HandlerExceptionResolver {
      @Nullable
      @Override
      public ModelAndView resolveException(HttpServletRequest httpServletRequest,                   HttpServletResponse httpServletResponse, @Nullable Object o, Exception e) {
          String msg;
          if (e instanceof CustomException) {
              msg = ((CustomException) e).getMsg();
          } else {
              msg = e.getMessage();
          }
          ModelAndView mav = new ModelAndView();
          mav.addObject("error", msg);
          mav.setViewName("error");
          return mav;
      }
  }
  

• 配置

  //dispatcher-servlet.xml文件
  <!-- 配置异常处理器 -->
  <bean class="com.lirui.springmvc.exeception.CustomHandlerExceptionResolver"/>
  

上传图片

• 配置虚拟目录

  在tomcat上配置图片虚拟目录，在tomcat下conf/server.xml中添加：

  <Context docBase="D:\develop\upload\temp"path="/pic" reloadable="false"/>

  访问http://localhost:8080/pic即可访问D:\develop\upload\temp下的图片。也可以通过

  eclipse配置

• 加入jar文件

  commons-fileupload.jar commons-io.jar

• 修改jsp页面，添加enctype="multipart/form-data"

• 采用参数MultipartFile pictureFile接收文件，pictureFile名称与jsp文件上传控件name名称一致

  String fileName = UUID.randomUUID().toString().replace("-", "");
  String pictureName = pictureFile.getOriginalFilename();
  String type = FilenameUtils.getExtension(pictureName);
  fileName = fileName + "." + type;
  pictureFile.transferTo(new File("E:\\Learn\\pic\\" + fileName));
  

• 配置文件上传解析器

  //dispatcher-servlet.xml
  <!-- 文件上传,id必须设置为multipartResolver -->
  <bean id="multipartResolver"
        class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
      <!-- 设置文件上传大小 -->
      <property name="maxUploadSize" value="5000000" />
  </bean>
  

Json解析

• 注解

  @RequestBody ---- 用于读取http请求的内容(字符串)，通过springmvc提供的HttpMessageConverter接口将读到的内容（json数据）转换为java对象并绑定到Controller方法的参数上

  @ResponseBody ---- 用于将Controller的方法返回的对象，通过springmvc提供HttpMessageConverter接口转换为指定格式的数据如：json,xml等，通过Response响应给客户端

• 添加json解析器

  如果不使用注解驱动<mvc:annotation-driven/>，就需要给处理器适配器配置json转换器

  在springmvc.xml配置文件中，给处理器适配器加入json转换器：

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

RESTful支持

使用注解@RequestMapping("item/{id}")声明请求的url,{xxx}叫做占位符，请求的URL可以是“item /1”或“item/2”

使用(@PathVariable() Integer id)获取url上的数据

如果@RequestMapping中表示为"item/{id}"，id和形参名称一致，@PathVariable不用指定名称。如果不一致，例如"item/{ItemId}"则需要指定名称@PathVariable("itemId")。

1. @PathVariable是获取url上数据的。@RequestParam获取请求参数的(包括post表单提交)

1. 如果加上@ResponseBody注解，就不会走视图解析器，不会返回页面，目前返回的json数据。如果不加，就走视图解析器，返回页面

拦截器

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

• 拦截器定义(实现HandlerInterceptor接口)

  public class HandlerInterceptor1 implements HandlerInterceptor {
    // controller执行后且视图返回后调用此方法
    // 这里可得到执行controller时的异常信息
    // 这里可记录操作日志
    @Override
    public void afterCompletion(HttpServletRequest arg0, HttpServletResponse arg1, Object           arg2, Exception arg3) throws Exception {}
  
    // controller执行后但未返回视图前调用此方法
    // 这里可在返回用户前对模型数据进行加工处理，比如这里加入公用信息以便页面显示
    @Override
    public void postHandle(HttpServletRequest arg0, HttpServletResponse arg1, Object arg2,          ModelAndView arg3) throws Exception {}
  
    // Controller执行前调用此方法
    // 返回true表示继续执行，返回false中止执行
    // 这里可以加入登录校验、权限拦截等
    @Override
    public boolean preHandle(HttpServletRequest arg0, HttpServletResponse arg1, Object arg2)        throws Exception {
            return true;
        }
  }
  
  

  ​

• 拦截器配置

  <!-- 配置拦截器 -->
  <mvc:interceptors>
    <mvc:interceptor>
        <!-- 所有的请求都进入拦截器 -->
        <mvc:mapping path="/**" />
        <!-- 配置具体的拦截器 -->
        <bean class="xxx" />
    </mvc:interceptor>
    <mvc:interceptor>
        <!-- 所有的请求都进入拦截器 -->
        <mvc:mapping path="/**" />
        <!-- 配置具体的拦截器 -->
        <bean class="xxx" />
    </mvc:interceptor>
  </mvc:interceptors>
  

• 拦截器处理流程

  preHandle按拦截器定义顺序调用

  postHandler按拦截器定义逆序调用

  afterCompletion按拦截器定义逆序调用

  ​

  postHandler在拦截器链内所有拦截器返成功调用

  afterCompletion只有preHandle返回true才调用

springmvc与struts2不同

• springmvc的入口是一个servlet即前端控制器，而struts2入口是一个filter过滤器。
• springmvc是基于方法开发(一个url对应一个方法)，请求参数传递到方法的形参，可以设计为单例或多例(建议单例)，struts2是基于类开发，传递参数是通过类的属性，只能设计为多例。
• Struts采用值栈存储请求和响应的数据，通过OGNL存取数据， springmvc通过参数解析器是将request请求内容解析，并给方法形参赋值，将数据和视图封装成ModelAndView对象，最后又将ModelAndView中的模型数据通过request域传输到页面。Jsp视图解析器默认使用jstl