Awesome
MyBatis Mapper integration with Spring Boot
Mapper-Spring-Boot-Starter 帮助你集成通用 Mapper 到 Spring Boot。
Mapper-Spring-Boot-Starter will help you use Mapper with Spring Boot.
本项目已经包含在 https://github.com/abel533/Mapper
https://github.com/abel533/Mapper/tree/master/spring-boot-starter
自 2.0.0 版本起,这个项目不在进行维护,后期还会删除该项目。
How to use
在 pom.xml 中添加如下依赖:
Add the following dependency to your pom.xml:
<dependency>
<groupId>tk.mybatis</groupId>
<artifactId>mapper-spring-boot-starter</artifactId>
<version>1.2.4</version>
</dependency>
1.2.4 - 2018-03-06
- 解决 mappers 参数不起作用的 bug。
- 通用 Mapper 升级到 3.5.3 版本。
- Spring Boot 升级到 2.0.0-RELEASE 版本。
- 解决 Spring Boot 兼容性问题 (
Binder
现在如果都不匹配就抛出异常了)。
1.2.3 - 2018-01-24
- 增加
tk.mybatis.spring.mapper.SpringBootBindUtil
,使用原生方式兼容 Spring Boot 1.x 和 2.x 版本,已经不存在 relax 值问题,以前的配置不需要修改即可使用。 - 特别注意,如果使用了
@MapperScan
注解,请使用tk.mybatis.spring.annotation.MapperScan
注解。 - 通用 Mapper 升级到 3.5.2 版本。
1.2.2
- 由于 weekend 版本依赖问题,这个版本存在问题,不作为正式发布版本。
1.2.1 - 2018-01-10
-
为了增强兼容性,
MapperAutoConfiguration
增加@AutoConfigureBefore(name = "org.mybatis.spring.boot.autoconfigure.MybatisAutoConfiguration")
即使依赖中存在 MyBatis 的 starter,Mapper 也可以优先使用自动配置,MyBatis后续就不会触发生成@Bean
-
支持简单的 relax 绑定,例如 not-empty 会转换为 notEmpty 使用,兼容 spring boot 配置方式
1.2.0 - 2018-01-08
- 通用 Mapper 3.5.0
- 去掉 mybatis-spring-boot-starter 依赖,不在使用 mybatis 官方 starter,使用通用 Mapper 时不要再引入官方 starter
- 参考 mybatis 官方 starter 重新实现,解决 mapper 初始化可能存在的问题 pr#5 by fengcbo
- 如果需要使用
@MapperScan
请选择 tk 开头的tk.mybatis.spring.annotation.MapperScan
1.1.7 - 2017-12-17
- 通用 Mapper 3.4.6
- spring-boot 1.5.9.RELEASE
1.1.6 - 2017-11-11
- 通用 Mapper 3.4.5
1.1.5 - 2017-10-21
- 通用 Mapper 3.4.4
- mybatis-starter 1.3.1
- spring-boot 1.5.8.RELEASE
1.1.4 - 2017-08-18
- 通用 Mapper 3.4.3
1.1.3 - 2017-07-18
- 通用 Mapper 3.4.2
1.1.2 - 2017-07-17
- 通用 Mapper 3.4.1
- mybatis 3.4.4
- mybatis-spring-boot 1.3.0
- spring-boot 1.5.4.RELEASE
1.1.1 - 2017-03-28
- 解决 1.1.0 版本不一致的问题
- 增加对多数据源的支持,感谢 邱占波的 PR #2
1.1.0 - 2017-02-19
- mybatis 升级到 3.4.2
- mapper 升级到 3.4.0
- mybatis-spring 升级到 1.3.1
- mybatis-spring-boot 升级到 1.2.0
- spring-boot 升级到 1.4.4.RELEASE
Example
Special Configurations
一般情况下,你不需要做任何配置。
Normally, you don't need to do any configuration.
如果需要配置,可以使用如下方式进行配置:
You can config PageHelper as the following:
application.properties:
mapper.propertyName=propertyValue
示例:
mapper.mappers[0]=tk.mybatis.sample.mapper.BaseMapper
mapper.mappers[1]=tk.mybatis.mapper.common.Mapper
默认情况下,没有 mappers 配置时,会自动注册 tk.mybatis.mapper.common.Mapper
因为通用 Mapper 是固定的属性,所以接收参数使用的对象,按照 Spring Boot 配置规则,大写字母都变了带横线的小写字母。针对如 IDENTITY(对应i-d-e-n-t-i-t-y)提供了全小写的 identity 配置,如果 IDE 能自动提示,看自动提示即可。
IDE 应该可以自动提示: