05、spring

     

Spring MVC

1. Spring MVC 概述 1-2

1.1. 企业级应用基本架构 1-2

1.2. Web MVC架构及分析 1-3

1.3. Spring MVC 架构及分析 1-4

2. Spring MVC 编程基础 2-5

2.1. 编程基本步骤 2-5

2.2. 基于xml编程实现 2-5

2.2.1. 创建Maven WEB 项目 2-5

2.2.2. 添加Spring MVC 项目依赖及配置文件 2-5

2.2.3. 配置前端控制器 2-7

2.2.4. 创建后端控制器 2-7

2.2.5. 创建JSP页面 2-8

2.2.6. 配置后端控制及视图解析 2-8

2.2.7. 部署到tomcat运行 2-9

2.2.8. 运行原理分析 2-9

2.3. 基于注解编程实现 2-10

2.3.1. 创建Maven WEB 项目 2-10

2.3.2. 添加Spring MVC 项目依赖及配置文件 2-10

2.3.3. 配置前端控制器 2-11

2.3.4. 创建后端控制器 2-12

2.3.5. 配置组件扫描与视图解析 2-12

2.3.6. 部署与运行 2-12

3. Spring MVC 编程请求处理进阶 3-13

3.1. 请求路径映射 3-13

3.1.1. 普通url映射 3-13

3.1.2. Rest风格url映射 3-13

3.2. 请求方式映射 3-14

3.2.1. 请求方式限定 3-14

3.2.2. 请求方式组合 3-14

3.3. 请求参数映射(重点) 3-14

3.3.1. 标准Servlet API 3-14

3.3.2. 直接量存储 3-15

3.3.3. Java bean对象 3-15

3.3.4. Rest url数据 3-16

3.3.5. 请求头数据 3-16

4. Spring MVC 响应处理进阶 4-17

4.1. 响应数据封装 4-17

4.1.1. ModelAndView 对象 4-17

4.1.2. Model对象 4-17

4.1.3. Map对象 4-18

4.2. 响应数据转换JSON 4-18

4.2.1. JSON 应用概述 4-18

4.2.2. 客户端JSON数据操作 4-19

4.2.3. JAVA端JSON数据操作 4-19

4.2.4. Spring 集成jackson库 4-23

4.2.5. Spring 集成fastjson库 4-24

5. Spring 拦截器应用 5-25

5.1. 拦截器概述 5-25

5.2. 拦截器编写及配置 5-26

6. Spring MVC异常处理 6-28

6.1. Spring MVC 异常概述 6-28

6.2. Spring MVC 异常处理 6-29

7. 总结 7-29

7.1. 重点和难点分析 7-29

7.2. 常见FAQ 7-30

7.3. 作业 7-30

1. Spring MVC 概述

　　1.1. 企业级应用基本架构

　　　　企业级应用基本架构（C/S）以及SPRING在架构中的作用。

　　　　此架构图中spring要解决什么问题？

　　　　　　1） 对象的构建，对象的依赖管理。(重点是从资源使用角度进行分析)

　　　　　　2） 扩展业务的动态切入。（基于OCP更好实现功能扩展，同时进行解耦）

　　　　　　3） 简化传统web mvc架构中的一些细节处理问题（参数获取，校验，值的注入，响应方式及数据格式的转换）。

　　　　问题：

　　　　　　1）我们一般说的解耦是没有耦合吗？不是，所有软件系统中的对象之间都会存在耦合，只是要把耦合降低。

　　　　　　2） 降低耦合的最主要目的是什么？就是要提高系统的可维护性，便于系统进行更好的升级扩展。

　　　　　　3） 降低耦合的主要实现方式？

　　　　　　3.1）对象之间的耦合尽量耦合与接口与工厂

　　　　　　3.2）代码的重用尽量使用组合而非继承。（has a 取代 is a）

　　1.2. Web MVC架构及分析

　　　　　　基于servlet，jsp，javabean技术实现的MVC架构

　　　　 

 　　　　问题：

