Specification：规范、规格

★ Specification查询

它也是Spring Data提供的查询——是对JPA本身 Criteria 动态查询 的包装。

▲ 为何要有动态查询

页面上常常会让用户添加不同的查询条件，程序就需要根据用户输入的条件，动态地组合不同的查询条件。JPA为动态查询提供了Criteria查询支持。Spring Data JPA则对Criteria查询进行了封装，封装之后的结果就是Specification查询。——Specification查询比Jpa的Criteria动态查询更加简单。

如图：
在这里插入图片描述

▲ 核心API: JpaSpecificationExecutor

long count(Specification spec)： 返回符合Specification条件的实体的总数。
List findAll(Specification spec)： 返回符合Specification条件的实体。
Page findAll(Specification spec, Pageable pageable)： 返回符合Specification条件的实体，额外传入的Pageable参数用于控制排序和分页。
List findAll(Specification spec, Sort sort)： 返回符合Specification条件的实体，额外传入的Sort参数用于控制排序。
Optional findOne(Specification spec)： 返回符合Specification条件的单个实体，如果符合条件的实体有多个，该方法将会引发异常。

▲ Specification查询的步骤：

（1）让你的DAO接口继承JpaSpecificationExecutor 这个核心API。（2）构建Specification对象，用于以面向对象的方式来动态地组合查询条件。——最方便的地方（改进的地方），这一步就是为了解决动态拼接SQL的问题，而改为使用面向对象的方式来组合查询条件。

▲ 如何创建Specification对象（用于组合多个查询条件）

- Specification参数用于封装多个代表查询条件的Predicate对象。- Specification接口只定义了一个toPredicate()方法，该方法返回的Predicate对象就是Specification查询的查询条件，程序通常使用Lambda表达式来实现toPredicate()方法来定义动态查询条件。

▲ 还涉及如下两个API（本身就是来自于JPA的规范）

Predicate -  代表了单个查询条件，相当于sql语句的where子句中的单个的条件
（比如 age>100，就是一个Predicate ）。
也可用于组合多个查询条件。CriteriaBuilder - 专门用于构建单个Predicate。

在这里插入图片描述

代码演示

  下面的代码演示也属于---组合多个查询条件：方式1：用Specification的 and 或 or来组合多个 Specification——每个Specification只组合一个查询条件。

需求1：查询名字和年龄都符合的条件–equal
在这里插入图片描述

简洁写法
在这里插入图片描述

需求2：查询名字是沙开头的，年龄大于 100的学生--------like
在这里插入图片描述

▲ 如何组合多个查询条件？

 两种方式：A - 用Specification的and或or来组合多个 Specification——每个Specification只组合一个查询条件。B - 先用CriteriaBuilder的and或or来组合多个Predicate对象，得到一个最终的Predicate，然后再将Predicate包装成Specification。

代码演示

需求：根据传来的student，如果该对象里面的某个属性不为null，就将该属性作为查询条件进行查询。

演示：先用CriteriaBuilder的and或or来组合多个Predicate对象，
得到一个最终的Predicate，然后再将Predicate包装成Specification。

下面的查询就是组合查询，

Predicate - 代表了单个查询条件，相当于sql语句的where子句中的单个的条件
（比如 age>100，就是一个Predicate ）。也可用于组合多个查询条件。

CriteriaBuilder - 专门用于构建单个Predicate。
在这里插入图片描述

测试结果：
在这里插入图片描述

完整代码：

StudentDaoTest

