一. 問(wèn)題背景

今天我在講完MyBatis后，學(xué)生在進(jìn)行代碼練習(xí)時(shí)遇到了下面這樣的一個(gè)異常，先上圖：

二. 問(wèn)題分析

1.原因分析

首先我們看到，這里拋出的異常是org.apache.ibatis.binding.BindingException，接著再看異常的信息是 Invalid bound statement (not found): com.qf.mapper.EmpMapper.list?；谶@兩點(diǎn)，我們大概能定位到是Mapper綁定產(chǎn)生的異常。

我們知道，在MyBatis中我們需要先定義一個(gè)Mapper接口，在接口中定義方法。然后再定義一個(gè)Mapper.xml，在XML文件中編寫(xiě)方法對(duì)應(yīng)的SQL語(yǔ)句，這也是java代碼和sql語(yǔ)句分離的體現(xiàn)。我們?cè)谡{(diào)用Mapper接口中的方式時(shí)MyBatis會(huì)給我們創(chuàng)建一個(gè)該接口的代理類(lèi)，通過(guò)代理類(lèi)來(lái)調(diào)用Mapper接口中的方法。

現(xiàn)在有了代理就可以調(diào)用方法了，但是怎么找到這個(gè)方法對(duì)應(yīng)的SQL語(yǔ)句呢？此時(shí)就需要把Mapper接口和Mapper.xml進(jìn)行綁定，只有綁定了MyBatis才知道方法對(duì)應(yīng)的sql語(yǔ)句，我們通過(guò)代理調(diào)用方法時(shí)才能正常運(yùn)行sql語(yǔ)句。那么這個(gè)異常就是報(bào)的綁定異常，說(shuō)沒(méi)有找到com.qf.mapper.EmpMapper.list()對(duì)應(yīng)的sql語(yǔ)句。

那如何把它們兩個(gè)綁定呢？看下面代碼。

2.定義EmpMapper接口

package com.qf.mapper;
import com.qf.core.dao.BaseDao;
import com.qf.entity.Emp;
import org.omg.CORBA.INTERNAL;
 
public interface EmpMapper extends BaseDao<Emp> {
    public Emp selectById(Integer empno);
}

3.定義EmpMapper.xml

<?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.qf.mapper.EmpMapper">
  <select id="list" resultType="emp">
    select * from t_emp
  </select>
</mapper>

在Mapper.xml中通過(guò)namespace屬性和接口綁定，這個(gè)屬性中設(shè)置的需要綁定的接口全類(lèi)名。這里設(shè)置的是com.qf.mapper.EmpMapper，就代表當(dāng)前EmpMapper.xml就和EmpMapper.java綁定了。然后在通過(guò)<select>標(biāo)簽中的id和接口中的方法名稱(chēng)保持一致，這樣就完成了方法和sql語(yǔ)句的綁定。這些操作都配置完成后MyBatis才能正常運(yùn)行，調(diào)用方法時(shí)才可以找到對(duì)應(yīng)的SQL語(yǔ)句。

4.問(wèn)題原因

現(xiàn)在知道MyBatis的綁定的過(guò)程了，我們繼續(xù)回到上面提到的異常。

通過(guò)檢查學(xué)生的代碼發(fā)現(xiàn)，這個(gè)學(xué)員只是在Mapper接口中定義了方法，但是沒(méi)有在Mapper.xml中編寫(xiě)的sql語(yǔ)句，所以MyBatis找不到sql語(yǔ)句就拋出了上面的異常。

三. 異常解決

對(duì)于上面的異常，其實(shí)我們只需要在Mapper.xml中添加對(duì)應(yīng)的sql語(yǔ)句就可以解決。該學(xué)員的這個(gè)bug的原因是因?yàn)闆](méi)有寫(xiě)sql語(yǔ)句導(dǎo)致的。但是除了這個(gè)原因外，還有其他的場(chǎng)景也會(huì)導(dǎo)致出現(xiàn)這個(gè)bug，在這里都統(tǒng)一列出來(lái)方便大家學(xué)習(xí)，常見(jiàn)原因如下。

1.Mapper.xml中的namespace屬性寫(xiě)錯(cuò)了

2.Mapper.java中的方法名稱(chēng)和Mapper.xml中標(biāo)簽id的屬性不一致

3.Mapper.java中定義了方法，但是沒(méi)有寫(xiě)Mapper.xml中對(duì)應(yīng)的slq語(yǔ)句

4.Mapepr.xml沒(méi)有給MyBatis注冊(cè)

5.Mapepr.xml中的id最好和方法名稱(chēng)保持一致，而且Mapper.java中的方法名稱(chēng)不要重載。方法中是可以重載的，但是Mapepr.xml中的id是不允許重復(fù)的。

四. 結(jié)語(yǔ)

現(xiàn)在你知道Mybatis的BindingException綁定異常是怎么產(chǎn)生，以及怎么解決的了嗎？

到此這篇關(guān)于Mybatis中BindingException異常的產(chǎn)生原因及解決過(guò)程的文章就介紹到這了,更多相關(guān)MyBatis BindingException異常解決內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論