更新日志：
新增批量修改接口
优化实体类解析和加载
[github地址](https://github.com/VonChange/spring-data-mybatis-mini)
[gitee地址](https://gitee.com/vonchange/spring-data-mybatis-mini)
[blog](http://www.vonchange.com/doc/mini.html)
等同于spring data jdbc + mybatis 动态sql能力
大道至简 极致效率 麻雀虽小 五脏俱全
-
抛弃繁琐的xml 只使用mybatis模版引擎即动态sql能力 sql写在markdown文件里 更容易书写和阅读 sql能统一管理查看
-
底层基于springJdbc 而不是mybatis,相当于底层直接使用jdbc 更高效
-
提供单表增删改 批量更新插入等基础方法 支持分页 多数据源 读写分离
-
mybatis最大优点就是sql模版引擎 我也有且仅有使用这部分功能(对于使用过mybatis的无学习成本) 但底层使用springJDBC 更简单直接
-
简化mybatis动态sql写法(可混用-写法还是mybatis那套) 比如
[@and id in idList] 等于
<if test="null!=idList and idList.size>0"> and id in <foreach
collection="idList" index="index" item="item" open="(" separator=","
close=")">#{item}</foreach></if>
![例子]()
== Getting Started
- 提供单表增删改(没有物理删除) 批量更新插入等基础方法
- 抛弃繁琐的xml 所有sql 写在markdown文件里 便于书写和阅读 默认位置sql包下repository接口名.md @ConfigLocation 可自定义位置
- 自定义更新 @Update/@Insert或者update/save/insert/delete 开头方法是更新操作
- 支持分页
- 对于 " > "," < "," >= "," <= "," <> "无需转义(两边需有空格 我会自动替换转义)
- 提供if判断和in查询简写方式(偷懒 >-<)
- 注解属于spring data jpa 体系的
- 支持sql片段 [@sql XX] XX markdown文件XX名的sql片段
- 查询返回实体 不需要必须是DO 如果没特殊规范 也可直接返回VO层实体(抛弃繁琐的DO->DTO->VO 偷懒轻喷)
- 支持批量更新插入（jdbc链接参数需加入rewriteBatchedStatements=true&allowMultiQueries=true）
- 分页某些特性支持mysql,oracle 主支持mysql 可自定义方言实现其他数据库
- 使用简单 约定大于配置 默认配置基本都满足
- 支持LocalDateTime LocalTime jdk8更方便的时间类型
== 其他特性 无特殊需要可不用关心
- 分页 可自定义同名+Count的sql 优化分页
- 支持读写分离 根据业务逻辑添加@ReadDataSource在方法名上 默认配置多数据源随机取 可自定义
- 多数源支持但在微服务化潮流里尽量保证同一数据源
== 使用步骤基本同jpa,spring data jdbc
- 添加依赖
- @EnableMybatisMini
- extends BaseRepository<UserBaseDO, Long> 或 extends BaseQueryRepository(只查询)
- 使用例子demo项目spring-data-mybatis-mini-demo
Here is a quick teaser of an application using Spring Data mybatis mini in Java:
=== Maven configuration
Add the Maven dependency:
<!-- spring boot 2.x 是使用版本2.3.6 -->
<dependency>
<groupId>com.vonchange.common</groupId>
<artifactId>spring-data-mybatis-mini</artifactId>
<version>2.3.8</version>
</dependency>
<dependency>
<groupId>org.springframework.data</groupId>
<artifactId>spring-data-commons</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-jdbc</artifactId>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.15</version>
</dependency>
<!-- 低版本比如1.5.x 使用版本low-1.9.6-->
<dependency>
<groupId>com.vonchange.common</groupId>
<artifactId>spring-data-mybatis-mini-low</artifactId>
<version>1.9.6</version>
</dependency>
//添加 EnableMybatisMini 注解
@EnableMybatisMini
@SpringBootApplication
public class DemoApplication {
public static void main(String[] args) {
SpringApplication.run(DemoApplication.class, args);
}
}
import org.springframework.data.mybatis.mini.jdbc.repository.query.ConfigLocation;
import org.springframework.data.mybatis.mini.jdbc.repository.support.BaseRepository;
import org.springframework.data.repository.query.Param;
public interface UserBaseRepository extends BaseRepository<UserBaseDO, Long> {
@ReadDataSource
List<UserBaseDO> findList(@Param("userName") String userName,
@Param("createTime") Date createTime);
Page<UserBaseDO> findList(Pageable pageable, @Param("userName") String userName,@Param("createTime") Date createTime);
String findUserName(@Param("userName") String userName);
List<UserBaseVO> findListByIds(@Param("userName") String userName,
@Param("createTime") Date createTime,@Param("idList")List<Long> idList);
int updateIsDelete(@Param("isDelete") Integer isDelete,@Param("id") Long id);
}
默认sql 包下同名吧UserBaseRepository.md 识别```开头结尾的 -- 定义的同名方法 参见UserBaseRepository.md
实体类 定义ID 和TABLE 名
import javax.persistence.Id;
import javax.persistence.Table;
@Data
@Table(name = "user_base")
public class UserBaseDO {
@Id
private Long id;
private String userName;
private String firstPhone;
}
@Service
public class MyService {
@Resource
private final UserBaseRepository userBaseRepository;
public void doWork() {
List<UserBaseDO> userBaseDOList = userBaseRepository.findList("test",new Date());
}
}
偷懒简化 if test 和in查询 识别 [@开头判空 [@@开头不会判空
[@and id in idList] 等于
<if test="null!=idList and idList.size>0"> and id in <foreach
collection="idList" index="index" item="item" open="(" separator=","
close=")">#{item}</foreach></if>
[@@and id in idList] 等于
and id in <foreach
collection="idList" index="index" item="item" open="(" separator=","
close=")">#{item}</foreach>
[@and user_name <> userName] 等于
<if test="null!=userName and ''!=userName"> and user_name <>
#{userName} </if>
-
in 查询List实体下的属性 [@and id in userList:id]
-
like
[@and user_name like userName] 等于 and user_name like CONCAT('%',?,'%')
[@and user_name like userName%] 等于 and user_name like CONCAT(?,'%')
[@and user_name like userName%] 等于 and user_name like CONCAT('%','test')
- 其他非4个分隔
[@and id in #{idList:in} and user_name like #{userName:like}]
等于
<if test="@com.vonchange.mybatis.tpl.MyOgnl@isNotEmpty(idList) and @com.vonchange.mybatis.tpl.MyOgnl@isNotEmpty(userName) "> and id in <foreach collection="idList" index="index" item="item" open="(" separator="," close=")">#{item}</foreach> and user_name like CONCAT('%',#{userName},'%') </if>
[@AND content -> '$.account' = #{bean.account}]
等于
<if test="null!=bean.account and ''!=bean.account">
AND content -> '$.account' = #{bean.account}
</if>
- [@sql XX] XX markdown文件XX名的sql片段
相关注解
-
@ColumnNot 非字段注解
-
InsertIfNull UpdateIfNull 插入或者更新为空时默认值 可使用函数
-
UpdateNotNull updateAllField方法NULL值忽略
-
ReadDataSource 指定某个方法读数据源 默认配置多数据源随机取
-
Update 更新语句 Insert 插入语句返回ID
//自定义 读库数据源 不自定义默认所有你设置的数据源
@Bean
public ReadDataSources initReadDataSources(){
return new ReadDataSources() {
@Override
public DataSource[] allReadDataSources() {
return new DataSource[]{mainDataSource(),mainDataSource(),readDataSource()};
}
};
}
批量更新插入
-
jdbc链接参数需加入rewriteBatchedStatements=true&allowMultiQueries=true
-
提供insertBatch(默认第一行不为NULL的字段) 可在markdown里自定义sql 无需关心List对象大小
-
经测试简单数据插入1万耗时1s以内
-
自定义实现(建议使用 更透明)
@BatchUpdate(size = 5000)
int batchInsert(List<UserBaseDO> list);
只需定义单条insert 语句
-- batchInsert
insert into user_base(`user_name`,`mobile_phone`,create_time) values
(#{userName},#{mobilePhone},#{createTime})
大数据量流式读取
-
使用场景: 不用编写复杂分包逻辑,表数据大小,可关联表查 可直接 select * from 整个表 不用关心内存爆调 流的方式读取
-
使用例子
定义方法
void findBigData(@Param("")AbstractPageWork<UserBaseDO> abstractPageWork,@Param("userName") String userName);
定义sql
-- findBigData
select * from user_base
<where>
[@and user_name like userName]
</where>
使用demo
AbstractPageWork<UserBaseDO> abstractPageWork = new AbstractPageWork<UserBaseDO>() {
@Override
protected void doPage(List<UserBaseDO> pageContentList, int pageNum, Map<String, Object> extData) {
pageContentList.forEach(userBaseDO -> {
log.info("{}",userBaseDO.toString());
});
}
@Override
protected int getPageSize() {
return 500;
}
};
userBaseRepository.findBigData(abstractPageWork,"三");
log.info("{} {} {}",abstractPageWork.getSize(),abstractPageWork.getTotalPages(),abstractPageWork.getTotalElements());
