spring、springmvc、mybatis整合文件配置详解

向右看齐 2022-09-26 03:52 159阅读 0赞

首先非常感谢原文作者Pickle，读完原作者这篇博客受益良多，所以拿来自己记录下。

原文地址是：http://www.cnblogs.com/wxisme/p/4924561.html

官方文档地址：

Spring：[http://spring.io/docs][http_spring.io_docs]

MyBatis：[http://mybatis.github.io/mybatis-3/][http_mybatis.github.io_mybatis-3]

**web.xml的配置                                                                                                                                                                 **

web.xml应该是整个项目最重要的配置文件了，不过servlet3.0中已经支持注解配置方式了。在servlet3.0以前每个servlet必须要在web.xml中配置servlet及其映射关系。但是在spring框架中就不用了，因为Spring中是依赖注入（Dependency Injection）的也叫控制反转（Inversion of Control）。但是也要配置一个重要的servlet，就是前端控制器（DispatcherServlet）。配置方式与普通的servlet基本相似。

配置内容如下：

![复制代码][copycode.gif]

<servlet>
          <servlet-name>spring</servlet-name>
          <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
          <init-param>
              
              <param-name>contextConfigLocation</param-name>
              <param-value>WEB-INF/classes/spring/springmvc.xml</param-value>
      </init-param>
      </servlet>
      <servlet-mapping>
          <servlet-name>spring</servlet-name>
          
          <url-pattern>/</url-pattern>
      </servlet-mapping>

![复制代码][copycode.gif]

这里需要注意，springmvc.xml是spring配置文件，将在后面讨论。在<servlet-mapping>中url如果是.action，前端控制器就只会拦截以.action结尾的请求，并不会理会静态的文件。对静态页面的控制就要通过其他的手段。以/作为url的话就会拦截所有的请求，包括静态页面的请求。这样的话就可以拦截任何想要处理的请求，但是有一个问题。如果拦截了所有的请求，如果不在拦截器中做出相应的处理那么所有静态的js、css以及页面中用到的图片就会访问不到造成页面无法正常显示。但这可以通过静态资源的配置来解决这个问题。后面会提到。

配置spring容器：

<context-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>WEB-INF/classes/spring/applicationContext-*.xml</param-value>
    
    </context-param>

其中applicationContext-\*.xml包含3个配置文件，是springIoC容器的具体配置。后面会提到。

配置一个监听器：

<listener>
            <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

web.xml的完整配置是这样的：

![复制代码][copycode.gif]

<?xml version="1.0" encoding="UTF-8"?>
    <web-app version="3.0" 
        xmlns="http://java.sun.com/xml/ns/javaee" 
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
        xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
        http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd">
      <display-name></display-name>    
      
      
      <error-page>
        <error-code>404</error-code>
        <location>/error404.jsp</location>
      </error-page>
      
      <error-page>
        <error-code>500</error-code>
        <location>/error500.jsp</location>
      </error-page>
      
      
        <context-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>WEB-INF/classes/spring/applicationContext-*.xml</param-value>
        </context-param>
        <listener>
            <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
        </listener>
    
        
      
      <servlet>
          <servlet-name>spring</servlet-name>
          <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
          <init-param>
              
              <param-name>contextConfigLocation</param-name>
              <param-value>WEB-INF/classes/spring/springmvc.xml</param-value>
      </init-param>
      </servlet>
      <servlet-mapping>
          <servlet-name>spring</servlet-name>
          
          <url-pattern>/</url-pattern>
      </servlet-mapping>
        
      
      <filter>
          <filter-name>CharacterEncodingFilter</filter-name>
          <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
          <init-param>
              <param-name>encoding</param-name>
              <param-value>utf-8</param-value>
          </init-param>
      </filter>
      <filter-mapping>
          <filter-name>CharacterEncodingFilter</filter-name>
          <url-pattern>/*</url-pattern>
      </filter-mapping>
      <welcome-file-list>
        <welcome-file>welcome.jsp</welcome-file>
      </welcome-file-list>
      
      
        
    </web-app>

![复制代码][copycode.gif]

看到配置文件中多了两块内容，一个是error page是用来友好的处理错误的，可以使用错误代码来区别并跳转到相应的处理页面。这段配置代码最好放到最前面，在前端控制器拦截之前处理。

还有一块内容是一个解决post乱码问题的过滤器，拦截post请求并编码为utf8。

**springmvc.xml的配置                                                                                                                                                **

视图解析器的配置：

![复制代码][copycode.gif]

<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
             
             <property name="prefix" value="/"></property>
             <property name="suffix" value=".jsp"></property>
    </bean>

![复制代码][copycode.gif]

在Controller中设置视图名的时候会自动加上前缀和后缀。

Controller的配置

自动扫描方式，扫描包下面所有的Controller，可以使用注解来指定访问路径。

<context:component-scan base-package="com.wxisme.ssm.controller">

也可以使用单个的配置方式，需要指定Controller的全限定名。

配置注解的处理器适配器和处理器映射器：

<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter"/>
    
    <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping"/>

也可以使用下面的简化配置：

<mvc:annotation-driven conversion-service="conversionService"></mvc:annotation-driven>

配置拦截器，可以直接定义拦截所有请求，也可以自定义拦截路径。

![复制代码][copycode.gif]

<mvc:interceptors>
        
        <bean class="com.wxisme.ssm.interceptor.IdentityInterceptor"></bean>
            
        </mvc:interceptors>

![复制代码][copycode.gif]

配置全局异常处理器

<bean id="exceptionResolver" class="com.wxisme.ssm.exception.OverallExceptionResolver"></bean>

配置文件上传数据解析器，在上传文件时需要配置。

![复制代码][copycode.gif]

<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
            <property name="maxUploadSize">
                <value>9242880</value>
            </property>
        </bean>

![复制代码][copycode.gif]

还可以配置一些自定义的参数类型，以日期类型绑定为例。

![复制代码][copycode.gif]

<bean id="conversionService" class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
         <property name="converters">
             <list>
                 
                 <bean class="com.wxisme.ssm.controller.converter.DateConverter"/>
             </list>
         </property>
        </bean>

![复制代码][copycode.gif]

上面提到过如果在配置前端控制器时拦截了所有的请求，不做特殊处理就会导致部分静态资源无法使用。如果是这种情况就可以使用下面的配置来访问静态资源文件。

<mvc:resources mapping="/images/**" location="/images/" />
    <mvc:resources mapping="/css/**" location="/css/" />  
    <mvc:resources mapping="/js/**" location="/js/" />
    <mvc:resources mapping="/imgdata/**" location="/imgdata/" />

也可以使用默认，但是需要在web.xml中配置。

完全可以不拦截所有路径，大可避免这个问题的发生。

完整的配置大概是这样的，需要注意xml文件的命名空间，有时候会有影响的。

![复制代码][copycode.gif]

<?xml version="1.0" encoding="UTF-8"?>
    <beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:context="http://www.springframework.org/schema/context"
    xmlns:mvc="http://www.springframework.org/schema/mvc"
    xmlns:jdbc="http://www.springframework.org/schema/jdbc"
    xmlns:jee="http://www.springframework.org/schema/jee"
    xmlns:aop="http://www.springframework.org/schema/aop"
    xmlns:tx="http://www.springframework.org/schema/tx"
    xsi:schemaLocation="http://www.springframework.org/schema/beans
    http://www.springframework.org/schema/beans/spring-beans.xsd
    http://www.springframework.org/schema/context
    http://www.springframework.org/schema/context/spring-context.xsd
    http://www.springframework.org/schema/mvc
    http://www.springframework.org/schema/mvc/spring-mvc.xsd
    http://www.springframework.org/schema/tx
    http://www.springframework.org/schema/tx/spring-tx.xsd
    http://www.springframework.org/schema/aop
    http://www.springframework.org/schema/aop/spring-aop.xsd">
        
        
         
         <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
             
             <property name="prefix" value="/"></property>
             <property name="suffix" value=".jsp"></property>
         </bean>
         
         
         <context:component-scan base-package="com.wxisme.ssm.controller">
         </context:component-scan>
         
        <mvc:annotation-driven conversion-service="conversionService"></mvc:annotation-driven>
        
        
        <bean id="conversionService" class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
         <property name="converters">
             <list>
                 
                 <bean class="com.wxisme.ssm.controller.converter.DateConverter"/>
             </list>
         </property>
        </bean>
        
        
        
        
        
        <mvc:resources mapping="/images/**" location="/images/" />
        <mvc:resources mapping="/css/**" location="/css/" />  
        <mvc:resources mapping="/js/**" location="/js/" />
        <mvc:resources mapping="/imgdata/**" location="/imgdata/" />
        
        
        <mvc:interceptors>
        
        <bean class="com.wxisme.ssm.interceptor.IdentityInterceptor"></bean>
            
        </mvc:interceptors>
        
        
        <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
            <property name="maxUploadSize">
                <value>9242880</value>
            </property>
        </bean>
        
        
        
        <bean id="exceptionResolver" class="com.wxisme.ssm.exception.OverallExceptionResolver"></bean>
        
     </beans>

![复制代码][copycode.gif]

**applicationContext-\*.xml的配置                                                                                                **

applicationContext-\*.xml包括三个配置文件，分别对应数据层控制、业务逻辑service控制和事务的控制。

**数据访问层的控制，applicationContext-dao.xml的配置：**

配置加载数据连接资源文件的配置，把数据库连接数据抽取到一个properties资源文件中方便管理。

配置为：

<context:property-placeholder location="/WEB-INF/classes/jdbc.properties"/>

其中jdbc.properties文件的内容如下：

jdbc.driver=com.mysql.jdbc.Driver
    jdbc.url=jdbc:mysql://localhost:3306/database
    jdbc.username=root
    jdbc.password=1234

配置数据库连接池，这里使用的是dbcp，别忘了添加jar包！

![复制代码][copycode.gif]

<bean id="dataSource" class="org.apache.commons.dbcp2.BasicDataSource" destroy-method="close">
        <property name="driverClassName" value="${jdbc.driver}"/>
        <property name="url" value="${jdbc.url}"/>
        <property name="username" value="${jdbc.username}"/>
        <property name="password" value="${jdbc.password}"/>
    </bean>

![复制代码][copycode.gif]

Spring和MyBatis整合配置，jar包由MyBatis提供。

配置sqlSessionFactory

![复制代码][copycode.gif]

<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        
        <property name="dataSource" ref="dataSource"/>
        
        <property name="configLocation" value="/WEB-INF/classes/mybatis/SqlMapConfig.xml"/>
    
    </bean>

![复制代码][copycode.gif]

SqlMapConfig.xml文件是MyBatis的配置文件，后面会提到。

配置Mapper扫描器，扫描mapper包下的所有mapper文件和类，要求mapper配置文件和类名需要一致。

![复制代码][copycode.gif]

<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        
        <property name="basePackage" value="com.wxisme.ssm.mapper"></property>
        <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/>
    </bean>

![复制代码][copycode.gif]

整个applicationContext-dao.xml配置文件应该是这样的：

![复制代码][copycode.gif]

** 业务逻辑控制，applicationContext-service.xml的配置：**

这个文件里暂时只需要定义service的实现类即可。

<bean id="userService" class="com.wxisme.ssm.service.impl.UserServiceImpl"/>

**事务控制，applicationContext-transaction.xml的配置**

配置数据源，使用JDBC控制类。

配置通知，事务控制。

![复制代码][copycode.gif]

<tx:advice id="txAdvice" transaction-manager="transactionManager">
            <tx:attributes>
                
                <tx:method name="save*" propagation="REQUIRED"/>
                <tx:method name="insert*" propagation="REQUIRED"/>
                <tx:method name="update*" propagation="REQUIRED"/>
                <tx:method name="delete*" propagation="REQUIRED"/>
                <tx:method name="find*" propagation="SUPPORTS" read-only="true"/>
                <tx:method name="select*" propagation="SUPPORTS" read-only="true"/>
                
            </tx:attributes>
        </tx:advice>

![复制代码][copycode.gif]

配置AOP切面

<aop:config>
            <aop:advisor advice-ref="txAdvice" pointcut="execution(* com.wxisme.ssm.service.impl.*.*(..))"/>
        </aop:config>

整个事务控制的配置是这样的：

![复制代码][copycode.gif]

MyBatis的配置

SqlMapConfig.xml的配置   全局setting配置这里省略，数据库连接池在spring整合文件中已经配置，具体setting配置参考官方文档。

别名的定义：

mapper映射文件的配置：

![复制代码][copycode.gif]

<mappers>
        
        
        
        <package name="com.wxisme.ssm.mapper"/>
         
         
    </mappers>

![复制代码][copycode.gif]

整个文件的配置应该是这样的：

![复制代码][copycode.gif]

<?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE configuration
    PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
    "http://mybatis.org/dtd/mybatis-3-config.dtd">
    <configuration>
    
    
    
    
    <typeAliases>
        
        <package name="com.wxisme.ssm.po"/>
    </typeAliases>
    
    
    
    <mappers>
        
        <package name="com.wxisme.ssm.mapper"/>
    </mappers>
    </configuration>

![复制代码][copycode.gif]

具体mapper文件的配置，在使用mapper代理的方法时，命名空间需要是对应的Mapper类。

<?xml version="1.0" encoding="UTF-8" ?>
    <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" >
    <mapper namespace="com.wxisme.ssm.mapper.AlbumMapper" >
      
    </mapper>

以上只是对SSM框架简单使用时的配置文件，如果需要深入使用或者需要理解其内部机理需要参考官方文档和其源代码。

[http_spring.io_docs]: http://spring.io/docs
[http_mybatis.github.io_mybatis-3]: http://mybatis.github.io/mybatis-3/
[copycode.gif]: /images/20220717/db5f3a7fcb7944e980bec436937dd750.png