ssm中mapper注入失敗的傳奇經歷

最近由於要測試一個功能，須要用最短的時間來啓動服務，開啓測試程序，但日常所用的框架中已經集成了各類三方的東西，想着那就再從新搭建一個最簡單的ssm框架吧。

搭建可參考：簡單ssm最新搭建

 

搭建過程並不麻煩，整合springmvc測試成功，接口正常調用，最後整合mybatis後，在service中注入調用時出現了問題，啓動服務時報錯以下：

　　　　No qualifying bean of type 'com.test.mapper.TpmTestLogMapper' available: expected at least 1 bean which qualifies as autowire candidate. Dependency annotations: {@org.springframework.beans.factory.annotation.Autowired(required=true)}

 

1、bug解決

 

首先先說一下個人錯誤緣由：web.xml中沒有配置監聽器listener，也就是下邊這些代碼：

（其實配置了，可是不知道爲何最後發現是註釋掉的，真的 頭大！！！）

　　<!-- Spring監聽器 -->
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

（文末附有完整的web.xml配置，直接到文末）

 

那麼爲何沒有配置監聽，就致使mybatis注入失敗了呢，這就不得不提到監聽配置其中的一個做用了，監聽加載容器配置文件，也就是Spring的配置文件applicationContext.xml。

 

加載流程：　　tomcat服務啓動時，會首先加載web.xml，而後監聽器會默認去加載Spring的相關配置文件，從而建立spring容器中的各個bean組件。

 

默認加載的配置文件路徑是：WEB-INF/applicationContext.xml，固然不少時候咱們爲了項目結構的清晰，會將此配置文件放在resource下，這時也須要在web.xml中額外配置

 

　　 <!--spring的其餘配置文件(包括mybatis配置文件) -->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value> classpath*:spring-applicationContext.xml </param-value>
    </context-param>

 

錯誤緣由總結：啓動文件web.xml中沒有配置監聽器，致使個人Spring相關配置文件沒有加載，因此其中引入的spring-mybatis配置文件更不會加載，bean沒有建立成功，最終致使了在service中調用時注入失敗。

 

2、排查思路

 

排查過程當中的思路：

1. spring-mybatis整合配置文件路徑是否正確，可否被掃描到

2. mapper.java和mapper.xml之間有沒有聯繫起來，數據庫配置是否正確，mapper接口是否能夠掃描到（查看配置文件）

3. 有沒有掃描到mapper.xml文件（查看編譯文件，及對應路徑是否正確）

 

一、檢查spring-mybatis配置文件，在web.xml中是否能夠掃描到：在serviceImpl中手動獲取,看可否獲取到

　　@Override
　　public void ceshi(TpmTestLog tpmTestLog) {
　　　　//手動獲取建立
    　　ApplicationContext ac = new ClassPathXmlApplicationContext("classpath:spring-mybatis.xml");
    　　TpmTestLogMapper bean = ac.getBean(TpmTestLogMapper.class);
    　　bean.insert(tpmTestLog);
    　　System.out.println(bean.toString());
　　}

測試是否能夠成功獲取到，能夠，則表示mybatis路徑正確，能夠在web.xml中被正常掃描。

 

