在上個(gè)小節(jié)中我們使用單元測(cè)試的方法學(xué)習(xí)了綜合查詢。這在學(xué)習(xí)過程中是無可厚非的，但卻不是單元測(cè)試的正規(guī)用法。單元測(cè)試更多的是用于保障自己某個(gè)方法功能的正確性，而非來其它方法。學(xué)習(xí)某個(gè)知識(shí)點(diǎn)最佳的方法是按官方的推薦建立個(gè)小的demo，然后在demo中添加模擬數(shù)據(jù)，并在模擬數(shù)據(jù)的基礎(chǔ)上按官方的指導(dǎo)進(jìn)行練習(xí)。
在進(jìn)行綜合查詢時(shí)，我們往往會(huì)將其抽離成單元的包，并在包中針對(duì)每個(gè)實(shí)體建立單元的類。
# 初始化
綜合查詢的包起名為specs，我們?cè)趓epository下建立specs包，并在該包中建立StudentSpecs.java
```
panjiedeMac-Pro:mengyunzhi panjie$ tree
.
└── springBootStudy
├── SpringBootStudyApplication.java
├── config
│?? └── WebConfig.java
├── controller
│?? ├── KlassController.java
│?? ├── StudentController.java
│?? └── TeacherController.java
├── entity
│?? ├── Klass.java
│?? ├── Student.java
│?? └── Teacher.java
├── repository
│?? ├── KlassRepository.java
│?? ├── StudentRepository.java
│?? ├── TeacherRepository.java
│?? └── specs
│?? └── StudentSpecs.java ★
└── service
├── KlassService.java
├── KlassServiceImpl.java
├── StudentService.java
└── StudentServiceImpl.java
```
編輯該文件，并建立以下靜態(tài)（依賴于類而不依賴于具體的對(duì)象）方法以完成條件查詢功能:
# 查詢條件：班級(jí)
在實(shí)體的設(shè)置中，學(xué)生與班的關(guān)系是：學(xué)生`屬于`某個(gè)班級(jí)。因而在綜合查詢的方法中，我們對(duì)應(yīng)將其查詢方法命名為：belongToKlass
repository/specs/StudentSpecs.java
```
/**
* 學(xué)生綜合查詢
*
*/
public class StudentSpecs {
/**
* 屬于某個(gè)班級(jí)
* @param klass 班級(jí)
* @return
*/
public static Specification<Student> belongToKlass(Klass klass?) {
return new Specification<Student>() {
@Override
public Predicate toPredicate(Root<Student> root, CriteriaQuery<?> criteriaQuery, CriteriaBuilder criteriaBuilder) {
return criteriaBuilder.equal(root.get("klass").as(Klass.class), klass?);
}
};
}
}
```
* ? 將查詢條件Klass做為靜態(tài)方法的參數(shù)傳入
* ? 構(gòu)建給定查詢時(shí)，直接使用該傳入?yún)?shù)
## 單元測(cè)試
使用IDEA自對(duì)生成對(duì)應(yīng)的測(cè)試文件StudentSpecTest.java
```
@SpringBootTest
@RunWith(SpringRunner.class)
public class StudentSpecsTest {
private static final Logger logger = LoggerFactory.getLogger(StudentSpecsTest.class);
@Autowired
private KlassRepository klassRepository;
@Autowired
private StudentRepository studentRepository;
@Test
public void belongToKlass() {
logger.info("初始化測(cè)試數(shù)據(jù)");
Klass klass = new Klass();
klass.setName("testKlass");
this.klassRepository.save(klass);
Student student = new Student();
student.setName("testName");
student.setSno("032282");
student.setKlass(klass);
this.studentRepository.save(student);
List students = this.studentRepository.findAll(StudentSpecs.belongToKlass(klass)); ①
Assertions.assertThat(students.size()).isEqualTo(1);①
klass.setId(-1L); ②
students = this.studentRepository.findAll(StudentSpecs.belongToKlass(klass)); ②
Assertions.assertThat(students.size()).isEqualTo(0); ②
}
}
```
* ① 以klass進(jìn)行綜合查詢，斷言條數(shù)為1
* ② 將klass的ID設(shè)置為-1，斷言查詢的條數(shù)為0。預(yù)測(cè)：jpa是根據(jù)關(guān)聯(lián)實(shí)體的ID值進(jìn)行查詢的
# 查詢條件：姓名
查詢姓名的方法我們命名為：containingName，顧名思義：只要姓名中包含有某個(gè)關(guān)鍵字，即為符合條件。
```
public class StudentSpecs {
...
public static Specification<Student>? containingName(String name) {
return new Specification<Student>()? {
@Override
public Predicate toPredicate(Root<Student> root, CriteriaQuery<?> criteriaQuery, CriteriaBuilder criteriaBuilder)? {
return criteriaBuilder.like(root.get("name").as(String.class), String.format("%%%s%%?", name));
}
};
}
}
```
* ? 在字符串格式化時(shí)，由于%是其關(guān)鍵字，所以想表示該`%`為字符串的文本時(shí)，需要將`%`轉(zhuǎn)義為`%%`。所以當(dāng)name為`zhangsan`時(shí)，上述格式代碼將格式化為`%zhangsan%`
由于在方法中的返回值中規(guī)定了類型Specification<Student>?，所以在書寫時(shí)即使我們刪除new Specification<Student>()?代碼，也不會(huì)造成誤解；又由于Specification接口中僅聲明了一個(gè)方法?，所以即使我們不書寫該方法名，編譯器也知道我們必然是實(shí)現(xiàn)的該方法，故以上方法還可以簡(jiǎn)寫為：
```
public class StudentSpecs {
...
public static Specification<Student> containingName(String name) {
return (Specification<Student>) (root, criteriaQuery, criteriaBuilder) -> {
return criteriaBuilder.like(root.get("name").as(String.class), String.format("%%%s%%", name)); ?
};
}
}
```
又由于return?的代碼僅有一行，而又同時(shí)聲明了方法的返回值類型，所以即使不寫return，編譯器也知道我們要返回這行代碼的結(jié)果，所以上述代碼又可以進(jìn)行下簡(jiǎn)寫為：
```
public class StudentSpecs {
...
public static Specification<Student> containingName(String name) {
return (Specification<Student>) (root, criteriaQuery, criteriaBuilder) -> criteriaBuilder.like(root.get("name").as(String.class), String.format("%%%s%%", name));
}
}
```
而上述簡(jiǎn)寫后的代碼稱為：lambda表過式。
## 單元測(cè)試
由于本功能的測(cè)試也需要進(jìn)行數(shù)據(jù)的初始化工作，所以在進(jìn)行編碼前先對(duì)原測(cè)試代碼進(jìn)行小幅度重構(gòu)：
StudentSpecsTest.java
```
private Student student; ?
@Before
public void before() {
logger.info("初始化測(cè)試數(shù)據(jù)");
Klass klass = new Klass();
klass.setName("testKlass");
this.klassRepository.save(klass);
this.student = new Student(); ?
this.student.setName("testName");
this.student.setSno("032282");
this.student.setKlass(klass);
this.studentRepository.save(this.student);
}
@Test
public void belongToKlass() {
Klass klass = this.student.getKlass(); ?
List students = this.studentRepository.findAll(StudentSpecs.belongToKlass(klass));
```
重構(gòu)后再次執(zhí)行belongToKlass測(cè)試，以保障重構(gòu)未對(duì)歷史的單元測(cè)試功能造成影響 。然后開始書寫本測(cè)試：
```
@SpringBootTest
@RunWith(SpringRunner.class)
public class StudentSpecsTest {
...
/**
* name測(cè)試
* 1. 原文
* 2. left
* 3. middle
* 4. right
* 5. 不包含
*/
@Test
public void containingName() {
List students = this.studentRepository.findAll(StudentSpecs.containingName("testName"));
Assertions.assertThat(students.size()).isEqualTo(1);
students = this.studentRepository.findAll(StudentSpecs.containingName("tes"));
Assertions.assertThat(students.size()).isEqualTo(1);
students = this.studentRepository.findAll(StudentSpecs.containingName("stNa"));
Assertions.assertThat(students.size()).isEqualTo(1);
students = this.studentRepository.findAll(StudentSpecs.containingName("tName"));
Assertions.assertThat(students.size()).isEqualTo(1);
students = this.studentRepository.findAll(StudentSpecs.containingName("testName12"));
Assertions.assertThat(students.size()).isEqualTo(0);
}
}
```
* 在測(cè)試中，我們分別對(duì)原文、以部分關(guān)鍵字開始、關(guān)鍵字取中、以部分關(guān)鍵字結(jié)束以及不符合的條件分別進(jìn)行了測(cè)試，以此來保障代碼的健壯性
# 條件查詢：sno
有了剛剛的經(jīng)驗(yàn)，對(duì)學(xué)號(hào)的條件查詢便很輕松了，方法我們命名為startWithSno
StudentSpecs.java
```
public class StudentSpecs {
...
public static Specification<Student> startWithSno(String sno) {
return (Specification<Student>) (root, criteriaQuery, criteriaBuilder) -> criteriaBuilder.like(root.get("sno").as(String.class), String.format("%s%%①", sno));
}
}
```
* ① 以%結(jié)尾
## 單元測(cè)試
```
@SpringBootTest
@RunWith(SpringRunner.class)
public class StudentSpecsTest {
...
/**
* sno測(cè)試
* 1. 原文
* 2. 左
* 3. 中
*/
@Test
public void startWithSno() {
List students = this.studentRepository.findAll(StudentSpecs.startWithSno("032282")); ①
Assertions.assertThat(students.size()).isEqualTo(1);
students = this.studentRepository.findAll(StudentSpecs.startWithSno("032")); ②
Assertions.assertThat(students.size()).isEqualTo(1);
students = this.studentRepository.findAll(StudentSpecs.startWithSno("3228")); ③
Assertions.assertThat(students.size()).isEqualTo(0);
}
...
}
```
* ① 原文
* ② 以部分關(guān)鍵字開始
* ③ 取中，斷言取出0條
# 組合查詢
有了上述三個(gè)查詢條件后，便可以輕驗(yàn)的使用他們來進(jìn)行組合查詢了。按分層的理論，對(duì)數(shù)據(jù)進(jìn)行查詢的基礎(chǔ)操作應(yīng)該屬于repository，所以打開repository/StudentRepository.java，并新建如下方法：
```
/**
* 綜合查詢
* @param name containing 姓名
* @param sno startWith 學(xué)號(hào)
* @param klass equal 班級(jí)
* @param pageable
* @return
*/
default? Page findAll(String name, String sno, Klass klass, Pageable pageable) {
Specification<Student> specification = StudentSpecs.containingName(name) ?
.and(StudentSpecs.startWithSno(sno)) ?
.and(StudentSpecs.belongToKlass(klass)); ?
return this?.findAll(specification, pageable);
}
```
* ? 在接口中的方法需要用default進(jìn)行修飾
* ? this表示本(實(shí)現(xiàn)了這個(gè)接口的)對(duì)象
我們此時(shí)的需求是三個(gè)條詢條件做`交集`，所以是`并 and`的關(guān)系，對(duì)應(yīng)查詢條件為：`? and ? and ?`
## 單元測(cè)試
每個(gè)單元測(cè)試均應(yīng)著重測(cè)試對(duì)應(yīng)方法的功能，在本方法中StudentSpecs.containingName方法屬于方法調(diào)用，原則上并不在我們的測(cè)試范圍以內(nèi)，本測(cè)試應(yīng)該著重測(cè)試的是三個(gè)查詢條件是否生效以及三個(gè)查詢條件間的關(guān)系是否為`and`
打開repository/StudentRepositoryTest.java，在原findAll方法的基礎(chǔ)上繼續(xù)進(jìn)行測(cè)試：
```
@Test
public void findAll() {
List<Student> oldStudentList = (List<Student>) this.studentRepository.findAll();
/* 初始化2個(gè)班級(jí)并持久化*/
Klass klass = new Klass();
klass.setName("testKlass");
this.klassRepository.save(klass);
Klass klass1 = new Klass();
klass1.setName("testKlass1");
this.klassRepository.save(klass1);
Student student = new Student();
student.setName("testStudentName");
student.setSno("032282");
student.setKlass(klass);
this.studentRepository.save(student);
/* 初始化2個(gè)不同班級(jí)的學(xué)生并持久化 */
Student student1 = new Student();
student1.setName("testStudentName1");
student1.setSno("032291");
student1.setKlass(klass1);
this.studentRepository.save(student1);
Page studentPage = this.studentRepository.findAll("testStudentName", "032282", klass, PageRequest.of(0, 2)); ①
Assertions.assertThat(studentPage.getTotalElements()).isEqualTo(1);
studentPage = this.studentRepository.findAll("testStudentName12", "032282", klass, PageRequest.of(0, 2)); ②
Assertions.assertThat(studentPage.getTotalElements()).isEqualTo(0);
studentPage = this.studentRepository.findAll("testStudentName", "0322821", klass, PageRequest.of(0, 2)); ③
Assertions.assertThat(studentPage.getTotalElements()).isEqualTo(0);
studentPage = this.studentRepository.findAll("testStudentName", "032282", klass1, PageRequest.of(0, 2)); ④
Assertions.assertThat(studentPage.getTotalElements()).isEqualTo(0);
}
```
* ① 加入全部查詢字段
* ② 變更name值后查詢到0條，說明name字段在查詢中生效了同時(shí)查詢條件為and的關(guān)系
* ③ sno字段，原理同上
* ④ klass字段，原理同上
單元測(cè)試通過，說明功能代碼正確。
# NULL
前面我們?cè)跅売玫谝环N方法的時(shí)候給出的理由是該方法并不支持null值。那么第二種的綜合查詢方法是否支持傳入null呢？我們?cè)谠瓬y(cè)試的基礎(chǔ)上加入對(duì)null值的測(cè)試：
repository/StudentRepositoryTest.java
```
@Test
public void findAll() {
...
studentPage = this.studentRepository.findAll("testStudentName", "032282", klass1, PageRequest.of(0, 2));
Assertions.assertThat(studentPage.getTotalElements()).isEqualTo(0);
studentPage = this.studentRepository.findAll(null, "032282", klass, PageRequest.of(0, 2));
logger.info("傳入的name為null, 得到了{(lán)}條數(shù)據(jù)", studentPage.getTotalElements());
}
```
測(cè)試結(jié)果為：
```
2019-11-29 14:48:38.495 INFO 51728 --- [ main] c.m.s.repository.StudentRepositoryTest : 傳入的name為null, 得到了0條數(shù)據(jù)
```
該語句沒有報(bào)異常，當(dāng)name為null，返回了0條數(shù)據(jù)。這是由于JPA在進(jìn)行綜合查詢時(shí)，當(dāng)接收到值為null的name時(shí)，在查詢過程中會(huì)生成類似于`name is null`的語句。但這明顯與我們實(shí)際需求的并不相同。我們的需求是：當(dāng)用戶未傳入name，即name的值為null時(shí)，應(yīng)該忽略該name條件。而不是查詢name為null的記錄。
## 處理NULL
我們?cè)诔绦蚓帉憰r(shí)有一個(gè)不成文的規(guī)則：如果未標(biāo)明該參數(shù)不能為null，那么表示該參數(shù)可以為null;如果該參數(shù)不能為null，那么需要使用`@NotNull`來標(biāo)注。是否允許參數(shù)為null，要根據(jù)現(xiàn)實(shí)的情況來設(shè)定。比如我們此時(shí)在進(jìn)行綜合查詢時(shí)，調(diào)用者是需求將name為null的值傳入的，那么就該name就必須可以為null，而我們要做的則是對(duì)null值進(jìn)行處理。但既然是分頁查詢，那么規(guī)定用戶必須傳入分頁的條件信息。
對(duì)name的null處理，我們放到repository/specs/StudentSpec.java中
```
public class StudentSpecs {
...
public static Specification<Student> containingName(String name) {
if (name != null) { ①
return (Specification<Student>) (root, criteriaQuery, criteriaBuilder) -> criteriaBuilder.like(root.get("name").as(String.class), String.format("%%%s%%", name));
} else {
return Specification.where(null); ②
}
}
...
}
```
* ① 對(duì)參數(shù)值進(jìn)行null判斷
* ② 當(dāng)參數(shù)為null時(shí)，返回一個(gè)空規(guī)范，該空規(guī)范不在查詢中起任何作用
此時(shí)我們重新進(jìn)行單元測(cè)試：
```
2019-11-29 15:03:25.004 INFO 63864 --- [ main] c.m.s.repository.StudentRepositoryTest : 傳入的name為null, 得到了1條數(shù)據(jù)
```
則在查詢條件中當(dāng)name為null做的是忽略處理，而非null查詢。
> 注意：在StudentRepositoryTest中來測(cè)試StudentSpec代碼是正確性是錯(cuò)誤的，請(qǐng)自行修正。
### sno的null處理
sno的處理方式與name的方式相同，請(qǐng)自行完成。
### klass的null處理
jpa在進(jìn)行關(guān)聯(lián)查詢時(shí)，實(shí)際上查詢的是關(guān)聯(lián)實(shí)體的主鍵值信息，也就是說：當(dāng)傳入klass時(shí)，JPA是依據(jù)klass的id值來進(jìn)行查詢的，如果未傳入id，
```
@Test
public void findAll() {
...
studentPage = this.studentRepository.findAll(null, null, new Klass()★, PageRequest.of(0, 2));
Assertions.assertThat(studentPage.getTotalElements()).isEqualTo(1);
```
在進(jìn)行相關(guān)的查詢時(shí)便會(huì)報(bào)以下異常信息：
```
org.springframework.dao.InvalidDataAccessApiUsageException: org.hibernate.TransientObjectException: object references an unsaved transient instance - save the transient instance before flushing: com.mengyunzhi.springBootStudy.entity.Klass; nested exception is java.lang.IllegalStateException: org.hibernate.TransientObjectException: object references an unsaved transient instance - save the transient instance before flushing: com.mengyunzhi.springBootStudy.entity.Klass
```
他大體是說：你即然要以klass為查詢條件對(duì)student表進(jìn)行查詢，那么klass最少得是咱數(shù)據(jù)表中存在的數(shù)據(jù)吧（如果不存在klass，是不可能將其設(shè)置為student的外鍵值的）。
所以我們還需要對(duì)klass及其id值是否為null進(jìn)行處理:
repository/specs/StudentSpecs.java
```
public static Specification<Student> belongToKlass(Klass klass) {
if (null == klass || null == klass.getId()) {
return Specification.where(null);
}
return (Specification<Student>) (root, criteriaQuery, criteriaBuilder) -> criteriaBuilder.equal(root.get("klass").as(Klass.class), klass);
}
```
### pageable的null處理
前面三個(gè)參數(shù)均進(jìn)行了null的處理，當(dāng)方法`default Page findAll(String name, String sno, Klass klass, Pageable pageable) {`中的第四個(gè)參數(shù)為null時(shí)，JPA會(huì)為我們自動(dòng)處理嗎？
我們繼續(xù)增加測(cè)試語句：
```
@Test
public void findAll() {
...
studentPage = this.studentRepository.findAll(null, null, null, null);
Assertions.assertThat(studentPage.getTotalElements()).isEqualTo(2);
```
運(yùn)行測(cè)試則得到以下異常：
```
2019-11-29 15:22:04.815 INFO 79226 --- [ main] o.h.h.i.QueryTranslatorFactoryInitiator : HHH000397: Using ASTQueryTranslatorFactory
java.lang.NullPointerException
```
這是個(gè)空指針異常，該異常是在程序執(zhí)行時(shí)在調(diào)用某個(gè)對(duì)象的某個(gè)方法時(shí)，由于該對(duì)象為null產(chǎn)生的。也就是說pageable為null也是不可行的。做為一個(gè)負(fù)責(zé)任的開發(fā)者，我們需要用更人性化的方式來告知我們團(tuán)隊(duì)的其它成員pageable是不能夠?yàn)閚ull的.
#### @NotNull
最基本的，我們需要在參數(shù)上添加一個(gè)`@NotNull`注解來表時(shí)該參數(shù)是不可以為null的。
```
import javax.validation.constraints.NotNull;
...
public interface StudentRepository extends PagingAndSortingRepository<Student, Long>, JpaSpecificationExecutor {
...
default Page findAll(String name, String sno, Klass klass, @NotNull? Pageable pageable) {
...
}
}
```
* ? 告知隊(duì)友：該參數(shù)不能為null
雖然我們?cè)诖嗣鞔_的告知隊(duì)友說：該參數(shù)不能為null。但有時(shí)候不怕神一樣的對(duì)手...。@NotNull的作用僅僅是`mark 標(biāo)記`，除此之外，它什么作用都沒有。當(dāng)然也就不能夠指望說在隊(duì)友傳入null時(shí)，編譯器會(huì)報(bào)異常了（實(shí)質(zhì)上除非是顯性的傳入null，編譯器是無法判斷傳入的值是否可能為null的）。
#### 異常
使用異常的方式來告知隊(duì)友我們是不支持null的可以降低他調(diào)用我們產(chǎn)生空指針錯(cuò)誤的排錯(cuò)難度，雖然說即使我們什么也不做，有經(jīng)驗(yàn)的隊(duì)友在調(diào)用我們發(fā)生null異常時(shí)仍然可以根據(jù)異常及我們的代碼來判斷出具體是出了什么問題，但這種做法總歸是不負(fù)責(zé)任的。這就像我們?cè)撍赖闹袊?lián)通，A處理業(yè)務(wù)時(shí)發(fā)生了錯(cuò)誤，然后告知你去哪哪哪找B，到了B那又告知你去哪哪找C，最后C再讓你去找A。做為客戶的我們，更希望的是"首問負(fù)責(zé)制"，也就說我調(diào)用你發(fā)生的問題，你就應(yīng)該直接告訴我怎么解決，而不是讓客戶去替你DEBUG。
```
public interface StudentRepository extends PagingAndSortingRepository<Student, Long>, JpaSpecificationExecutor {
default Page findAll(String name, String sno, Klass klass, @NotNull Pageable pageable) {
if (null == pageable) {
throw new IllegalArgumentException("傳入的Pageable不能為null"); ?
}
...
```
* ? 當(dāng)接收的參數(shù)為null，拋出`非法參數(shù)異常`
此時(shí)當(dāng)我們繼續(xù)以null調(diào)用時(shí)：
```
@Test
public void findAll()
...
studentPage = this.studentRepository.findAll(null, null, null, null);
```
則會(huì)得到如下異常提示：
```
org.springframework.dao.InvalidDataAccessApiUsageException: 傳入的Pageable不能為null; nested exception is java.lang.IllegalArgumentException: 傳入的Pageable不能為null
```
同時(shí)，我們還可以在控制臺(tái)中找到該異常的位置 ：
由于該參數(shù)異常是較常規(guī)的寫法，所以spring友好的為我們進(jìn)行了封裝，當(dāng)進(jìn)行參數(shù)的異常聲明時(shí)，我們也可以這樣：
```
import org.springframework.util.Assert;
...
public interface StudentRepository extends PagingAndSortingRepository<Student, Long>, JpaSpecificationExecutor {
default Page findAll(String name, String sno, Klass klass, @NotNull Pageable pageable) {
Assert.notNull(pageable, "傳入的Pageable不能為null"); ?
if (null == pageable) { ?
throw new IllegalArgumentException("傳入的Pageable不能為null"); ?
} ?
```
效果相同。最后我們進(jìn)行異常測(cè)試。測(cè)試該異常的方法有兩種：第一種是在已經(jīng)長(zhǎng)的不行的findAll方法上再加入幾行，并用try catch來進(jìn)行捕獲；第二種是單獨(dú)在建立一個(gè)測(cè)試用例來專門測(cè)試異常。一般情況下，我們更習(xí)慣于使用第一種；而使用第二種也是正確的做法。在單元測(cè)試時(shí)，力求將測(cè)試的粒度最小化，把各個(gè)測(cè)試用例需要用到的具有共性的代碼抽離到@Before方法中，然后在各個(gè)測(cè)試用例中盡量只測(cè)試一個(gè)簡(jiǎn)單到不能分解的功能。這樣的做的好處最少有兩點(diǎn)：1. 由于每次只測(cè)一小點(diǎn)，所以可以減小我們測(cè)試時(shí)的思維量，避免燒腦；2. 當(dāng)單元測(cè)試發(fā)生錯(cuò)誤時(shí)，由于測(cè)試代碼的行數(shù)較長(zhǎng)，所以修正代碼的工作量也會(huì)很小。在一般的風(fēng)格指南或是開發(fā)規(guī)范上都會(huì)以類似的話術(shù)：如果一個(gè)函數(shù)內(nèi)的代碼行數(shù)超過40行，便可以思索一下能不能在不影響程序結(jié)構(gòu)的前提下對(duì)其進(jìn)行分割了。
原文對(duì)于長(zhǎng)函數(shù)是這么解釋的：
<hr />
我們承認(rèn)長(zhǎng)函數(shù)有時(shí)是合理的, 因此并不硬性限制函數(shù)的長(zhǎng)度. 如果函數(shù)超過 40 行, 可以思索一下能不能在不影響程序結(jié)構(gòu)的前提下對(duì)其進(jìn)行分割.
即使一個(gè)長(zhǎng)函數(shù)現(xiàn)在工作的非常好, 一旦有人對(duì)其修改, 有可能出現(xiàn)新的問題, 甚至導(dǎo)致難以發(fā)現(xiàn)的 bug. 使函數(shù)盡量簡(jiǎn)短, 以便于他人閱讀和修改代碼.
在處理代碼時(shí), 你可能會(huì)發(fā)現(xiàn)復(fù)雜的長(zhǎng)函數(shù). 不要害怕修改現(xiàn)有代碼: 如果證實(shí)這些代碼使用 / 調(diào)試起來很困難, 或者你只需要使用其中的一小段代碼, 考慮將其分割為更加簡(jiǎn)短并易于管理的若干函數(shù).
<hr />
```
import org.springframework.dao.InvalidDataAccessApiUsageException; ?
@SpringBootTest
@RunWith(SpringRunner.class)
public class StudentRepositoryTest {
...
@Test(expected = InvalidDataAccessApiUsageException.class)
public void findAllWithPageableIsNull() {
this.studentRepository.findAll("name", "sno", new Klass(), null);
}
```
* ? 此處需要捕獲InvalidDataAccessApiUsageException而非IllegalArgumentException（spring對(duì)其進(jìn)行了封裝），了解即可。
# 總結(jié)
本小節(jié)我們費(fèi)勁周折，目標(biāo)就是在學(xué)生倉庫中建立一個(gè)可以支持多字段綜合查詢及分頁的findAll方法。一旦有了此方法的支持，我們便可以輕松的service中對(duì)其進(jìn)行調(diào)用，進(jìn)而實(shí)現(xiàn)對(duì)學(xué)生表的綜合查詢。在程序的編寫過程中，我們進(jìn)行了充分的分層及單元測(cè)試、友好的null提示，目標(biāo)僅為一個(gè)：**編寫易讀、友好、易維護(hù)的代碼。**
# 參考文檔
| 名稱 | 鏈接 | 預(yù)計(jì)學(xué)習(xí)時(shí)長(zhǎng)(分） |
| --- | --- | --- |
| 源碼地址 | [https://github.com/mengyunzhi/spring-boot-and-angular-guild/releases/tag/step4.6.4](https://github.com/mengyunzhi/spring-boot-and-angular-guild/releases/tag/step4.6.4) | - |
- 序言
- 第一章：Hello World
- 第一節(jié)：Angular準(zhǔn)備工作
- 1 Node.js
- 2 npm
- 3 WebStorm
- 第二節(jié)：Hello Angular
- 第三節(jié)：Spring Boot準(zhǔn)備工作
- 1 JDK
- 2 MAVEN
- 3 IDEA
- 第四節(jié)：Hello Spring Boot
- 1 Spring Initializr
- 2 Hello Spring Boot!
- 3 maven國內(nèi)源配置
- 4 package與import
- 第五節(jié)：Hello Spring Boot + Angular
- 1 依賴注入【前】
- 2 HttpClient獲取數(shù)據(jù)【前】
- 3 數(shù)據(jù)綁定【前】
- 4 回調(diào)函數(shù)【選學(xué)】
- 第二章 教師管理
- 第一節(jié) 數(shù)據(jù)庫初始化
- 第二節(jié) CRUD之R查數(shù)據(jù)
- 1 原型初始化【前】
- 2 連接數(shù)據(jù)庫【后】
- 3 使用JDBC讀取數(shù)據(jù)【后】
- 4 前后臺(tái)對(duì)接
- 5 ng-if【前】
- 6 日期管道【前】
- 第三節(jié) CRUD之C增數(shù)據(jù)
- 1 新建組件并映射路由【前】
- 2 模板驅(qū)動(dòng)表單【前】
- 3 httpClient post請(qǐng)求【前】
- 4 保存數(shù)據(jù)【后】
- 5 組件間調(diào)用【前】
- 第四節(jié) CRUD之U改數(shù)據(jù)
- 1 路由參數(shù)【前】
- 2 請(qǐng)求映射【后】
- 3 前后臺(tái)對(duì)接【前】
- 4 更新數(shù)據(jù)【前】
- 5 更新某個(gè)教師【后】
- 6 路由器鏈接【前】
- 7 觀察者模式【前】
- 第五節(jié) CRUD之D刪數(shù)據(jù)
- 1 綁定到用戶輸入事件【前】
- 2 刪除某個(gè)教師【后】
- 第六節(jié) 代碼重構(gòu)
- 1 文件夾化【前】
- 2 優(yōu)化交互體驗(yàn)【前】
- 3 相對(duì)與絕對(duì)地址【前】
- 第三章 班級(jí)管理
- 第一節(jié) JPA初始化數(shù)據(jù)表
- 第二節(jié) 班級(jí)列表
- 1 新建模塊【前】
- 2 初識(shí)單元測(cè)試【前】
- 3 初始化原型【前】
- 4 面向?qū)ο蟆厩啊?/a>
- 5 測(cè)試HTTP請(qǐng)求【前】
- 6 測(cè)試INPUT【前】
- 7 測(cè)試BUTTON【前】
- 8 @RequestParam【后】
- 9 Repository【后】
- 10 前后臺(tái)對(duì)接【前】
- 第三節(jié) 新增班級(jí)
- 1 初始化【前】
- 2 響應(yīng)式表單【前】
- 3 測(cè)試POST請(qǐng)求【前】
- 4 JPA插入數(shù)據(jù)【后】
- 5 單元測(cè)試【后】
- 6 惰性加載【前】
- 7 對(duì)接【前】
- 第四節(jié) 編輯班級(jí)
- 1 FormGroup【前】
- 2 x、[x]、{{x}}與(x)【前】
- 3 模擬路由服務(wù)【前】
- 4 測(cè)試間諜spy【前】
- 5 使用JPA更新數(shù)據(jù)【后】
- 6 分層開發(fā)【后】
- 7 前后臺(tái)對(duì)接
- 8 深入imports【前】
- 9 深入exports【前】
- 第五節(jié) 選擇教師組件
- 1 初始化【前】
- 2 動(dòng)態(tài)數(shù)據(jù)綁定【前】
- 3 初識(shí)泛型
- 4 @Output()【前】
- 5 @Input()【前】
- 6 再識(shí)單元測(cè)試【前】
- 7 其它問題
- 第六節(jié) 刪除班級(jí)
- 1 TDD【前】
- 2 TDD【后】
- 3 前后臺(tái)對(duì)接
- 第四章 學(xué)生管理
- 第一節(jié) 引入Bootstrap【前】
- 第二節(jié) NAV導(dǎo)航組件【前】
- 1 初始化
- 2 Bootstrap格式化
- 3 RouterLinkActive
- 第三節(jié) footer組件【前】
- 第四節(jié) 歡迎界面【前】
- 第五節(jié) 新增學(xué)生
- 1 初始化【前】
- 2 選擇班級(jí)組件【前】
- 3 復(fù)用選擇組件【前】
- 4 完善功能【前】
- 5 MVC【前】
- 6 非NULL校驗(yàn)【后】
- 7 唯一性校驗(yàn)【后】
- 8 @PrePersist【后】
- 9 CM層開發(fā)【后】
- 10 集成測(cè)試
- 第六節(jié) 學(xué)生列表
- 1 分頁【后】
- 2 HashMap與LinkedHashMap
- 3 初識(shí)綜合查詢【后】
- 4 綜合查詢進(jìn)階【后】
- 5 小試綜合查詢【后】
- 6 初始化【前】
- 7 M層【前】
- 8 單元測(cè)試與分頁【前】
- 9 單選與多選【前】
- 10 集成測(cè)試
- 第七節(jié) 編輯學(xué)生
- 1 初始化【前】
- 2 嵌套組件測(cè)試【前】
- 3 功能開發(fā)【前】
- 4 JsonPath【后】
- 5 spyOn【后】
- 6 集成測(cè)試
- 7 @Input 異步傳值【前】
- 8 值傳遞與引入傳遞
- 9 @PreUpdate【后】
- 10 表單驗(yàn)證【前】
- 第八節(jié) 刪除學(xué)生
- 1 CSS選擇器【前】
- 2 confirm【前】
- 3 功能開發(fā)與測(cè)試【后】
- 4 集成測(cè)試
- 5 定制提示框【前】
- 6 引入圖標(biāo)庫【前】
- 第九節(jié) 集成測(cè)試
- 第五章 登錄與注銷
- 第一節(jié)：普通登錄
- 1 原型【前】
- 2 功能設(shè)計(jì)【前】
- 3 功能設(shè)計(jì)【后】
- 4 應(yīng)用登錄組件【前】
- 5 注銷【前】
- 6 保留登錄狀態(tài)【前】
- 第二節(jié)：你是誰
- 1 過濾器【后】
- 2 令牌機(jī)制【后】
- 3 裝飾器模式【后】
- 4 攔截器【前】
- 5 RxJS操作符【前】
- 6 用戶登錄與注銷【后】
- 7 個(gè)人中心【前】
- 8 攔截器【后】
- 9 集成測(cè)試
- 10 單例模式
- 第六章 課程管理
- 第一節(jié) 新增課程
- 1 初始化【前】
- 2 嵌套組件測(cè)試【前】
- 3 async管道【前】
- 4 優(yōu)雅的測(cè)試【前】
- 5 功能開發(fā)【前】
- 6 實(shí)體監(jiān)聽器【后】
- 7 @ManyToMany【后】
- 8 集成測(cè)試【前】
- 9 異步驗(yàn)證器【前】
- 10 詳解CORS【前】
- 第二節(jié) 課程列表
- 第三節(jié) 果斷
- 1 初始化【前】
- 2 分頁組件【前】
- 2 分頁組件【前】
- 3 綜合查詢【前】
- 4 綜合查詢【后】
- 4 綜合查詢【后】
- 第節(jié) 班級(jí)列表
- 第節(jié) 教師列表
- 第節(jié) 編輯課程
- TODO返回機(jī)制【前】
- 4 彈出框組件【前】
- 5 多路由出口【前】
- 第節(jié) 刪除課程
- 第七章 權(quán)限管理
- 第一節(jié) AOP
- 總結(jié)
- 開發(fā)規(guī)范
- 備用