基于IDEA搭建SpringMVC+Spring+Mybatis的全过程，并深入了解整个运行流程和项目配置

SpringMVC+Spring+Mybatis（SSM）这个组合框架，作为java程序员一定不陌生，SSM作为流行的java web开发框架已经在很多大型公司使用了，在互联网公司实现期间，我用SSM框架比较多，但是也主要是基于已经搭建好的配置环境下，在controller层、service层、mapper层做代码开发工作，对于SSM框架的认知也仅限于知道大概运行流程，以及一些配置文件和注解的作用，这显然是不够的，现在有时间来研究SSM框架的运行机理了。

       本文主要从开始搭建项目开始讲解SSM框架的运行流程以及相应配置文件的书写，现在开始进入主题。

（1）开始搭建基于SSM框架的web项目

项目基于是maven搭建的：

点击next，填写GroupId和ArtifacId

一路next，点击finish

基于maven搭建的项目目录如下所示：

（2）继续完善项目目录架构

      file-->project Structure-->module新建文件夹  :java （Sources）、resources(Resources)、plugs（存放前端js插件）、static(存放项目的静态资源)、views（存放项目的视图）

java下面分别建立com文件夹和spring文件夹

com文件夹是主要工程代码，如controller、service、impl、dao、pojo、sqlxml

spring文件夹主要是用来存放spring-mvc.xml以及application.xml配置文件的

项目的完整目录如下所示：

（3）开始项目的配置

1、pom.xml文件，添加SSM相关的依赖

  4.0.0

  ssm
  ssm
  1.0-SNAPSHOT
  war

  ssm Maven Webapp
  
  http://www.example.com

  
    UTF-8
    1.7
    1.7
    
    5.0.8.RELEASE
    
    3.3.0

    1.2.17
    
    2.5.0
  

  
    
      junit
      junit
      4.11
      test
    
    
    
      org.springframework
      spring-aop
      ${spring.version}
    

    
      org.springframework
      spring-aspects
      ${spring.version}
    

    
      org.aspectj
      aspectjrt
      1.6.11
    
    
      org.aspectj
      aspectjweaver
      1.6.11
    
    
      cglib
      cglib
      2.1_3
    
    

    
    
      org.springframework
      spring-tx
      5.0.8.RELEASE
    

    
    
    
      org.slf4j
      slf4j-api
      1.7.25
    

    
    
      org.springframework
      spring-context
      ${spring.version}
    

    
    
      org.springframework
      spring-webmvc
      ${spring.version}
    

    
    
      org.springframework
      spring-web
      ${spring.version}
    

    
    
      org.mybatis
      mybatis
      ${mybatis.version}
    


    
    
      org.mybatis
      mybatis-spring
      1.3.1
    

    
    
      mysql
      mysql-connector-java
      5.1.38
    

    
      org.springframework
      spring-jdbc
      4.2.5.RELEASE
    

    
    
      com.alibaba
      druid
      1.0.9
    


    
    
    
      com.fasterxml.jackson.core
      jackson-databind
      2.9.6
    

    
    
      com.fasterxml.jackson.core
      jackson-annotations
      2.9.6
    


    
    
      commons-fileupload
      commons-fileupload
      1.3.1
    

    
    
      javax.servlet
      jstl
      1.2
    

    
    
      commons-collections
      commons-collections
      3.2.1
    

    
    
      log4j
      log4j
      1.2.17
    

    
    
      javax.servlet
      servlet-api
      2.5
      provided
    

    
    
      org.springframework
      org.springframework.web.servlet
      3.1.2.RELEASE
    


  

  
    ssm
    
      
        
          maven-clean-plugin
          3.0.0
        
        
        
          maven-resources-plugin
          3.0.2
        
        
          maven-compiler-plugin
          3.7.0
        
        
          maven-surefire-plugin
          2.20.1
        
        
          maven-war-plugin
          3.2.0
        
        
          maven-install-plugin
          2.5.2
        
        
          maven-deploy-plugin
          2.8.2
        
      
    
  

