fastmybatis是什么？

fastmybatis是一个mybatis开发框架，其宗旨为：简单、快速、有效。

• 零配置快速上手

• 无需编写xml文件即可完成CRUD操作

• 支持mysql，sqlserver，oracle，postgresql,sqlite

• 支持自定义sql，sql语句可写在注解中或xml中

• 支持与spring-boot集成，依赖starter即可

• 轻量级，无侵入性，是官方mybatis的一种扩展

快速开始（springboot）

• 新建一个 springboot 项目

• pom.xml 添加 fastmybatis-spring-boot-starter

  <dependency>    <groupId>net.oschina.durcframework</groupId>    <artifactId>fastmybatis-spring-boot-starter</artifactId>    <version>1.0.2</version></dependency>

• 假设数据库有张 t_user 表，添加对应的实体类TUser.java和 MapperTUserMapper.java

• 在 application.propertis 中配置数据库连接

• 编写测试用例

@AutowiredTUserMapper mapper;    // 根据主键查询@Testpublic void testGetById() {    TUser user = mapper.getById(3);    System.out.println(user);}

fastmybatis中的Mapper提供了一系列增删改查的方法，满足日常所需，完整方法说明如下表所示：

方法	说明
E getByColumn(String column, Object value)	根据字段查询一条记录
E getById(I id)	根据主键查询
E getByQuery(Query query)	根据条件查找单条记录
E getBySpecifiedColumns(List<String> columns, Query query)	查询单条数据并返回指定字段
<T> T getBySpecifiedColumns(List<String> columns, Query query, Class<T> clazz)	查询单条数据返回指定字段并转换到指定类中
<T> T getColumnValue(String column, Query query, Class<T> clazz)	查询某一行某个字段值
long getCount(Query query)	查询总记录数
List<E> list(Query query)	查询结果集
List<E> listByArray(String column, Object[] values)	根据多个字段值查询结果集
List<E> listByCollection(String column, Collection<?> values)	根据字段多个值查询结果集
List<E> listByColumn(String column, Object value)	根据字段查询结果集
List<E> listByIds(Collection<I> ids)	根据多个主键查询
List<E> listBySpecifiedColumns(List<String> columns, Query query)	查询返回指定的列，返回实体类集合
<T> List<T> listBySpecifiedColumns(List<String> columns, Query query, Class<T> clazz)	查询返回指定的列，返指定类集合
<T> List<T> listColumnValues(String column, Query query, Class<T> clazz)	查询指定列，返指定列集合
PageInfo<E> page(Query query)	分页查询
<R> PageInfo<R> page(Query query, Function<E, R> converter)	查询结果集，并转换结果集中的记录，转换处理每一行
<R> PageInfo<R> page(Query query, Supplier<R> target, Consumer<R> format)	查询结果集，并转换结果集中的记录，并对记录进行额外处理
<T> PageInfo<T> page(Query query, Supplier<T> target)	查询结果集，并转换结果集中的记录
<R> PageInfo<R> pageAndConvert(Query query, Function<List<E>, List<R>> converter)	查询结果集，并转换结果集中的记录，转换处理list
<T> PageInfo<T> pageBySpecifiedColumns(List<String> columns, Query query, Class<T> clazz)	查询返回指定的列，返回分页数据
PageEasyui<E> pageEasyui(Query query)	查询返回easyui结果集
<T> PageEasyui<T> pageEasyui(Query query, Class<T> clazz)	查询返回easyui结果集，并转换结果集中的记录
E forceById(I id)	根据主键查询强制查询，忽略逻辑删除字段
int save(E entity)	保存，保存所有字段
int saveBatch(Collection<E> entitys)	批量保存
int saveIgnoreNull(E entity)	保存，忽略null字段
int saveMultiSet(Collection<E> entitys)	批量保存,兼容更多的数据库版本,忽略重复行，此方式采用union的方式批量insert
int saveOrUpdate(E entity)	保存或修改，当数据库存在记录执行UPDATE，否则执行INSERT
int saveOrUpdateIgnoreNull(E entity)	保存或修改，忽略null字段，当数据库存在记录执行UPDATE，否则执行INSERT
int saveUnique(Collection<E> entitys)	批量保存，去除重复行，通过对象是否相对判断重复数据，实体类需要实现equals方法
int saveUnique(Collection<E> entitys, Comparator<E> comparator)	批量保存，去除重复行，指定比较器判断
int update(E entity)	更新，更新所有字段
int updateByQuery(E entity, Query query)	根据条件更新
int updateIgnoreNull(E entity)	更新，忽略null字段
int updateByMap(Map<String, Object> map, Query query)	根据条件更新，map中的数据转化成update语句set部分，key为数据库字段名
int delete(E entity)	删除，在有逻辑删除字段的情况下，做UPDATE操作
int deleteByColumn(String column, Object value)	根据指定字段值删除，在有逻辑删除字段的情况下，做UPDATE操作
int deleteById(I id)	根据id删除，在有逻辑删除字段的情况下，做UPDATE操作
int deleteByIds(Collection<I> ids)	根据多个主键id删除，在有逻辑删除字段的情况下，做UPDATE操作
int deleteByQuery(Query query)	根据条件删除，在有逻辑删除字段的情况下，做UPDATE操作
int forceDelete(E entity)	强制删除（底层根据id删除），忽略逻辑删除字段，执行DELETE语句
int forceDeleteById(I id)	根据id强制删除，忽略逻辑删除字段，执行DELETE语句
int forceDeleteByQuery(Query query)	根据条件强制删除，忽略逻辑删除字段，执行DELETE语句
<K> Map<K, E> getMap(Query query, Function<E, K> keyGetter)	查询结果并转换成Map对象
<T extends TreeNode<T, I>> List<T> listTreeData(Query query, I rootId)	查询列表并将结果转换成树结构

