快速开始（springboot）

• 新建一个 Spring boot 项目

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

<dependency>
 <groupId>net.oschina.durcframework</groupId>
 <artifactId>fastmybatis-spring-boot-starter</artifactId>
 <version>最新版本</version>
</dependency>

• 增删改查例子

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

/**
 * 增删改查例子
 */
@RestController
public class CrudController {

 @Autowired
private UserService userService;


/**
 * 分页查询
 * http://localhost:8080/user/page?id=10
 * http://localhost:8080/user/page?pageIndex=1&pageSize=5
 *
 * @param param
 * @return
 */
 @GetMapping("/user/page")
public Result<PageInfo<TUser>> page(UserParam param) {
Query query = param.toQuery();
PageInfo<TUser> pageInfo = userService.page(query);
return Result.ok(pageInfo);
 }

/**
 * 新增记录，这里为了方便演示用了GET方法，实际上应该使用POST
 * http://localhost:8080/user/save?username=jim
 *
 * @param user
 * @return
 */
 @GetMapping("/user/save")
public Result<Integer> save(TUser user) {
 userService.saveIgnore(user);
// 返回添加后的主键值
return Result.ok(user.getId());
 }

/**
 * 修改记录，这里为了方便演示用了GET方法，实际上应该使用POST
 * http://localhost:8080/user/update?id=10&username=jim
 *
 * @param user 表单数据
 * @return
 */
 @GetMapping("/user/update")
public Result<?> update(TUser user) {
 userService.updateIgnore(user);
return Result.ok();
 }

/**
 * 删除记录，这里为了方便演示用了GET方法，实际上应该使用DELETE
 * http://localhost:8080/user/delete?id=10
 *
 * @param id 主键id
 * @return
 */
 @GetMapping("/user/delete")
public Result<?> delete(Integer id) {
 userService.deleteById(id);
return Result.ok();
 }
}

• UserService.java

// 实现通用接口
@Service
public class UserService implements IService<TUser/*实体类*/, Integer/*主键类型*/> {

}

• TUserMapper.java

public interface TUserMapper extends CrudMapper<TUser/*实体类*/, Integer/*主键类型*/> {

}

service和mapper不用写一行代码就能实现各种数据库操作，非常方便。

Mapper方法列表

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); // 该条件下总记录数

开源地址：https://gitee.com/durcframework/fastmybatis
相关文档：https://durcframework.gitee.io/fastmybatis/#/