2、配置项目的启动配置--web.xml

先附上项目的配置文件：

  Archetype Created Web Application

  
  
    index.jsp
  

  
  

  
    配置Spring配置文件路径
    contextConfigLocation

    classpath:spring/applicationContext.xml
  

  
  
    
      org.springframework.web.context.request.RequestContextListener
    
  

  
    org.springframework.web.context.ContextLoaderListener
  

  
  
    log4jConfigLocation
    classpath:log4j.properties
  
  
  
    log4jRefreshInterval
    1800000
  
  
    
    
  

  
  
    encodingFilter
    org.springframework.web.filter.CharacterEncodingFilter
    
      encoding
      UTF-8
    
    
      forceEncoding
      true
    
  
  
    encodingFilter
    /*
  

  
  
  
    springMVC
    org.springframework.web.servlet.DispatcherServlet
    
      
      contextConfigLocation
      
      classpath:spring/spring-mvc.xml
    
    1
    true
  

  
  
    springMVC
    
    /
  
  

  
  
    default
    /static/*
  

  
  
    30
  

       首先介绍一下启动一个项目的整体流程：

       （1）启动一个WEB项目的时候，WEB容器会去读取它的配置文件web.xml，读取和两个结点。

       （2）紧接着，容器创建一个ServletContext（servlet上下文，全局的），这个web项目的所有部分都将共享这个上下文。可以把ServletContext看成是一个Web应用的服务器端组件的共享内存，在ServletContext中可以存放共享数据。ServletContext对象是真正的一个全局对象，凡是web容器中的Servlet都可以访问

        （3）容器将转换为键值对，并交给servletContext。

        （4）容器创建中的类实例，创建监听器。   

 

       以上步骤，都是基于web.xml的配置文件进行操作的，现在简单说一下，web.xml文件主要的工作包括两部分：1、web.xml启动spring容器；2、DispathcheServlet的声明；3、其余工作是session过期，字符串编码等

       web.xml中标签的加载顺序：  >  (spring的相关工作)  >  filter >servlet（springmvc的相关工作）

 

A、web.xml启动spring容器的加载过程：

        读取web.xml中两个节点，  >  ，创建ServletContext对象，listener中ContextLoaderListener监听器的作用就是启动Web容器时，监听servletContext对象的变化，获取servletContext对象的，来自动装配ApplicationContext的配置信息。

     1） 当我们启动一个WEB项目容器时，容器包括(JBoss,Tomcat等)。首先会去读取web.xml配置文件里的配置，当这一步骤没有出错并且完成之后，项目才能正常的被启动起来。

     2） 启动WEB项目的时候：

       容器首先会去读取web.xml配置文件中的两个节点：

               第一个节点： ，是web应用的资源配置，是wen应用的上下文参数，如数据库连接方式，spring的配置文件路径（application.xml）等，这些键值对都会加入到servletContext对象。

               第二个节点： ，可以获取当前该web应用对象，即servletContext对象，获取context-param值，进而获取资源，在web应用启动前操作）  ,listener中ContextLoaderListener监听器的作用就是启动Web容器时，监听servletContext对象的变化，获取servletContext对象的，来自动装配ApplicationContext的配置信息。因为它实现了ServletContextListener这个接口，在web.xml配置这个监听器，启动容器时，就会默认执行它实现的方法。

      元素含有一对参数名和参数值，用作应用的Servlet上下文初始化参数，参数名在整个Web应用中必须是惟一的，在web应用的整个生命周期中上下文初始化参数都存在，任意的Servlet和jsp都可以随时随地访问它。用于向 ServletContext 提供键值对。

       监听器，它是实现了javax.servlet.ServletContextListener 接口的服务器端程序，它也是随web应用的启动而启动，只初始化一次，随web应用的停止而销毁。主要作用是： listener中ContextLoaderListener监听器的作用就是启动Web容器时，监听servletContext对象的变化，获取servletContext对象的，来自动装配ApplicationContext的配置信息。

        3）紧接着，容器创建一个ServletContext(application),这个web项目的所有部分都将共享这个上下文。容器以的name作为键，value作为值，将其转化为键值对，存入ServletContext。ServletContext即代表当前web应用。

         4）容器创建中的类实例,即创建监听.，listener中ContextLoaderListener监听器的作用就是启动Web容器时，监听servletContext对象的变化，获取servletContext对象的，来自动装配ApplicationContext的配置信息。

     5） 监听器中通过contextInitialized(ServletContextEvent args)初始化方法，来获得ServletContext 对象以及context-param值。

                              ServletContext = ServletContextEvent.getServletContext();

                              context-param的值 = ServletContext.getInitParameter("context-param的键");

        6）  拿到这个context-param的值之后,可以在WEB项目还没有完全启动时，进行一些初始化工作，但是最主要的还是自动装配ApplicationContext的配置信息。

        7）   .举例.你可能想在项目启动之前就打开数据库.
           那么这里就可以在中设置数据库的连接方式,在监听类中初始化数据库的连接.。这个监听是自己写的一个类,除了初始化方法,它还有销毁方法.用于关闭应用前释放资源.比如说数据库连接的关闭.

 

B、DispathcheServlet的声明（主要是servlet标签的配置,，主要配置springmvc）

         DispatcherServlet是前端控制器设计模式的实现，提供Spring Web MVC的集中访问点（也就是把前端请求分发到目标controller），而且与Spring IoC容器无缝集成，从而可以获得Spring的所有好处。

    DispatcherServlet主要用作职责调度工作，本身主要用于控制流程，主要职责如下：

1、文件上传解析，如果请求类型是multipart将通过MultipartResolver进行文件上传解析；

2、通过HandlerMapping，将请求映射到处理器（返回一个HandlerExecutionChain，它包括一个处理器、多个HandlerInterceptor拦截器）；

3、  通过HandlerAdapter支持多种类型的处理器(HandlerExecutionChain中的处理器)；

4、通过ViewResolver解析逻辑视图名到具体视图实现；

5、本地化解析；

6、渲染具体的视图等；

7、如果执行过程中遇到异常将交给HandlerExceptionResolver来解析。

从以上我们可以看出DispatcherServlet主要负责流程的控制（而且在流程中的每个关键点都是很容易扩展的）。

DispatcherServlet在web.xml中的配置:

    web.xml中spring的核心ContextLoaderListener初始化的上下文和springmvc的核心DispatcherServlet初始化的上下文关系：

       

从图中可以看出：

      ContextLoaderListener初始化的上下文加载的Bean是对于整个应用程序共享的，不管是使用什么表现层技术，一般如DAO层、Service层Bean；

     DispatcherServlet初始化的上下文加载的Bean是只对Spring Web MVC有效的Bean，如Controller、HandlerMapping、HandlerAdapter等等，该初始化上下文应该只加载Web相关组件。

 

3、配置spring的配置文件----applicaitonContext.xml  ，主要是项目中上下文资源的配置

       在web.xml文件中，由context-param指定的spring的配置文件在：

applicationContext.xml文件内容如下，主要是配置dataSource （数据源）、事务管理、对dataSource 数据源进行事务管理、事务通知、事务 aop 配置等。

    Spring Configuration
    
    
    
    

    
    


    
    

        
        
        
        

        
        
        
        

        
        

        
        

        
        

        
        
        
        

        
        
        

        
        
    

    
    
        
        
        
    

    
    
        
        
    

    
    
        
    

    
    
        
            
            
            
            
            
            
            
            
            
            
            
            
            
            
            
        
    

    
    
        
        
    

    
    

    
    

4、配置SpringMVC的配置文件------spring-mvc.xml  ，主要是web层，如controller层和视图层的配置

在web.xml文件中，由指定的spring的配置文件在：

spring-mvc.xml 的文件内容如下：

    
    

    
    
        
    

    


    
        
            
                text/html;charset=UTF-8
                text/json;charset=UTF-8
                application/json;charset=UTF-8
            
        
    

    

    

    
    
    
    
    

    
    
    
    

    

    

    
    
    
        
        
        
    

    
    
        
        
        
    

    
    

    
    
    
    

 

 

applicaitonContext.xml与spring-mvc.xml的配置中，关于spring注解与springMVC注解扫描的问题（重要！！！）

   在将spring与springMVC结合使用时，当我们使用注解的时候，一般都是在spring配置文件中配置注解扫描dao层、service层的包，在springMVC配置文件中配置注解扫描controller。

 问题一：在springMVC配置文件中启用注解扫描（关闭spring扫描），扫描dao、service、controller的问题

         这种情况下项目能正常跳转，但是我们通过@Transactional配置的service事务失效，这里是因为spring容器配置了事务管理器后，装配的service都是经过cglib代理过的实例，具有事务功能，而springmvc容器装配的service是没有进行代理处理的，所以是没有事务功能的。

  问题二：为什么要在spring中扫描dao、service，而在springmvc中扫描controller

          因为通过spring容器扫描dao以及service可以进行事务的增强，如果你仅仅在一个子容器中进行事务的增强那么其他的serviceBean是不会被事务增强的（比如第四种情况中，如果我们在spring容器中手动配置一个bean，那么这个bean不是由springmvc装配的，而我们的事务管理器在springmvc中，这个bean就不具备事务的功能）。而controller之所以要在springmvc中配置，因为spring容器无法访问到springmvc容器的bean（HandlerAdapter和HandlerMapping以及Resolver等），无法完成请求与hander的正确适配，如果要强行实现，在spring中配置HandlerAdapter和HandlerMapping以及Resolver则显得太过牵强。在书上看到的一种说法是这样也体现了分层的概念，dao、service等web层都需要使用的bean应该直接在spring容器中装配，而controller这种则放在专门处理请求跳转的springmvc容器中，相对于将所有bean配置在spring容器中，也体现了权限控制的思想吧。

 

（5）、其余各层业务逻辑代码和注解使用

    如下图所示，主要是controller层业务逻辑、service层的方法实现、dao层sql方法的设计与实现以及pojo的设计以及视图展示。

这几部分没有太多可讲的，直接见末尾代码，可自行下载运行。

      

关于注解的使用，项目中主要用到了如下几种注解：

1、controller层

     @Controller ：  标识为bean，这是一个controller

     @RequestMapping("/user")：  映射请求，将请求路径与controller里面具体的方法关联起来

     @Resource(name = "UserService")：     

       @Resource默认按照名称方式进行bean匹配，@Autowired默认按照类型方式进行bean匹配；@Resource(import javax.annotation.Resource;)是J2EE的注解，@Autowired( import org.springframework.beans.factory.annotation.Autowired;)是Spring的注解；Spring属于第三方的，J2EE是Java自己的东西。使用@Resource可以减少代码和Spring之间的耦合。现在推荐@Autowired

     @ResponseBody：

        @responseBody注解的作用是将controller的方法返回的对象通过适当的转换器转换为指定的格式之后，写入到response对象的body区，通常用来返回JSON数据或者是XML

2、service层

   @Service("UserService")：  可以采用@Autowired替换，这样就不用指定名称了，很方便

         service采用@service注解，该注解加在serviceimpl类上，@Service("userService")注解是告诉spring，当Spring要创建UserServiceImpl的的实例时，bean的名字必须叫做"userService"，这样当Action需要使用UserServiceImpl的的实例时,就可以由Spring创建好的"userService"，然后注入给Action。

 

3、Dao层

    @Repository("UserDao")：@Repository(value="userDao")注解是告诉Spring，让Spring创建一个名字叫“userDao”的UserDaoImpl实例。

4、pojo层没有

 

（6）项目代码

     链接：https://github.com/xia123zheng/ssm