Mybatis开发团队为Spring Boot 提供了MyBatis-Spring-Boot-Starter方便使用。
要使用MyBatis-Spring-Boot-Starter模块,只需要在类路径中包含
mybatis-spring-boot-autoconfigure.jar文件及其依赖项(mybatis.jar,mybatis -spring.jar等) 。
下面介绍的是我用到的一部分功能,全部功能还请查阅官方文档
一、使用
如果您正在使用Maven,只需将以下依赖项添加到您的pom.xml中:
org.mybatis.spring.bootmybatis-spring-boot-starter2.0.0-SNAPSHOT
版本自己可选:
需要注意的是:在Spring 中使用mybatis 最少需要 一个SqlSessionFactory 和 mapper 接口
引入MyBatis-Spring-Boot-Starter 模块后 将自动提供以
下功能
自动检测现有的数据源。
将创建并注册一个SqlSessionFactory的实例,使用SqlSessionFactoryBean作为输入传递该DataSource。
将创建并注册SqlSessionFactory的SqlSessionTemplate实例。
自动扫描您的“Mapper”,将它们链接到SqlSessionTemplate并将它们注册到Spring上下文,以便将它们注入到bean中。
就是说,使用了该Starter之后,只需要定义一个DataSource即可,它会自动创建使用该DataSource的SqlSessionFactoryBean以及SqlSessionTemplate,会自动扫描你的Mappers,连接到SqlSessionTemplate,并注册到Spring上下文中。
二 、配置
与其他Spring Boot应用程序一样,MyBatis-Spring-Boot-Application配置参数存储在application.properties(或application.yml)内部。使用前缀 mybatis
可用的属性有:
config-location :MyBatis. xml配置文件的位置。
check-config-location: 指示是否执行MyBatis .xml配置文件的存在检查
mapper-locations:Mapper. xml配置文件的位置。
type-aliases-package : 一般是放在model(或实体类) 上 ,别名替换,默认是去掉包名。
type-handlers-package:用于搜索类型处理程序的包所在位置
configuration-properties:MyBatis配置的外部化属性。 指定的属性可以用作MyBatis配置文件和Mapper文件的占位符。
configuration:一个MyBatis配置bean。 关于可用的属性,请参阅MyBatis参考页面。 注意此属性不能与配置位置(config-location)同时使用。
红色标注为常用属性
例:
# application.propertiesmybatis.type-aliases-package=com.example.domain.modelmybatis.type-handlers-package=com.example.typehandlermybatis.configuration.map-underscore-to-camel-case=truemybatis.configuration.default-fetch-size=100mybatis.configuration.default-statement-timeout=30
三、真实使用过程
1、pom中引入 MyBatis-Spring-Boot-Starter
org.mybatis.spring.bootmybatis-spring-boot-starter2.0.0-SNAPSHOT
2、配置数据源
直接在application.properties 中
3、在application.properties 中配置Mapper.xml 的扫描
4、编写Mapper接口,和Mapper.xml
Mapper 接口要加@Mapper 注解
MyBatis-Spring-Boot-Starter将默认搜索标记有@Mapper注解的映射器。
您可能需要指定自定义注解或标记界面进行扫描。 如果是这样,你必须使用@MapperScan注解。
默认不用加这个注解