对一个 Java 后端程序员来说,mybatis
、hibernate
、data-jdbc
等都是我们常用的 ORM 框架(Object Relational Mapping)。它们有时候很好用,比如简单的 CRUD,事务的支持都非常棒。但有时候用起来也非常繁琐,比如接下来我们要聊到的一个常见的开发需求,而对这类需求,本文会给出一个比直接使用这些 ORM 开发效率至少会提高 100 倍的方法(绝无夸张)。
注 1、ORM框架用于实现面向对象编程语言里不同类型系统的数据之间的转换 2、CRUD是增加(Create)、检索(Retrieve)、更新(Update)和删除(Delete)
用户表(user):(简单起见,假设只有 4 个字段)
角色表(role):(简单起见,假设只有 2 个字段)
这个查询有点复杂,它的要求如下:
可按用户名字段查询,要求:
可精确匹配(等于某个值)
可全模糊匹配(包含给定的值)
可后模糊查询(以...开头)
可前模糊查询(以.. 结尾)
可指定以上四种匹配是否可以忽略大小写
可按年龄字段查询,要求:
可精确匹配(等于某个年龄)
可大于匹配(大于某个值)
可小于匹配(小于某个值)
可区间匹配(某个区间范围)
可按角色ID查询,要求:精确匹配
可按用户ID查询,要求:同年龄字段
可指定只输出哪些列(例如,只查询 ID 与 用户名 列)
支持分页(每次查询后,页面都要显示满足条件的用户总数)
查询时可选择按 ID、用户名、年龄 等任意字段排序
后端接口该怎么写呢?
试想一下,对于这种要求的查询,后端接口里的代码如果用 mybatis
、hibernate
、data-jdbc
直接来写的话,100 行代码 能实现吗?
反正我是没这个信心,算了,我还是直接坦白,面对这种需求后端如何 只用一行代码搞定 吧(有兴趣的同学可以 mybatis 等写个试试,最后可以对比一下)
手把手:只一行代码实现以上需求
首先,重点人物出场啦:Bean Searcher, 它就是专门来对付这种列表检索的,无论简单的还是复杂的,统统一行代码搞定!而且它还非常轻量,Jar 包体积仅不到 100KB,无第三方依赖。
假设我们项目使用的框架是 Spring Boot(当然 Bean Searcher 对框架没有要求,但在 Spring Boot 中使用更加方便)
添加依赖
Maven :
<dependency>
<groupId>com.ejlchina</groupId> #文件目录
<artifactId>bean-searcher-boot-starter</artifactId> #包名
<version>3.0.1</version>#版本
</dependency>
Gradle :#对于Gradle 我不了解
implementation 'com.ejlchina:bean-searcher-boot-starter:3.0.1'
然后写个实体类来承载查询的结果
@SearchBean(tables="user u, role r", joinCond="u.role_id = r.id", autoMapTo="u")
#table 是表名字 joinCond是共有的字段 autoMapTo我不了解
public class User {
private Long id; // 用户ID(u.id)
private String name; // 用户名(u.name)
private int age; // 年龄(u.age)
private int roleId; // 角色ID(u.role_id)
@DbField("r.name") // 指明这个属性来自 role 表的 name 字段
private int role; // 角色名(r.name)
// Getter and Setter ...
}
接着就可以写用户查询接口了
接口路径就叫 /user/index 吧:
@RestController
@RequestMapping("/user")
public class UserController {
@Autowired
private MapSearcher mapSearcher; // 注入检索器(由 bean-searcher-boot-starter 提供)
@GetMapping("/index")
public SearchResult<Map<String, Object>> index(HttpServletRequest request) {
// 这里咱们只写一行代码
return mapSearcher.search(User.class, MapUtils.flat(request.getParameterMap()));
}
}