simple-mybatis

前言

随着springboot开发方式的流行,但是还有好多人在使用mybatis时依旧采用xml的方式配置mapper,该框架出现的主要原因是为了让Mybatis更方便的在springboot项目下上使用。

框架说明

• 框架依赖并兼容jpa注解
• 提供了常用操作的Mapper封装
• 基于pagehelper提供了分页的规范支持
• 提供Query方式对查询语句的支持
• 提供Tree数据格式的规范支持

仓库地址

<dependency>
<groupId>com.codingapi</groupId>
<artifactId>simple-mybatis</artifactId>
<version>${last.version}</version>
</dependency>

使用说明

• jpa注解的使用

@Data@Table(name = "t_demo")
publicclassDemoimplementsITree<Long>{ //ITree根据业务需要可不实现//Id 注解 @IdprivateLongid;
//数据库字段与属于想一致时可忽略@Column注解privateLongsuperId;
privateStringname;
//字段名称 @Column(name = "s_module")
privateStringmodule;
privateStringmyName;
//忽略字段 @TransientprivateStringtest;
}

• CommandMapper 提供了所有常用的写操作

//保存数据，会返回主键Idintsave(Tt);
//批量保存 intsaveAll(List<T> list);
//修改数据，修改数据只会替换非null对象intupdate(Tt);
//删除数据，删除条件为Idintdelete(Tt);
//批量删除，删除条件为IdintdeleteAll(List<T> list);
//通过Id直接删除intdeleteById(Objectid);
//通过Id批量删除intdeleteAllById(Listid);

• QueryMapper提供常用的查询操作

//通过Id查询TgetById(Objectid);
//查询属于数据List<T> findAll();
//通过Query查询数据List<T> query(Queryquery);
//通过Query查询试图数据，返回List Map对象List<Map<String,Object>> queryMap(Queryquery);
//通过Query查询试图数据，返回List Bean对象
<V> List<V> queryView(Class<V> clazz, Queryquery);

• SimpleMapper提供了QueryMapper与CommandMapper的功能

• IPageQuery 提供基于MybatisHelper的分页支持

PageList<Demo> pageList = demoMapper.page(1, 5, demoMapper::findAll);
log.info("page:{}",pageList);

• ITreeQuery 提供树形数据结构组装

//实现ITree接口publicclassDemoimplementsITree<Long>{
//fields get set ...
}
List<TreeList<Demo>> treeLists = demoMapper.tree( demoMapper::findAll,0L);
log.info("treeLists:{}",treeLists);

• query使用说明
  query 通过QueryBuilder来创建，当查询返回的是表的数据，则不需要写select语句，直接拼接where()查询条件。
  若查询返回的是视图格式的数据则需要写select语句，select语句中可以写join关联.
  select语句中的字段可以用下划线，也可以直接处理成小驼峰。都可以转成java bean对象。

@TestvoidviewList(){
List<DemoView> list =
demoMapper.queryView(
DemoView.class,
QueryBuilder.Build()
.select("select * from t_demo d left join t_refrigerator r on d.id = r.ID ")
.where()
.condition("d.id between #{small} and #{larger}", Map.of("small",1,"larger",10))
.or()
.condition("r.state = #{state}",1)
.and()
.condition("d.id in (${ids})",1,2,3,4,5,6,7,8,9,10)
.or()
.condition("d.name like '%${name}%'","2")
.orderBy("d.id desc")
.builder());
log.info("list:{}",list);
}
@TestvoidqueryList(){
//select * from t_demo where name = '123'List<Demo> list = demoMapper.query(QueryBuilder.Build().where().condition("name=#{name}","123").builder());
log.info("list:{}",list);
}

示例

https://github.com/1991wangliang/simple-mybatis-demo

支持

issue

使用建议

设计数据库时可以先定义类,然后通过jap扫描这些entity来创建数据库，这样做不仅可以完成数据库的设计，也可以直接完成entity的定义，由于框架兼任了jpa注解也不会在框架使用这些entity上出现错误。