　　　　　　1） 假如我们没有使用spring mvc，你如何对系统采用mvc思想进行分层？（参考jsp+servlet+javabean奇数）

 　　　　　　2） 传统的web mvc 编程架构中有什么优势，劣势？

　　　　　　　　优势：结构层次更加清晰，可读性，可维护性相对较好

　　　　　　　　劣势：参数获取，类型转换，流程调用相对都比较复杂

 　　　　　　3）市场上相对比较成熟的mvc框架：spring mvc，struts2，….

　　1.3. Spring MVC 架构及分析

 　　　　　　Spring MVC是MVC架构模式的一种完美实现，它简化了Java WEB 中基于MVC架构的编程过程，是Spring中的WEB应用模块。其官方MVC概要架构图如下：

 　　　　

　　　　Spring MVC 底层核心架构图及工作流程（先了解，写完项目案例再重点强化）

 

　　Spring MVC 中的核心组件：

　　　　1) DispatcherServlet （前端控制器, 处理请求的入口）

　　　　2) HandlerMapping （映射器对象, 用于管理url与对应controller的映射关系）

　　　　3) Controller （后端控制器, 负责处理请求的控制逻辑）

　　　　4) ModelAndView （模型, 封装业务处理结果和视图）

　　　　5) ViewResolver（视图解析器,解析对应的视图关系：前缀+view+后缀）

 

　　　　备注：假如希望了解Spring MVC的详细处理流程可以基于断点调试法进行跟踪。

2. Spring MVC 编程基础

　　2.1. 编程基本步骤

　　　　Step01：创建maven web 项目并解决项目中的错误问题

　　　　Step02：添加项目依赖（spring-webmvc）及spring核心配置文件

　　　　Step03：配置前端控制器DispatcherServlet（web.xml）

　　　　Step04：创建后端控制器（Controller）及页面

　　　　Step05：spring配置文件中配置核心应用组件

　　　　Step06：部署及测试springmvc 应用。

　　2.2. 基于xml编程实现

　　　　2.2.1. 创建Maven WEB 项目

　　　　　　Web项目打包方式为war方式

　　　　　　Web项目的target runtimes为tomcat

　　　　　　Web 项目的编译版本为JDK1.8

　　　　可能会遇到的问题：

　　　　　　1） war项目默认不会创建web.xml(需要自己生成)

　　　　　　2） 项目创建好需要设置运行时环境tomcat(多个tomcat时选哪个)

　　　　　　3） 统一编译版本(版本不统一很有可能会出现项目不编译)

　　　　　　4） 统一编码(UTF-8)

　　　　　　5） 假如创建的项目还有问题，可对项目进行clean操作

2.2.2. 添加Spring MVC 项目依赖及配置文件

打开项目的pom.xml文件，然后添加依赖（选择组groupId为org.springframework）

<dependencies>
<dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>4.3.9.RELEASE</version>
</dependency>
<dependencies>

假如添加好了依赖,都没有找到对应的jar依赖,先检测网络是否是通的.假如网络是通的,还没有下载到具体的依赖,此时要右键项目,选择maven/upate maven project/fore update…进行maven强制更新操作.

在项目的resource的目录中添加核心配置文件applicationContext.xml,例如：

