当前位置：首页 > news >正文

掌握jpa-spec的Like/NotLike查询：轻松实现模糊搜索的5个实用案例

news 2026/7/16 16:09:56

掌握jpa-spec的Like/NotLike查询：轻松实现模糊搜索的5个实用案例

【免费下载链接】jpa-specA JPA Query By Specification framework.项目地址: https://gitcode.com/gh_mirrors/jp/jpa-spec

在Spring Data JPA开发中，模糊搜索是数据库查询的常见需求。jpa-spec作为一个强大的JPA查询框架，提供了简洁高效的Like和NotLike查询功能，让开发者能够轻松实现各种复杂的模糊搜索场景。本文将为您详细介绍jpa-spec的Like/NotLike查询功能，并通过5个实用案例展示如何快速上手。

什么是jpa-spec的Like/NotLike查询？

jpa-spec是一个基于Spring Data JPA的查询框架，它简化了动态查询的构建过程。Like和NotLike是jpa-spec提供的核心查询方法之一，专门用于处理字符串模糊匹配查询。与传统的JPA Criteria API相比，jpa-spec的Like/NotLike查询更加简洁直观，支持多值查询和条件判断，大大提高了开发效率。

核心特性亮点 ✨

多值支持：Like和NotLike方法支持传入多个匹配值
条件判断：可以通过条件参数灵活控制查询是否生效
简洁语法：链式调用，代码可读性强
类型安全：基于泛型，编译时类型检查
关联查询：支持关联实体的Like/NotLike查询

案例一：基础模糊搜索实现

最基本的模糊搜索场景是查找包含特定字符串的记录。使用jpa-spec的Like方法，您可以轻松实现：

public List<Person> findByNameContaining(String keyword) { Specification<Person> specification = Specifications.<Person>and() .like("name", "%" + keyword + "%") .build(); return personRepository.findAll(specification); }

这个案例展示了最简单的模糊搜索，%符号表示任意字符的通配符。当keyword为"ac"时，会查找name字段包含"ac"的所有记录。

案例二：多值模糊匹配查询

在实际业务中，我们经常需要同时匹配多个模式。jpa-spec的Like方法支持传入多个值：

public List<Person> findByNamePatterns(String pattern1, String pattern2) { Specification<Person> specification = Specifications.<Person>and() .like("name", "%" + pattern1 + "%", "%" + pattern2 + "%") .build(); return personRepository.findAll(specification); }

这个查询会返回name字段匹配任意一个模式的所有记录。在LikeTest.java中，我们可以看到类似的测试用例，验证了多值模糊匹配的正确性。

案例三：排除特定模式的NotLike查询

NotLike查询用于排除包含特定模式的记录，这在数据过滤场景中非常有用：

public List<Person> excludeByPattern(String excludePattern) { Specification<Person> specification = Specifications.<Person>and() .notLike("name", "%" + excludePattern + "%") .build(); return personRepository.findAll(specification); }

例如，要排除所有name中包含"admin"的记录，可以使用.notLike("name", "%admin%")。在NotLikeTest.java中，展示了更复杂的多值排除场景。

案例四：条件化模糊搜索

jpa-spec支持条件化的查询构建，只有当条件为true时才应用Like查询：

public List<Person> conditionalSearch(SearchRequest request) { Specification<Person> specification = Specifications.<Person>and() .like(StringUtils.isNotBlank(request.getName()), "name", "%" + request.getName() + "%") .like(StringUtils.isNotBlank(request.getNickName()), "nickName", "%" + request.getNickName() + "%") .build(); return personRepository.findAll(specification); }

这种条件化查询在构建动态搜索表单时特别有用，只有当用户输入了搜索关键词时才应用相应的过滤条件。

案例五：关联实体的模糊搜索

jpa-spec支持对关联实体进行Like查询，这是很多复杂业务场景的必备功能：

public List<Order> searchOrdersByCustomerInfo(OrderSearchRequest request) { Specification<Order> specification = Specifications.<Order>and() .like(StringUtils.isNotBlank(request.getCustomerName()), "customer.name", "%" + request.getCustomerName() + "%") .like(StringUtils.isNotBlank(request.getCustomerEmail()), "customer.email", "%" + request.getCustomerEmail() + "%") .build(); return orderRepository.findAll(specification); }

通过使用点号分隔的路径语法（如"customer.name"），您可以轻松对关联实体进行模糊搜索，无需编写复杂的JOIN查询。

Like/NotLike查询的最佳实践

1. 性能优化建议 ⚡

合理使用通配符：尽量避免在模式开头使用%，这会阻止索引的使用
组合查询优化：将Like查询与其他条件结合使用，减少结果集大小
使用条件判断：避免不必要的Like查询执行

2. 错误处理技巧

public List<Person> safeSearch(String keyword) { // 处理空值或null值 if (StringUtils.isBlank(keyword)) { return personRepository.findAll(); } Specification<Person> specification = Specifications.<Person>and() .like("name", "%" + keyword.trim() + "%") .build(); return personRepository.findAll(specification); }

3. 与分页和排序结合使用

public Page<Person> searchWithPagination(SearchRequest request, Pageable pageable) { Specification<Person> specification = Specifications.<Person>and() .like(StringUtils.isNotBlank(request.getKeyword()), "name", "%" + request.getKeyword() + "%") .build(); Sort sort = Sorts.builder() .desc("createTime") .asc("name") .build(); return personRepository.findAll(specification, PageRequest.of(pageable.getPageNumber(), pageable.getPageSize(), sort)); }