jpa-query-object
jpa动态查询实体
用于动态接收jpa查询条件，实现原理，通过继承Specification
，并使用注解标明需要参与动态生成查询条件的的字段，然后在toPredicate里生成动态的查询条件，
使用的是JpaSpecificationExecutor里的findAll方法查询，所以这里的dao得继承JpaSpecificationExecutor。
这样做可以简化动态查询条件的代码编写量。并且对于jpa项目的侵入性很小，对现有项目的改造工作量很小，无缝接入现有jpa项目。
使用场景
- controller接收页面动态参数。
/**
* 分页查询
*
* @param qo 查询条件
* @param pageable 分页参数
*/
@GetMapping("/page")
public Page<User> page(UserJoinQO qo, Pageable pageable) {
return userService.page(qo, pageable);
}
/**
* 查询全部用户数据
*
* @param qo 查询条件
* @param sort 排序
*/
@GetMapping("/list")
public List<User> list(UserQO qo, Sort sort) {
return userService.list(qo, sort);
}
- service里编写动态查询条件的业务代码
/**
* 查询全部用户数据
*
* @param qo 查询条件
* @param sort 排序
*/
public <QO extends QueryObject<User>> List<User> list(QO qo, Sort sort) {
return userDao.findAll(qo, sort);
}
依赖
如果项目是springboot3.0以上，得在依赖里加上<classifier>jakarta</classifier>。
<dependency>
<groupId>io.github.chenfd99</groupId>
<artifactId>jpa-query-object</artifactId>
<!-- <classifier>jakarta</classifier>-->
</dependency>
使用方法
- 用于查询的实体继承
QueryObject； - 并在需要参与查询的字段上添加注解
@QField；
当实体的字段值不为null时，会在toPredicate里动态加入条件，
同一个字段可使用多个@QField注解，多个@QField注解的字段在生成查询条件时会默认使用or连接起来。如：
//数据库实体
@Data
@Entity
@Table(name = "t_user")
public class User implements Serializable {
@Id
private Long id;
private String name;
private String email;
@CreatedDate
private LocalDateTime createdTime;
}
//Dao
@Repository
public interface UserDao extends JpaRepository<User, Long>, JpaSpecificationExecutor<User> {
}
//查询实体
@Setter
@Getter
public class UserQO extends QueryObject<User> {
@QField(name = "name", value = QType.EQUAL)
private String username;
@QField(name = "createdTime", value = QType.LESS_THAN_OR_EQUAL)
private LocalDateTime createdTimeLE;
@QField(name = "name", value = QType.EQUAL)
@QField(name = "email", value = QType.LIKE)
private String keyword;
}
//使用方法
@Test
void testQuery() {
UserQO qo = new UserQO();
qo.setUsername("chen");
qo.setKeyword("chen11");
qo.setCreatedTimeLE(LocalDateTime.now());
userDao.findAll(qo);
}
生成查询条件
select u1_0.id,
u1_0.created_time,
u1_0.email,
u1_0.name
from t_user u1_0
where u1_0.name = ?
and u1_0.created_time <= ?
and (
u1_0.name = ?
or u1_0.email like ?
)
注解说明
单字段使用单个@QField注解, 生成单个查询条件
/**
* 用户名
*/
@QField(name = "name", value = QType.EQUAL)
private String username;
//使用方法
UserQO qo = new UserQO();
qo.setUsername("chen");
userDao.findAll(qo);
//生成查询条件
select
user0_.id as id1_1_,
user0_.created_time as created_2_1_,
user0_.email as email3_1_,
user0_.name as name4_1_
from
t_user user0_
where
user0_.name=?
同一个字段使用@QFields注解并且type=QFields.Type.OR
同一个字段使用@QFields注解并且type=QFields.Type.OR, 在生成sql查询条件时, 会使用or连接. 当一字段使用多个@QField
注解时,也可视为是使用@QFields(type=QFields.Type.OR). 如:
/**
* 查询条件为 用户名或者邮箱
*/
@QField(name = "name", value = QType.EQUAL)
@QField(name = "email", value = QType.LIKE)
private String keyword;
/**
* 用户名或者邮箱
* 等同于上面的 keyword
*/
@QFields({@QField(name = "name", value = QType.EQUAL), @QField(name = "email", value = QType.LIKE)})
private String nameEqualOrEmailLike;
//使用方法
UserQO qo = new UserQO();
qo.setKeyword("chen");
userDao.findAll(qo);
//生成查询条件
select
user0_.id as id1_1_,
user0_.created_time as created_2_1_,
user0_.email as email3_1_,
user0_.name as name4_1_
from
t_user user0_
where
user0_.name=?
or user0_.email like ?
同一个字段使用@QFields注解, 并且type=QFields.Type.AND
同一个字段使用@QFields注解, 并且type=QFields.Type.AND,在生成查询条件时, 使用and连接. 如:
//注解字段
@QFields(
value = {@QField(name = "name"), @QField(name = "email")},
type = QFields.Type.AND
)
private String groupAnd;
//使用方法
UserQO qo = new UserQO();
qo.setGroupAnd("chen");
userDao.findAll(qo);
//生成查询的条件
select
user0_.id as id1_1_,
user0_.created_time as created_2_1_,
user0_.email as email3_1_,
user0_.name as name4_1_
from
t_user user0_
where
user0_.name=?
and user0_.email=?
联表查询
注解配置了joinName和joinType，如: @QField(joinName = "purse", joinType = JoinType.LEFT)，那么查询会走联表逻辑，
但是联表查询提前提是需要在数据库实体中定义实体与实体之间的关联关系，并添加@OneToMany等关联注解。当注解的forceJoin=true
时，会强制去执行这个join关系，不管这个字段值是否为空。默认情况是如果字段配置了join信息，那么只有在字段值不为null时才去执行联表操作。
方法一：使用注解执行联表
/**
* 订单
* 一对多关系
* 当qo中使用连表查询时,也会使用到这个字段
*/
@OneToMany(fetch = FetchType.LAZY)
@JoinColumn(name = "memberId")
private List<Order> orders;
//查询实体注解
/**
* 订单号
*/
@QField(joinName = "orders")
private String orderNo;
//使用方法
UserQO qo = new UserQO();
qo.setOrderNo("20231212xxxxxxxx");
userDao.findAll(qo);
//生成的查询条件
select
user0_.id as id1_1_,
user0_.created_time as created_2_1_,
user0_.email as email3_1_,
user0_.name as name4_1_
from
t_user user0_
inner join
t_order orders1_
on user0_.id=orders1_.member_id
where
orders1_.order_no=?
方法二：在QueryObject的customPredicate里值手动执行联表操作，如：
这里手动执行的join会在使用这个类查询的所有查询中去执行join操作
public class UserCustomJoinQO extends QueryObject<User> {
/**
* 用户id
*/
@QField(name = "id")
private Long userId;
/**
* 默认去重
*/
@Override
public boolean distinct() {
return true;
}
@Override
public Optional<Predicate> customPredicate(Root<User> root, CriteriaQuery<?> cq, CriteriaBuilder cb) {
root.join(User_.ORDERS, JoinType.LEFT);
root.join(User_.PURSE, JoinType.LEFT);
return Optional.empty();
}
}
测试用例
@Test
@DisplayName("根据用户id查询")
void testJoinWithPurseUserId() {
UserCustomJoinQO qo = new UserCustomJoinQO();
qo.setUserId(122L);
userDao.findAll(qo);
}
生成的查询语句
select distinct user0_.id as id1_2_,
user0_.created_time as created_2_2_,
user0_.email as email3_2_,
user0_.name as name4_2_
from t_user user0_
left outer join
t_order orders1_ on user0_.id = orders1_.user_id
left outer join
t_purse purse2_ on user0_.id = purse2_.user_id
where user0_.id = 122
具体使用方法请看jpa-query-object-test模块