<?xml version="1.0" encoding="UTF-8"?>
<beans default-lazy-init="true"
    xmlns="http://www.springframework.org/schema/beans" 
    xmlns:p="http://www.springframework.org/schema/p"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xmlns:context="http://www.springframework.org/schema/context"
    xmlns:tx="http://www.springframework.org/schema/tx"
    xmlns:aop="http://www.springframework.org/schema/aop" 
    xmlns:mvc="http://www.springframework.org/schema/mvc"
    xmlns:util="http://www.springframework.org/schema/util"
    xmlns:jpa="http://www.springframework.org/schema/data/jpa"
    xsi:schemaLocation="  
       http://www.springframework.org/schema/beans   
       http://www.springframework.org/schema/beans/spring-beans-4.3.xsd  
       http://www.springframework.org/schema/mvc   
       http://www.springframework.org/schema/mvc/spring-mvc-4.3.xsd   
       http://www.springframework.org/schema/tx   
       http://www.springframework.org/schema/tx/spring-tx-4.3.xsd   
       http://www.springframework.org/schema/aop 
       http://www.springframework.org/schema/aop/spring-aop-4.3.xsd
       http://www.springframework.org/schema/util 
       http://www.springframework.org/schema/util/spring-util-4.3.xsd
       http://www.springframework.org/schema/data/jpa 
       http://www.springframework.org/schema/data/jpa/spring-jpa-1.3.xsd
       http://www.springframework.org/schema/context
       http://www.springframework.org/schema/context/spring-context-4.3.xsd" >
       
</beans>

　　　　说明：配置文件的名字需要自己定义，当这个空的配置文件中的某行有相关错误

　　　　时，先去检测网络是不是通的。

　　2.2.3. 配置前端控制器

　　　　打开web.xml，配置DispatcherServlet对象

<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:applicationContext.xml</param-value>
     </init-param>
     <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
     <servlet-name>dispatcherServlet</servlet-name>
     <url-pattern>*.do</url-pattern>
  </servlet-mapping>

　　前端控制器是spring mvc处理请求的入口，是springmvc的核心，这个控制器一般需要在服务器启动时即初始化。

　　　　其中

　　　　　　1) load-on-startup 表示启动时则加载此servlet

　　　　　　2) init-param 中的参数名不能变（此名字在DispatcherServlet父类中定义）

　　　　2.2.4. 创建后端控制器

　　　　　　后端控制器编写时可以实现Controller接口，然后重写handleRequest方法处理请求

　　　　　　public class HelloController implements Controller{}

　　　　　　其中:

　　　　　　　　ModelAndView对象为一个模型与视图对象，内置一个map对象，主要用于封装业务数据和视图名。

　　　　　　　　ModelAndView构造方法中传递的为视图名，addObject方法可以以key/value形式存储数据。

　　　　　　　　ModelAndView 对象返回时会被spring mvc自动存储到请求作用域，在对应的视图页面可以直接从此作用域获取对应的值。

　　　　2.2.5. 创建JSP页面

　　　　　　在项目的WEB-INF/pages文件夹下创建hello.jsp文件，然后设置其内容，例如

　　　　2.2.6. 配置后端控制及视图解析

　　　　　　在spring mvc 核心配置文件中添如下配置。

<!-- 将Controller这个Bean对象交给Spring管理 -->
<bean id="helloController" class="spring.controller.XmlHelloController">
</bean>
<!-- 配置HandlerMapping 映射处理器配置url到具体的Controller之间的映射-->
 <bean class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
             <property name="mappings">
                  <props>
                      <prop key="/hello.do">helloController</prop>
                  </props>
             </property>
  </bean>
  <!-- 配置视图解析器 -->
 <bean  id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
            <property name="prefix" value="/WEB-INF/pages/"/>
            <property name="suffix" value=".jsp"/>
</bean>

　　　　2.2.7. 部署到tomcat运行

　　　　　　将项目部署到tomcat，然后启动运行，在地址栏输入具体url访问对应controller。

　　　　　　问题：

　　　　　　　　1） tomcat启动时出现ClassNotFoundException，而这个class又不是我们自己的类，此时要重新maven update，重新发布(右键tomcat 重新publish)，多次尝试还是不可以，此时重启eclipse。

　　　　　　　　2） 404异常，一般表示服务端资源没找到,首先检测访问路径是否正确，然后还可以在项目的部署目录中去查找对应的资源，必须确保资源是存在的，假如资源不存在，说明代码没有正常编译。（很常见）

 　　　　　　　3） 如何解决这种项目不编译的问题？

　　　　　　　　step01) 将tomcat下的项目移除，clean你的tomcat服务器

　　　　　　　　step02) 将项目的jre从buildpath移除，然后重新添加