二、檢查mybatis配置文件是否正確：主要是下方標紅的兩項配置會形成此錯誤

    <!-- 讀取配置文件信息 -->
    <context:property-placeholder ignore-unresolvable="true" location="classpath:jdbc.properties"/>

    <bean name="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" 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}" />

        <!-- 初始化鏈接數量 -->
        <property name="initialSize" value="${jdbc.initialSize}"/>
        <!-- 最大併發鏈接數量 -->
        <property name="maxActive" value="${jdbc.maxActive}"/>
        <!-- 最小空閒鏈接數 -->
        <property name="minIdle" value="${jdbc.minIdle}"/>
        <!-- 配置獲取鏈接等待超時的時間 -->
        <property name="maxWait" value="${jdbc.maxWait}" />
        <!-- 超過期間限制是否回收 -->
        <property name="removeAbandoned" value="${jdbc.removeAbandoned}" />
        <!-- 超過期間限制多長 -->
        <property name="removeAbandonedTimeout" value="${jdbc.removeAbandonedTimeout}" />
        <!-- 配置間隔多久才進行一次檢測，檢測須要關閉的空閒鏈接，單位是毫秒 -->
        <property name="timeBetweenEvictionRunsMillis" value="${jdbc.timeBetweenEvictionRunsMillis}" />
        <!-- 配置一個鏈接在池中最小生存的時間，單位是毫秒 -->
        <property name="minEvictableIdleTimeMillis" value="${jdbc.minEvictableIdleTimeMillis}" />
        <!-- 用來檢測鏈接是否有效的sql，要求是一個查詢語句-->
        <property name="validationQuery" value="${jdbc.validationQuery}" />
        <!-- 申請鏈接的時候檢測 -->
        <property name="testWhileIdle" value="${jdbc.testWhileIdle}" />
        <!-- 申請鏈接時執行validationQuery檢測鏈接是否有效，配置爲true會下降性能 -->
        <property name="testOnBorrow" value="${jdbc.testOnBorrow}" />
        <!-- 歸還鏈接時執行validationQuery檢測鏈接是否有效，配置爲true會下降性能  -->
        <property name="testOnReturn" value="${jdbc.testOnReturn}" />
        <property name="logAbandoned" value="true" />
        <!-- 配置監控統計攔截的filters，wall用於防止sql注入，stat用於統計分析 -->
        <property name="filters" value="stat" />
    </bean>

    <!-- MyBatis SqlSessionFactoryBean 配置 -->
    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        <property name="dataSource" ref="dataSource"/>
        <!-- 自動掃描Mapping.xml文件 -->
        <property name="mapperLocations" value="classpath:com/test/mapper/xml/*.xml"/>
        <!-- 配置MyBaties全局配置文件:mybatis-config.xml -->
        <property name="configLocation" value="classpath:mybatis-config.xml"/>
        <!-- 掃描model包 xml中parameterType就可使用類名，不用全路徑 -->
        <property name="typeAliasesPackage" value="com.test.model"/>
    </bean>

    <!-- 加載 mapper.xml對應的接口 配置文件 -->
    <bean id="mapperScannerConfigurer" class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <!-- 給出須要掃描mapper接口包 -->
        <property name="basePackage" value="com.test.mapper"/>
        <!-- 注入sqlSessionFactory -->
        <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory" />
    </bean>

    <!-- (事務管理)transaction manager, use JtaTransactionManager for global tx -->
    <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
        <property name="dataSource" ref="dataSource" />
    </bean>
    <tx:annotation-driven transaction-manager="transactionManager"/>

</beans>

 

三、mapper.xml文件是否能夠被正確掃描到，編譯後的文件中是否存在以及路徑是否正確

　　

 

 

<?xml version="1.0" encoding="UTF-8"?>
<web-app 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"
         version="3.0">

    <!--spring的其餘配置文件(包括mybatis配置文件) -->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>
            classpath*:spring-applicationContext.xml
        </param-value>
    </context-param>

    <!-- 編碼過濾器 -->
    <filter>
        <filter-name>encodingFilter</filter-name>
        <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
        <async-supported>true</async-supported>
        <init-param>
            <param-name>encoding</param-name>
            <param-value>UTF-8</param-value>
        </init-param>
    </filter>
    <filter-mapping>
        <filter-name>encodingFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

    <!-- Spring監聽器 監聽加載相關配置文件-->
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>
    <!--防止Spring內存溢出監聽器-->
    <listener>
        <listener-class>org.springframework.web.util.IntrospectorCleanupListener</listener-class>
    </listener>

    <!--Spring MVC servlet-->
    <servlet>
        <servlet-name>springmvc</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath*:spring-mvc.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>springmvc</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

    <welcome-file-list>
        <welcome-file>/index.jsp</welcome-file>
        <welcome-file>/index.html</welcome-file>
        <welcome-file>/reg.html</welcome-file>
    </welcome-file-list>
</web-app>