后臺(tái)的功能與其它實(shí)體的添加無(wú)異,也是先建立實(shí)體然后建立對(duì)應(yīng)的倉(cāng)庫(kù),再建立serivce,最終建立controller。與前面學(xué)習(xí)的知識(shí)點(diǎn)稍有不同的是每門(mén)課程中可以有多個(gè)班級(jí),它們間的關(guān)系是多對(duì)多,這個(gè)知識(shí)點(diǎn)將放到下節(jié)中單獨(dú)進(jìn)行講解。本節(jié)除使用前面已學(xué)習(xí)的知識(shí)點(diǎn)完成基本的功能開(kāi)發(fā)外,還將使用**實(shí)體監(jiān)聽(tīng)器**來(lái)替換`@PrePersist`及`@PreUpdate`完成對(duì)課程名稱長(zhǎng)度的校驗(yàn)。
# 實(shí)體開(kāi)發(fā)
在entity包中新建Course課程實(shí)體。
```java
package com.mengyunzhi.springbootstudy.entity;
import javax.persistence.*;
/**
* 課程
* @author panjie
*/
@Entity
public class Course {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
@Column(unique = true, nullable = false)
private String name = "";
@ManyToOne
private Teacher teacher;
// 省略構(gòu)造函數(shù)及setter/getter
}
```
對(duì)Course的測(cè)試依賴于倉(cāng)庫(kù)層,下面繼續(xù)開(kāi)發(fā)倉(cāng)庫(kù)層。
# 倉(cāng)庫(kù)層開(kāi)發(fā)
repository/CourseRepository.java
```java
package com.mengyunzhi.springbootstudy.repository;
import com.mengyunzhi.springbootstudy.entity.Course;
import org.springframework.data.repository.CrudRepository;
public interface CourseRepository extends CrudRepository<Course, Long> {
}
```
## 測(cè)試
新建Course實(shí)體的測(cè)試文件CourseTest.java,然后分別就name字段的unique以及nullable進(jìn)行驗(yàn)證。初始化如下:
```java
package com.mengyunzhi.springbootstudy.entity;
import com.mengyunzhi.springbootstudy.repository.CourseRepository;
import org.junit.Before;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;
@SpringBootTest
@RunWith(SpringRunner.class)
public class CourseTest {
@Autowired
CourseRepository courseRepository;
private Course course;
@Before
public void before() {
}
@Test
public void save() {
}
@Test
public void nameUniqueTest() {
}
@Test
public void nameNullable() {
}
}
```
按前面的思路,若想驗(yàn)證某個(gè)校驗(yàn)是否生效最好的方法是在@Before先創(chuàng)建一個(gè)正常的課程。
entity/CourseTest.java
```java
@Before
public void before() {
this.course = new Course();
this.course.setName(RandomString.make(4));
}
@Test
public void save() {
this.courseRepository.save(this.course);
}
```
### Unique驗(yàn)證
entity/CourseTest.java
```java
@Test(expected = DataIntegrityViolationException.class)
public void nameUniqueTest() {
this.courseRepository.save(this.course);
Course course = new Course();
course.setName(this.course.getName());
this.courseRepository.save(course);
}
```
### Nullable驗(yàn)證
entity/CourseTest.java
```java
@Test(expected = DataIntegrityViolationException.class)
public void nameNullable() {
this.course.setName(null);
this.courseRepository.save(course);
}
```
# M層開(kāi)發(fā)
接口初始化
service/CourseService.java
```java
package com.mengyunzhi.springbootstudy.service;
import com.mengyunzhi.springbootstudy.entity.Course;
/**
* 課程
* @author panjie
*/
public interface CourseService {
/**
* 新增課程
* @param course 課程
* @return 課程
*/
Course save(Course course);
}
```
實(shí)現(xiàn)類
service/CourseServiceImpl.java
```java
@Service
public class CourseServiceImpl implements CourseService {
private CourseRepository courseRepository;
@Autowired
public CourseServiceImpl(CourseRepository courseRepository) {
this.courseRepository = courseRepository;
}
@Override
public Course save(Course course) {
return this.courseRepository.save(course);
}
}
```
## 單元測(cè)試
初始化如下:
service/CourseServiceImplTest.java
```java
public class CourseServiceImplTest {
private CourseRepository courseRepository;
private CourseService courseService;
public CourseServiceImplTest() {
this.courseRepository = Mockito.mock(CourseRepository.class);
this.courseService = new CourseServiceImpl(this.courseRepository);
}
@Test
public void save() {
}
}
```
補(bǔ)充測(cè)試代碼如下:
service/CourseServiceImplTest.java
```java
@Test
public void save() {
Course course = new Course();
Course returnCourse = new Course();
Mockito.when(this.courseRepository.save(course)).thenReturn(returnCourse);
Course resultCourse = this.courseService.save(course);
Assert.assertEquals(returnCourse, resultCourse);
}
```
# C層開(kāi)發(fā)
新建CourseController并初始化如下:
controller/CourseController.java
```java
@RestController
@RequestMapping("Course")
public class CourseController {
@Autowired
CourseService courseService;
@PostMapping
@ResponseStatus(HttpStatus.CREATED)
public Course save(@RequestBody Course course) {
return this.courseService.save(course);
}
}
```
## 單元測(cè)試
初始化單元測(cè)試文件Course/CourseControllerTest.java
```java
@SpringBootTest
@RunWith(SpringRunner.class)
@AutoConfigureMockMvc
public class CourseControllerTest {
@MockBean
private CourseService courseService;
@Autowired
MockMvc mockMvc;
@Test
public void save() {
}
}
```
補(bǔ)充測(cè)試代碼如下:
Course/CourseControllerTest.java
```java
@Test
public void save() throws Exception {
JSONObject jsonObject = new JSONObject();
String name = RandomString.make(4);
jsonObject.put("name", name);
String url = "/Course";
Course returnCourse = new Course();
returnCourse.setId(new Random().nextLong());
returnCourse.setName(RandomString.make(4));
returnCourse.setTeacher(new Teacher());
returnCourse.getTeacher().setId(new Random().nextLong());
returnCourse.getTeacher().setName(RandomString.make(4));
Mockito.when(this.courseService.save(Mockito.any(Course.class))).thenReturn(returnCourse);
this.mockMvc.perform(MockMvcRequestBuilders.post(url)
.contentType(MediaType.APPLICATION_JSON_UTF8)
.content(jsonObject.toString())
).andExpect(MockMvcResultMatchers.status().is(201))
.andExpect(MockMvcResultMatchers.jsonPath("id").value(returnCourse.getId()))
.andExpect(MockMvcResultMatchers.jsonPath("name").value(returnCourse.getName()))
.andExpect(MockMvcResultMatchers.jsonPath("teacher.id").value(returnCourse.getTeacher().getId()))
.andExpect(MockMvcResultMatchers.jsonPath("teacher.name").value(returnCourse.getTeacher().getName()))
;
ArgumentCaptor<Course> courseArgumentCaptor = ArgumentCaptor.forClass(Course.class);
Mockito.verify(this.courseService).save(courseArgumentCaptor.capture());
Assert.assertEquals(courseArgumentCaptor.getValue().getName(), name);
}
```
測(cè)試結(jié)果:
```
請(qǐng)求的地址為/Course請(qǐng)求的方法為:POST
當(dāng)前token未綁定登錄用戶,返回401
java.lang.AssertionError: Response status
Expected :201
Actual :401
```
## 401
之所以發(fā)生401是由于在上一章中啟用了攔截器進(jìn)行了用戶認(rèn)證,而當(dāng)前的單元測(cè)試并沒(méi)有傳遞認(rèn)證成功的authToken。解決這個(gè)問(wèn)題的方法很多,我們采用Mock TeacherService中的isLogin方法來(lái)通過(guò)認(rèn)證攔截器。
Course/CourseControllerTest.java
```java
@MockBean ?
private TeacherService teacherService;
@Before
public void before() {
Mockito.when(this.teacherService.isLogin(Mockito.any())).thenReturn(true); ?
}
```
* ? 使用MockBean注入TeacherService。該注解使得在整個(gè)測(cè)試過(guò)程中運(yùn)行中的teacherService全部為此替身
* ? 當(dāng)認(rèn)證攔截器調(diào)用替身的isLogin方法時(shí)返回true,表示teacher已認(rèn)證
再次運(yùn)行單元測(cè)試通過(guò)。
## 小作業(yè)
其它對(duì)控制器的單元測(cè)試同樣發(fā)生了401錯(cuò)誤,請(qǐng)參考上面的代碼進(jìn)行修正。
# 實(shí)體監(jiān)聽(tīng)器
在前面的章節(jié)中使用了`@PrePersist`及`@PreUpdate`完成了對(duì)字段長(zhǎng)度的校驗(yàn),本節(jié)中展示另外一種對(duì)單元測(cè)試更友好的方案:實(shí)體監(jiān)聽(tīng)器。
## 初始化
在entity包中新建CourseListener
entity/CourseListener.java
```java
package com.mengyunzhi.springbootstudy.entity;
import javax.persistence.PrePersist;
import javax.persistence.PreUpdate;
/**
* 實(shí)體監(jiān)聽(tīng)器。當(dāng)課程實(shí)體發(fā)生新建、更新操作時(shí)執(zhí)行
*/
public class CourseListener {
@PrePersist ?
public void prePersist(Course course?) {
System.out.println("prePersist");
}
@PreUpdate ?
public void perUpdate(Course course?) {
System.out.println("perUpdate");
}
}
```
* ? 與在實(shí)體中直接使用的注解相同
* ? 參數(shù)中必須傳入一個(gè)參數(shù),該參數(shù)對(duì)應(yīng)的類型為被監(jiān)聽(tīng)的實(shí)體(在只監(jiān)聽(tīng)某一個(gè)實(shí)體的前提下)
在Course實(shí)體上使用EntityListeners注解來(lái)添加實(shí)體監(jiān)聽(tīng)器:
entity/Course.java
```java
@Entity
@EntityListeners(CourseListener.class)
public class Course {
```
### 測(cè)試
打到CourseTest建立update方法
entity/CourseTest.java
```java
@Test void update() {
this.courseRepository.save(this.course);
this.course.setName(RandomString.make(4));
this.courseRepository.save(this.course);
}
```
運(yùn)行單元測(cè)試控制臺(tái)如下:
```
prePersist
perUpdate
```
說(shuō)明實(shí)體監(jiān)聽(tīng)器已生效。
## 校驗(yàn)課程長(zhǎng)度
entity/CourseListener.java
```java
public class CourseListener {
@PrePersist
public void prePersist(Course course) {
if (course.getName() == null || course.getName().length() < 2) {
throw new DataIntegrityViolationException("課程名稱長(zhǎng)度最小為2位");
}
}
@PreUpdate
public void perUpdate(Course course) {
if (course.getName() == null || course.getName().length() < 2) {
throw new DataIntegrityViolationException("課程名稱長(zhǎng)度最小為2位");
}
}
}
```
prePersist與perUpdate方法中的代碼是相同的,所以合并如下:
entity/CourseListener.java
```java
public class CourseListener {
@PrePersist
@PreUpdate
public void prePersistAndUpdate(Course course) {
if (course.getName() == null || course.getName().length() < 2) {
throw new DataIntegrityViolationException("課程名稱長(zhǎng)度最小為2位");
}
}
}
```
### 單元測(cè)試
entity/CourseTest.java
```java
@Test
public void nameLength() {
Boolean catchException = false;
this.course.setName(null);
try {
this.courseRepository.save(this.course);
} catch (DataIntegrityViolationException e) {
Assert.assertEquals(e.getMessage(), "課程名稱長(zhǎng)度最小為2位");
catchException = true;
}
Assert.assertTrue(catchException);
catchException = false;
this.course.setName(RandomString.make(1));
try {
this.courseRepository.save(this.course);
} catch (DataIntegrityViolationException e) {
Assert.assertEquals(e.getMessage(), "課程名稱長(zhǎng)度最小為2位");
catchException = true;
}
Assert.assertTrue(catchException);
for (int i = 2; i < 4; i++) {
this.course.setName(RandomString.make(i));
this.courseRepository.save(this.course);
}
}
```
# 總結(jié)
本節(jié)中使用了已經(jīng)學(xué)習(xí)的方法完成了課程的基本保存功能。同時(shí)學(xué)習(xí)了如何使用實(shí)體監(jiān)聽(tīng)器的方法來(lái)對(duì)課程名稱的長(zhǎng)度進(jìn)行校驗(yàn)。在生產(chǎn)環(huán)境中,可以對(duì)某一實(shí)體添加多個(gè)監(jiān)聽(tīng)器,還可以將一個(gè)監(jiān)聽(tīng)器添加到多個(gè)實(shí)體上。是一種靈活、可復(fù)用性強(qiáng)的校驗(yàn)方法。
# 參考文檔
| 名稱 | 鏈接 | 預(yù)計(jì)學(xué)習(xí)時(shí)長(zhǎng)(分) |
| --- | --- | --- |
| 源碼地址 | [https://github.com/mengyunzhi/spring-boot-and-angular-guild/releases/tag/step6.1.6](https://github.com/mengyunzhi/spring-boot-and-angular-guild/releases/tag/step6.1.6) | - |
- 序言
- 第一章: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國(guó)內(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ù)庫(kù)初始化
- 第二節(jié) CRUD之R查數(shù)據(jù)
- 1 原型初始化【前】
- 2 連接數(shù)據(jù)庫(kù)【后】
- 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 分層開(kāi)發(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 其它問(wèn)題
- 第六節(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層開(kāi)發(fā)【后】
- 10 集成測(cè)試
- 第六節(jié) 學(xué)生列表
- 1 分頁(yè)【后】
- 2 HashMap與LinkedHashMap
- 3 初識(shí)綜合查詢【后】
- 4 綜合查詢進(jìn)階【后】
- 5 小試綜合查詢【后】
- 6 初始化【前】
- 7 M層【前】
- 8 單元測(cè)試與分頁(yè)【前】
- 9 單選與多選【前】
- 10 集成測(cè)試
- 第七節(jié) 編輯學(xué)生
- 1 初始化【前】
- 2 嵌套組件測(cè)試【前】
- 3 功能開(kāi)發(fā)【前】
- 4 JsonPath【后】
- 5 spyOn【后】
- 6 集成測(cè)試
- 7 @Input 異步傳值【前】
- 8 值傳遞與引入傳遞
- 9 @PreUpdate【后】
- 10 表單驗(yàn)證【前】
- 第八節(jié) 刪除學(xué)生
- 1 CSS選擇器【前】
- 2 confirm【前】
- 3 功能開(kāi)發(fā)與測(cè)試【后】
- 4 集成測(cè)試
- 5 定制提示框【前】
- 6 引入圖標(biāo)庫(kù)【前】
- 第九節(jié) 集成測(cè)試
- 第五章 登錄與注銷
- 第一節(jié):普通登錄
- 1 原型【前】
- 2 功能設(shè)計(jì)【前】
- 3 功能設(shè)計(jì)【后】
- 4 應(yīng)用登錄組件【前】
- 5 注銷【前】
- 6 保留登錄狀態(tài)【前】
- 第二節(jié):你是誰(shuí)
- 1 過(guò)濾器【后】
- 2 令牌機(jī)制【后】
- 3 裝飾器模式【后】
- 4 攔截器【前】
- 5 RxJS操作符【前】
- 6 用戶登錄與注銷【后】
- 7 個(gè)人中心【前】
- 8 攔截器【后】
- 9 集成測(cè)試
- 10 單例模式
- 第六章 課程管理
- 第一節(jié) 新增課程
- 1 初始化【前】
- 2 嵌套組件測(cè)試【前】
- 3 async管道【前】
- 4 優(yōu)雅的測(cè)試【前】
- 5 功能開(kāi)發(fā)【前】
- 6 實(shí)體監(jiān)聽(tīng)器【后】
- 7 @ManyToMany【后】
- 8 集成測(cè)試【前】
- 9 異步驗(yàn)證器【前】
- 10 詳解CORS【前】
- 第二節(jié) 課程列表
- 第三節(jié) 果斷
- 1 初始化【前】
- 2 分頁(yè)組件【前】
- 2 分頁(yè)組件【前】
- 3 綜合查詢【前】
- 4 綜合查詢【后】
- 4 綜合查詢【后】
- 第節(jié) 班級(jí)列表
- 第節(jié) 教師列表
- 第節(jié) 編輯課程
- TODO返回機(jī)制【前】
- 4 彈出框組件【前】
- 5 多路由出口【前】
- 第節(jié) 刪除課程
- 第七章 權(quán)限管理
- 第一節(jié) AOP
- 總結(jié)
- 開(kāi)發(fā)規(guī)范
- 備用