Query查询

Query是一个查询参数类，配合Mapper一起使用。

参数介绍

Query里面封装了一系列查询参数，主要分为以下几类：

• 条件参数：设置查询条件

• 分页参数：设置分页

• 排序参数：设置排序字段

下面逐个讲解每个参数的用法。

条件参数

条件参数是用的最多一个，因为在查询中往往需要加入各种条件。fastmybatis在条件查询上面做了一些封装。

条件参数使用非常简单，Query对象封装一系列常用条件查询。

• 等值查询eq(String columnName, Object value)，columnName为数据库字段名，value为查询的值

假设我们要查询姓名为张三的用户，可以这样写：

Query query = new Query();query.eq("username","张三");List<User> list = mapper.list(query);

还可以通过条件动态判断是否需要添加条件

String username = ..Query query = new Query();// 如果username不为空则生成where条件query.eq(StringUtils.hasText(username), "username", username);List<User> list = mapper.list(query);

等同于：

String username = ..Query query = new Query();// 如果username不为空则生成where条件if (StringUtils.hasText(username)) {    query.eq("username", username);}List<User> list = mapper.list(query);

显然第一种更加简洁。

通过方法名即可知道eq表示等于'='，同理lt表示小于<,gt表示大于>

查询方式	说明
eq	等于=
gt	大于>
lt	小于<
ge	大于等于>=
le	小于等于<=
notEq	不等于<>
like	模糊查询
in	in()查询
notIn	not in()查询
between	between查询
isNull	NULL值查询
notNull	IS NOT NULL
notEmpty	字段不为空，非NULL且有内容
isEmpty	字段为NULL或者为''

fastmybatis开发文档

https://durcframework.gitee.io/fastmybatis/#/

fastmybatis与MyBatis generator对比

条件搜索，不确定条件的个数：

• MyBatis generator

UserExample ex = new UserExample();Criteria criteria = ex.createCriteria();if(StringUtils.isNotBlank(user.getAddress())){  criteria.andAddressEqualTo(user.getAddress());}if(StringUtils.isNotBlank(user.getName())){  criteria.andNameEqualTo(user.getName());}List<User> userList = userDao.selectByExample(ex);

• fastmybatis

Query query = new Query()    .eq(StringUtils.isNotBlank(user.getAddress()), "address",user.getAddress())    .eq(StringUtils.isNotBlank(user.getName()), "name",user.getName());List<User> userList = userMapper.list(query);

一个个加太麻烦，还可以这样：

Query query = Query.build(user); // user中不为空的字段添加到条件中List<User> userList = userMapper.list(query);

• MyBatis generator需要配置generatorConfig.xml，配置较为繁琐，生成的代码量多

• fastmybatis有配套的代码生成工具，配置简单，只需生成实体类和Mapper文件

猜您喜欢：

【提效】ChatGPT

【提效】JDK8以上提高开发效率的方法（上）

【提效】JDK8以上提高开发效率的方法（下）

【了解】Spring的代理模式

【了解】Spring的适配器模式

微服务微信交流群添加微信，备注“微服务”进群交流，备注“低开”进低开群交流

关注公众号 soft张三丰