ssm框架整合时及mybatis框架中org.apache.ibatis.builder.BuilderException异常出现的原因及解决办法

ssm框架整合时及mybatis框架的BuilderException异常主要有以下几个原因:

1、XxxMapper接口和XxxMapper.xml编译后不在同一个包下,
包名要完全一致
要注意的是编译后在一个包下,包名要完全一致才能保证编译后在一个包下,也可以将XxxMapper接口和XxxMapper.xml都放在java包下com.it.mapper包下
正确建包示范:

2.XxxMapper接口和XxxMapper.xml名字不一致
3、dao层XxxMapper接口对应的XxxMapper.xm配置文件中
namespace属性填错了或者少填`,应写为全包名,至具体接口名

xml配置文件中,错误的写法及正确的写法

//<mapper namespace="com.it.mapper">这是错误的,正确的应为

<mapper namespace="com.it.mapper.ItemMapper">

异常信息

rg.apache.ibatis.builder.BuilderException: Error parsing Mapper XML. Cause: org.apache.ibatis.builder.BuilderException: Wrong namespace. Expected 'com.it.mapper.ItemMapper' but found 'com.it.mapper'.

4、dao层XxxMapper接口对应的XxxMapper.xm配置文件中
sql标签的id与接口中的方法名不一致
正确示范:
接口

public interface ItemMapper {
    List<Item> queryAll()throws SQLException;
}

xml配置文件

<mapper namespace="com.it.mapper.ItemMapper">
    <select id="queryAll" resultType="item">
        SELECT * from item;
    </select>

5.如果没有上述问题,且在编译后target文件夹下只有mapper接口的class文件，而没有xml文件,则是maven编译时出现问题,在pom.xml中加入代码

<build>   
        <resources>  
            <resource>  
                <directory>src/main/java</directory>  
                <includes>  
                    <include>**/*.xml</include>  
                </includes>  
                <filtering>true</filtering>  
            </resource>  
        </resources>  
</build>

总结:出现ssm整合及mybatis框架中出现BuilderException主要是由于粗心写错名字或者是配置文件中namespace属性没有具体到接口
为了更好的避免此类错误,如果用的是idea,可以在idea插件中心中下载使用Free Mybatis plugin插件,能帮助我们动态填写XxxMapper.xml