FastMybatis

目录

1. 简介
2. 依赖
3. 配置文件
4. mapper层
5. Service层
6. Controller层

参考/来源：

• https://mp.weixin.qq.com/s/u-Qo5WFnMLfZmFhj9kXHIQ

简介

fastmybatis 是一个 mybatis 开发框架，其宗旨为：简单、快速、有效。零配置快速上手，无需编写 xml 文件即可完成 CRUD 操作。同时支持 mysql、sqlserver、oracle、postgresql、sqlite

依赖

<!-- https://mvnrepository.com/artifact/net.oschina.durcframework/fastmybatis-spring-boot-starter -->
		<dependency>
			<groupId>net.oschina.durcframework</groupId>
			<artifactId>fastmybatis-spring-boot-starter</artifactId>
			<version>2.2.8</version>
		</dependency>
		<!-- MySQL -->
		<dependency>
			<groupId>mysql</groupId>
			<artifactId>mysql-connector-java</artifactId>
			<scope>runtime</scope>
		</dependency>

配置文件

server:
   port: 80
   
spring:
   datasource :
       url : jdbc:mysql://localhost:3306/test
       username : root
       password : qianhao123
       driver-class-name : com.mysql.jdbc.Driver

mapper层

//@Mapper, 注意这里不用标记，也不用在主类扫描，很奇怪！有点类似于Spring Data风格
public interface UserMapping extends CrudMapper<User, Integer>{

}

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语句

Query查询对象

//查询姓名为张三，并且年龄为22岁的用户：
Query query = new Query().eq("username","张三").eq("age",22);
List<User> users = mapper.list(query);

//查询年龄为10,20,30的用户：
Query query = new Query().in("age",Arrays.asList(10,20,30));
List<User> users = mapper.list(query);

//查询注册日期大于2017-11-11的用户：
Date regDate = ...
Query query = new Query().gt("reg_date",regDate);
List<User> users = mapper.list(query);
//
查询性别为男的，年龄大于等于20岁的用户，按年龄降序：
Query query = new Query().eq("gender",1).ge("age",20).orderby("age",Sort.DESC);
List<User> users = mapper.list(query);

//分页查询：
Query query = new Query().eq("age",10).page(1,10); // 第一页，每页10条数据
List<User> users = mapper.list(query);

//查询总记录数：
Query query = new Query().eq("age",10).page(1,10); // 第一页，每页10条数据
long total = mapper.getCount(query); // 该条件下总记录数

Service层

实现通用接口IService

@Service
public class UserService implements IService<User, Integer>{

}

Controller层

@RestController
public class UserController {

	@Autowired
	private UserService userService;
	
	/**
	 * 查询所有记录
	 * @return
	 */
	@RequestMapping("/getAll")
	public String getAll() {
		List<User> list = userService.list(new Query());
		return JSON.toJSONString(list);
	}
	
	/**
	 * 分页查询所有记录
	 * @param pageindex
	 * @param pagesize
	 * @return
	 */
	@RequestMapping("/pageQuery")
	public String pageQuery(int pageindex, int pagesize) {
		Query page = new Query().page(pageindex, pagesize);
		PageInfo<User> info = userService.page(page);
		return JSON.toJSONString(info.getList());
	}
	
	/**
	 * 插入一个用户记录
	 * @param user
	 * @return
	 */
	@RequestMapping("/addUser")
	public String addUser(User user) {
		try {
			userService.save(user);
			return "save user ok";
		} catch (Exception e) {
			// TODO: handle exception
			e.printStackTrace();
			return "save user failed";
		}
	}
}

主类

@SpringBootApplication
public class FastMybaitsDemoApplication {

	public static void main(String[] args) {
		SpringApplication.run(FastMybaitsDemoApplication.class, args);
	}

}