Mybatis中接口和对应的mapper文件位置配置深入剖析

摘要:
首先要说明的问题是,Mybatis中接口和对应的mapper文件不一定要放在同一个包下,放在一起的目的是为了Mybatis进行自动扫描,并且要注意此时java接口的名称和mapper文件的名称要相同,否则会报异常,由于此时Mybatis会自动解析对应的接口和相应的配置文件,所以就不需要配置mapper文件的位置了。

首先要说明的问题是,Mybatis中接口和对应的mapper文件不一定要放在同一个包下,放在一起的目的是为了Mybatis进行自动扫描,并且要注意此时java接口的名称和mapper文件的名称要相同,否则会报异常,由于此时Mybatis会自动解析对应的接口和相应的配置文件,所以就不需要配置mapper文件的位置了。

1. 接口和文件在同一个包中

1.1 默认maven构建

如果在工程中使用了maven构建工具,那么就会出现一个问题:我们知道在典型的maven工程中,目录结构有:src/main/javasrc/main/resources,前者是用来存放java源代码的,后者则是存放一些资源文件,比如配置文件等,在默认的情况下maven打包的时候,对于src/main/java目录只打包源代码,而不会打包其他文件。所以此时如果把对应的mapper文件放到src/main/java目录下时,不会打包到最终的jar文件夹中,也不会输出到target文件夹中,由于在进行单元测试的时候执行的是/target目录下/test-classes下的代码,所以在测试的时候也不会成功。

为了实现在maven默认环境下打包时,Mybatis的接口和mapper文件在同一包中,可以通过将接口文件放在src/main/java某个包中,而在src/main/resources目录中建立同样的包,这是一种约定优于配置的方式,这样在maven打包的时候就会将src/main/javasrc/main/resources相同包下的文件合并到同一包中。

在默认maven打包的环境下,不要将接口文件和mapper文件全部放到src/main/java,这样也不会把mapper文件打包进去

简要的过程如下(与如下的例子无关):

- src/main/java
    - edu.zju.mapper
        - UserMapper.java
- src/main/resources
    - config.xml
    - edu.zju.mapper
        - UserMapper.xml

如上这种方式在maven打包之后的目录如下:

- src/main/java
    - config.xml
    - edu.zju.mapper
        - UserMapper.java
        - UserMapper.xml

具体的例子如下:

same_package1
这里写图片描述

src/main/javasrc/main/resources中相同的包名,相同的文件名,默认打包后的结构如下:

same_package2
这里写图片描述

发现打包之后已经到同一个包下了。

而当你把接口和mapper文件全部放到src/main/java中同一包时,返回结果如下:

same_package3
这里写图片描述

same_package4
这里写图片描述

发现编译打包之后并没有mapper文件,所以此时不管是测试还是正式执行都会出错!!

2.1 更改maven构建配置

如果不想将接口和mapper文件分别放到src/main/javasrc/main/resources中,而是全部放到src/main/java,那么在构建的时候需要指定maven打包需要包括xml文件,具体配置如下:

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

这样在打包的时候也会将mapper文件打包到/target文件夹中。

2. 接口和文件不在同一个包下

如果接口和mapper文件不在同一个包下,就不能进行自动扫描解析了,需要对接口和文件分别进行配置。

2.1 XML配置方式

2.1.1 不使用Spring

使用Mybatis的配置文件如下:

<?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>
  <mappers>
    <!--扫描路径下的mapper映射文件 -->
    <mapper resource="mappers/UserMapper.xml"/>
    <!--扫描包下的接口文件 -->
    <package name="edu.zju.bme.data.manage.mapper" />
  </mappers>
</configuration>

2.1.2 使用Spring

使用Spring的配置文件如下:

<beans xmlns="http://www.springframework.org/schema/beans"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns:mybatis="http://mybatis.org/schema/mybatis-spring"xsi:schemaLocation="
  http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
  http://mybatis.org/schema/mybatis-spring http://mybatis.org/schema/mybatis-spring.xsd">
  <!--配置接口存储的包,用来扫描mapper接口 -->
  <mybatis:scan base-package="edu.zju.bme.data.manage.mapper" />
  <bean id="sqlSessionFactory"class="org.mybatis.spring.SqlSessionFactoryBean">
    <!--配置mapper文件位置,扫描映射文件,可以使用Ant风格的路径格式 -->
    <property name="mapperLocations"value="classpath*:mappers/**/*.xml" />// ...
  </bean>
</beans>

免责声明:文章转载自《Mybatis中接口和对应的mapper文件位置配置深入剖析》仅用于学习参考。如对内容有疑问,请及时联系本站处理。

上篇Oracle Rowid 介绍Vue之登录基础交互下篇

宿迁高防,2C2G15M,22元/月;香港BGP,2C5G5M,25元/月 雨云优惠码:MjYwNzM=

相关文章

记一次Hvv中遇到的API接口泄露而引起的一系列漏洞

引言 最近朋友跟我一起把之前废弃的公众号做起来了,更名为鹿鸣安全团队,后面陆续会更新个人笔记,有趣的渗透经历,内网渗透相关话题等,欢迎大家关注 前言 Hvv中的一个很有趣的漏洞挖掘过程,从一个简单的API泄露到一系列漏洞。这次的经历更让我体会到了细心的重要性。 挖掘起始 Hvv中拿到了一大堆的资产,有IP和URL的,我一般会先去手动挖掘已经给了的URL资产...

使用 Fresco加载图片

概念: ImagePipeline ——负责从网络、本地图片、Content Provider(内容提供者)或者本地资源那里获取图片,压缩保存在本地存储中和在内存中保存为压缩的图片 Drawee——处理图片的渲染,由3部分组成: (1)DraweeView——显示图片的View,继承ImageView;大部分时间将使用SimpleDraweeView (2...

mybatis批量增、删、改(更新)操作oracle和mysql批量写法小记

前言:用mybatis也好几年了,mybatis在批量的增删操作也写起来也是比较简单的,只有批量更新这一块是特别坑,特此记录。注:本文主要用来记录oracle和mysql数据库在使用mybatis的情况下批量增、删、改(更新)的常用写法 一、批量插入1、oracle写法: <insert parameterType="cc.eguid.Zaixcs"...

循序渐进VUE+Element 前端应用开发(19)--- 后端查询接口和Vue前端的整合

循序渐进VUE+Element 前端应用开发的系列文章中,前面介绍了系统各个功能的处理实现,本篇随笔从一个主线上介绍前后端开发的整合,让我们从ABP框架后端的查询接口的处理,前端API接口调用的封装,以及前端Element界面的整个调用过程进行一个完整的介绍。 我们前面介绍了Vue+Element前端的接口是调用后端的ABP框架发布的API接口服务,API...

Tomcat8优化

一、Tomcat8优化   Tomcat服务器在JavaEE项目中使用率非常高,所以在生产环境对Tomcat的优化也变得非常重要了。   对于Tomcat的优化,主要是从2个方面入手,一是,Tomcat自身的配置,另一个是Tomcat所运行的jvm虚拟机的调优。 二、Tomcat配置优化 1、环境   虚拟机IP:192.168.33.136 2、部...

解读支付宝接口实现步骤

大家想必都有这种困惑——拿到支付宝的接口代码后,尽管里面的程序有注释,接口代码包中也附有开发说明,但还是不知道该如何入手。这不难想象是什么原因,因为自己并不了解这个接口的工作原理是什么?那么这篇文章就是要向大家全面展示关于支付宝接口的所有东西,以便大家能快速上手把接口接入自己的项目中,也能帮助那些已经对支付宝接口有所了解的程序开发者们更了解支付宝的一些通用...