背景

在springboot中有很多約定大于配置的規(guī)則，如果我們準(zhǔn)守了約定，可以零配置。mybatsi中Mapper和xml文件之間有很多約定俗稱(chēng)的規(guī)則，比如名稱(chēng)匹配，包掃描，別名等，這些規(guī)則是什么。如果想更加靈活，該如何配置呢？今天就給大家講一下如何配置mybatsi的xml文件等。

一、@Mapper注解和@MapperScan注解使用說(shuō)明

• 可以不使用@MapperScan注解，默認(rèn)掃描根路徑下標(biāo)注了@Mapper注解的接口
• 可以使用@Mapper注解，使用@MapperScan(“com.kouryoushine.mybatis.demo.mapper”)，告訴spring該包下的接口都作為Mapepr對(duì)象掃描到容器中
• 兩個(gè)注解都不使用，報(bào)如下錯(cuò)誤。在根路徑下掃描不到任何Mapper
• No MyBatis mapper was found in ‘[com.kouryoushine.mybatis.demo]' package. Please check your configuration.

二、 mapper代理方法必須一致

mapper代理方法

–程序員只需要mapper接口和mapper.xml映射文件，mybatis可以自動(dòng)生成mapper接口實(shí)現(xiàn)類(lèi)代理對(duì)象。
–程序員編寫(xiě)mapper接口需要遵循一些開(kāi)發(fā)規(guī)范。

mapper代理開(kāi)發(fā)規(guī)范

•  在mapper.xml中namespace等于mapper接口地址
• mapper.java接口中的方法名和mapper.xml中statement的id一致
• mapper.java接口中的方法輸入?yún)?shù)類(lèi)型和mapper.xml中statement的parameterType指定的類(lèi)型一致。
• mapper.java接口中的方法返回值類(lèi)型和mapper.xml中statement的resultType指定的類(lèi)型一致。
• mapper.xml文件名應(yīng)該和接口名保持一致，否則也可能出現(xiàn)不匹配

二、xml文件的位置

位置1：放在resource目錄下相同目錄結(jié)構(gòu)

這種方式無(wú)需額外的配置，但并不推薦。

位置2：放在resource下任意目錄

比如指定mapper-location的位置，否則掃描不到

mybatis:
  mapper-locations: classpath:/mapper/*.xml

位置3：和mapper接口放在同一目錄下

這種情況下比較特殊，其實(shí)是能掃描到這個(gè)xml文件的，只是打包時(shí)不會(huì)打進(jìn)去?？梢酝ㄟ^(guò)添加如下配置將xml打包進(jìn)去。

<build>
    <resources>
        <!-- 掃描src/main/java下所有xx.xml文件 -->
        <resource>
            <directory>src/main/java</directory>
            <includes>
                <include>**/*.xml</include>
            </includes>
        </resource>
        <!-- 掃描resources下所有資源 -->
        <resource>
            <directory>src/main/resources</directory>
        </resource>
    </resources>
</build>

注：沒(méi)有上述配置時(shí)target是沒(méi)有mapper.xml文件的，大家可以自己嘗試

總結(jié)

雖然有多種方式都可以達(dá)成配置，但還是推薦加上注解同時(shí)指定好掃描路徑。

以上就是mybatis那些約定的配置你真的都了解嗎的詳細(xì)內(nèi)容，更多關(guān)于mybatis配置的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論