package cn.ljh.app.dao;import cn.ljh.app.domain.Student;
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.CsvSource;
import org.junit.jupiter.params.provider.MethodSource;
import org.junit.jupiter.params.provider.ValueSource;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.PageRequest;
import org.springframework.data.domain.Pageable;
import org.springframework.data.jpa.domain.Specification;import javax.persistence.criteria.CriteriaBuilder;
import javax.persistence.criteria.CriteriaQuery;
import javax.persistence.criteria.Predicate;
import javax.persistence.criteria.Root;
import java.util.ArrayList;
import java.util.List;
import java.util.stream.Stream;//SpringBootTest.WebEnvironment.NONE : 表示不需要web环境
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.NONE)
public class StudentDaoTest
{@Autowiredprivate StudentDao studentDao;/*** @ValueSource: 每次只能传一个参数* @CsvSource：每次可以传多个参数*///需求：查询年龄大于指定参数的记录//参数化测试@ParameterizedTest@ValueSource(ints = {20, 200})public void testFindByAgeGreaterThan(int startAge){List<Student> students = studentDao.findByAgeGreaterThan(startAge);students.forEach(System.err::println);}//根据年龄和班级名称查询学生//Age 和 ClazzName 用 And 连接起来，表示两个查询条件，//ClazzName这两个单词中间没有And连接起来，表示是一个路径写法，表示是Clazz类的name属性@ParameterizedTest//参数一个是int，一个是String，这个注解在传参的时候会自动进行类型转换@CsvSource(value = {"20,超级A营", "18,超级D班"})public void testFindByAgeAndClazzName(int age, String clazzName){List<Student> students = studentDao.findByAgeAndClazzName(age, clazzName);students.forEach(System.err::println);}//pageNo: 要查询哪一页的页数 , pageSize: 每页显示的条数@ParameterizedTest@CsvSource({"洞,2,3", "洞,1,4", "洞,3,2"})public void testFindByAddressEndingWith(String addrSuffix, int pageNo, int pageSize){//分页对象，此处的pageNo是从0开始的，0代表第一页，所以这里的 pageNo 要 -1Pageable pageable1 = PageRequest.of(pageNo - 1, pageSize);Page<Student> students = studentDao.findByAddressEndingWith(addrSuffix, pageable1);int number = students.getNumber() + 1;System.err.println("总页数：" + students.getTotalPages());System.err.println("总条数：" + students.getTotalElements());System.err.println("当前第：" + number + " 页");System.err.println("当前页有：" + students.getNumberOfElements() + " 条数据");students.forEach(System.err::println);}//======================================测试 Specification 查询=======================================================//查询名字和年龄都符合的条件--equal@ParameterizedTest@CsvSource({"沙和尚,580"})public void testSpecificationQuery(String name, int age){/** root : 代表要查询的实体（就是 student）* criteriaBuilder：专门用于构建运算符的*/List<Student> students = studentDao.findAll(((Specification<Student>) (root, criteriaQuery, criteriaBuilder) ->{//判断 root.get("name") 是否等于 namePredicate p1 = criteriaBuilder.equal(root.get("name"), name);return p1;})//再次使用 and 添加了一个 Specification 的条件.and((root, criteriaQuery, criteriaBuilder) ->{Predicate p2 = criteriaBuilder.equal(root.get("age"), age);return p2;}));students.forEach(System.err::println);}//查询名字和年龄都符合的条件---简洁写法---equal@ParameterizedTest@CsvSource({"沙和尚,580"})public void testSpecificationQuery1(String name, int age){List<Student> students = studentDao.findAll(((Specification<Student>)(root, criteriaQuery, criteriaBuilder) -> criteriaBuilder.equal(root.get("name"), name)).and((root, criteriaQuery, criteriaBuilder) -> criteriaBuilder.equal(root.get("age"), age)));students.forEach(System.err::println);}//查询名字是 沙 开头的，年龄大于 100的学生--------like@ParameterizedTest@CsvSource({"猪%,100"})public void testSpecificationQuery2(String name, int age){List<Student> students = studentDao.findAll(((Specification<Student>)(root, criteriaQuery, criteriaBuilder) -> criteriaBuilder.like(root.get("name"), name)).and((root, criteriaQuery, criteriaBuilder) -> criteriaBuilder.gt(root.get("age"), age)));students.forEach(System.err::println);}//组合查询@ParameterizedTest//参数是一个对象，对象的数据从这个getStudent方法里面获取//该方法要求：1、该方法必须以 static 修饰，//该方法的返回值必须是 stream ， Stream 中的数据必须是被测试方法要求的参数类型@MethodSource("getStudents")public void testSpecificationQuery3(Student student){//此处查询，只要 student 的哪个属性不为null，就查询哪些条件studentDao.findAll((Specification<Student>) (root, query, criteriaBuilder) ->{//使用 predicateList 来收集查询条件List<Predicate> predicateList = new ArrayList<>();//如果name属性不为null，就说明需要添加name作为查询条件if (student.getName() != null && !student.getName().equals("")){predicateList.add(criteriaBuilder.equal(root.get("name"), student.getName()));}//如果 age 属性不等于 0 ，就说明需要添加 age 作为查询条件if (student.getAge() != 0){predicateList.add(criteriaBuilder.equal(root.get("age"), student.getAge()));}//如果 address 属性不等于 null ，就说明需要添加 address 作为查询条件if (student.getAddress() != null && !student.getAddress().equals("")){predicateList.add(criteriaBuilder.equal(root.get("age"), student.getAge()));}//Gender 是char类型，如果 Gender 属性不等于 '\u0000'-->空字符串 ，就说明需要添加 Gender 作为查询条件if (student.getGender() != '\u0000'){predicateList.add(criteriaBuilder.equal(root.get("gender"), student.getGender()));}//由于 criteriaBuilder 的 and 方法的参数是数组，因此此处将 predicateList 集合转成 数组Predicate predicate = criteriaBuilder.and(predicateList.toArray(new Predicate[1]));return predicate;}).forEach(System.err::println);}//该方法要求：1、该方法必须以 static 修饰，//该方法的返回值必须是 Stream ， Stream 中的数据必须是被测试方法要求的参数类型public static Stream<Student> getStudents(){Stream<Student> studentStream = Stream.of(new Student("孙悟空", 0, null, '\u0000', null),new Student("孙悟空", 500, null, '\u0000', null),new Student("孙悟空", 500, "花果山水帘洞", '\u0000', null),new Student("孙悟空", 500, "花果山水帘洞", '男', null),new Student("孙", 50, "花果山", '男', null));return studentStream;}}