　　　　　　　　step03) 对项目先进行maven clean操作(清除原先编译结构，然后重新编译)

　　　　　　　　step04) 再次对项目进行clean操作

　　　　　　　　step05) 重新部署项目，启动tomcat运行

　　　　　　4） 运行项目时尽量不要右键运行选在run as /run on server

　　　　2.2.8. 运行原理分析

　　　　　　本应用的简易处理流程如下：

 　　　　　　

4.2. 响应数据转换JSON

4.2.1. JSON 应用概述

JSON(JavaScript Object Notation):一种轻量级数据交换格式,通常用于实现客户端与服务端之间的数据传输.

企业级Java项目数据传输方式：

 

 

5. Spring 拦截器应用

　　5.1. 拦截器概述

　　　　拦截器是SpringMVC中的一个核心应用组件,主要用于处理多个Controller的共性问题.当我们的请求由DispatcherServlet派发到具体Controller之前首先要执行拦截器中一些相关方法,在这些方法中可以对请求进行相应预处理(例如权限检测,参数验证),这些方法可以决定对这个请求进行拦截还是放行.通过spring mvc 架构图分析,拦截器在Spring MVC中处理流程中的一个位置

　　　　回顾Spring MVC详细架构图

 　　　　

　　思考:假如对请求数据进行编码,是应在过滤器还是拦截器?

　　5.2. 拦截器编写及配置

 　　　　拦截器如何编写?

 　　　　我们自己编写Spring MVC拦截器需要实现HandlerInterceptor接口或者继承此接口的实现类 HandlerInterceptorAdapter（继承这个类时可根据需求重写必要的方法）

public class SysUserInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(
            HttpServletRequest request,
            HttpServletResponse response, Object handler)
            throws Exception {
            System.out.println("preHandle");
        return true;//表示放行
    }
    @Override
    public void postHandle(
            HttpServletRequest request,
            HttpServletResponse response,
            Object handler,
            ModelAndView modelAndView) 
            throws Exception {
            System.out.println("postHandler"
                + ".modelAndView="+modelAndView);
    }
    @Override
    public void afterCompletion(
            HttpServletRequest request,
            HttpServletResponse response, 
            Object handler,
            Exception ex)
            throws Exception {
             System.out.println("afterCompletion.handler="+
            handler.getClass());
    }
}

 

这些方法的简易执行流程点如下图所示：

 

这些方法的详细的执行时间点如下：

 

我们自己的拦截器编写完成以后需要在spring配置文件中进行配置,，

例如:

<mvc:interceptors>
           <mvc:interceptor>
             <!-- 指定拦截哪些请求路径 -->
             <mvc:mapping path="/**"/>
             <!-- 排除要拦截的路径 -->
             <mvc:exclude-mapping path="/sys/doLogin.do"/>
             <!-- 拦截器 -->
             <bean class="cn.spring.mvc.interceptor.SysUserInterceptor"/>
           </mvc:interceptor>
</mvc:interceptors>

　　　　当我们系统中有多个拦截器时,这些拦截器可以构成一个拦截器链.其原理类似过滤器中的过滤链。在多个拦截器应用中仅当所有匹配的拦截器的preHandle()都执行之后，才会调用Controller中处理请求的方法，然后再执行所有匹配的拦截器的postHandler()，再执行所有匹配的拦截器的afterCompletion()。

　　　　在拦截器链中，各拦截器的执行先后顺序取决于配置文件中配置的节点的先后顺序！

 

6. Spring MVC异常处理

 　　6.1. Spring MVC 异常概述

　　　　实际项目中我们经常会采用分层架构设计程序,每一层都可能会有异常,假如异常信息没有处理,可能会选择抛出,假如这些被抛出的异常与具体业务相关,那到控制层以后我们一般都进行相应的处理(处理方式应该相对友好)

　　　　在Spring mvc 项目中,边界出现异常以后我们通常会在Controller中进行处理,常用分层架构中的异常分析:

 　　　　在分层架构中，异常可能会从DAO层逐步抛出到控制层，可以在控制层对异常进行相关处理。

6.2. Spring MVC 异常处理

 　　在spring中处理异常时,通常会在Controller中定义具体的异常处理方法,这个方法上使用@HandlerException注解进行描述.例如在指定Controller中定义异常处理方法:

@ExceptionHandler(value=Exception.class)
@ResponseBody
public String handleException(Exception e){
    System.out.println("局部异常处理");
    return e.getMessage();
}

当Spring的controller中没有定义具体的异常方法,我们外部定义一个全局的异常处理类,这个类使用@ControllerAdvice注解进行修饰.然后在这个类中定义具体的异常处理方法,这些方法再使用@HandlerExcpeiton进行修饰,例如

@ControllerAdvice
public class AdviceExceptionHandler {
    @ExceptionHandler(Throwable.class)
    @ResponseBody
    public String handlerException(Throwable e){
        System.out.println("全局的异常处理");
        return e.getMessage();
    }
}

1. Spring MVC 文件上传

　　1.1. 文件上传业务场景

　　　　在电子商务系统中对具体商品采用图片方式进行描述，这个图片需要上传到服务器等等。

　　1.2. Spring MVC 文件上传基本步骤

　　　　Step01: 添加文件上传相关依赖（jar包：commons-fileupload）

　　　　Step02: 配置对上传文件对象的解析(spring的核心配置文件)

　　　　Step03: 编写文件上传表单(请求方式为post,enctype必须为multipart/form-data)

　　　　Step04: 编写对应的控制层对象处理文件上传(通过mutilpartFile参数接收文件)

　　1.2.1. 添加依赖

<dependency>
   <groupId>commons-fileupload</groupId>
   <artifactId>commons-fileupload</artifactId>
   <version>1.3.3</version>
  </dependency>

1.2.2. 配置对象解析

在spring的核心配置文件中添加对象解析

<bean id="multipartResolver" 
         class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
        <!-- 配置文件编码处理 -->
        <property name="defaultEncoding" value="utf-8"/>
        <!-- 配置文件大小限制 -->
        <property name="maxUploadSize" value="4096000000"/>
        <!-- 配置内存缓冲区大小 -->
        <property name="maxInMemorySize" value="1024000"/>
   </bean>

说明：配置对象解析时，bean的id一定要指定，而且官方规定必须为multipartResolver

1.2.3. 定义upload.jsp

在WEB-INF/pages目录下创建一个upload.jsp,然后创建上传表单

<body>
   <h1>文件上传</h1>
   <h1>${msg}</h1>
   <form action="doUpload.do" 
         method="post"
         enctype="multipart/form-data">
        <input type="file" name="upfile"/>
        <br/>
        <input type="submit" value="upload"> 
   </form>
</body>

说明：定义表单时，提交方式必须为post，enctype必须为multipart/form-data

1.2.4. 定义UploadController

@RequestMapping("/upload/")
@Controller
public class UploadController {
       @RequestMapping("uploadUI")
       public String uploadUI(){
           return "upload";
       }
      
       @RequestMapping("doUpload")
       public ModelAndView doUpload(MultipartFile upfile)
                throws IOException{
           //获取文件名以及文件大小，检测是否获得文件相关数据
           String fileName=upfile.getOriginalFilename();
           long size=upfile.getSize();
           System.out.println(fileName+"/"+size);
            //构建文件目标对象，这个对象对应的文件路径必须是存在的或者通过file对象自己创建
           File dest=new File("D:/SSMWORK/"+fileName);
           //transferto实现文件上传
           upfile.transferTo(dest);
           //封装数据返回
           ModelAndView mv=new ModelAndView("upload");
           mv.addObject("msg", "upload ok");
           return mv;
       }
}

说明：在控制层方法接收请求中file类型的数据时需要借助MultipartFile 类型的参数对象，其参数名要求与表单中type为file的参数名相同。