Xem toàn bộ series bài viết hướng dẫn xây dựng ứng dụng Questions Management tại đây.
Trong bài viết trước, chúng ta đã chuẩn bị tất cả các cấu hình cần thiết để có thể xây dựng API xóa một category như: một đối tượng Category để chứa thông tin của một category, một interface CoreCategoryService với implementation là CoreCategoryServiceImpl có trách nhiệm thao tác với Core Category Service, một CategoryController định nghĩa các API của API Category Service sẽ bắt đầu với “/category” và thông tin về Core Category Service được cấu hình trong tập tin application.properties. Bây giờ, chúng ta sẽ tiến hành xây dựng API này các bạn nhé!
Để xây dựng API xóa category, đầu tiên, mình sẽ thêm mới một phương thức deleteCategory() trong interface CoreCategoryService:
|
1 |
Mono<HttpStatus> deleteCategory(String categoryId); |
với phần implementation của method này trong class CoreCategoryServiceImpl như sau:
|
1 2 3 4 5 6 7 8 9 10 11 |
@Override public Mono<HttpStatus> deleteCategory(String categoryId) { WebClient webClient = WebClient.builder() .baseUrl(getServiceUrl()) .build(); return webClient.delete() .uri("/category/" + categoryId) .exchange() .map(response -> response.statusCode()); } |
Như các bạn thấy, ở đây mình đã sử dụng đối tượng WebClient để kết nối tới Core Category Service và gọi API xóa category của service này với URI “/category/{id}”.
Tiếp theo, mình sẽ thêm mới một method gọi tới phương thức deleteCategory() của CoreCategoryService để expose một DELETE request “/category/{id}” trong CategoryController như sau:
|
1 2 3 4 5 |
@DeleteMapping("/{id}") public Mono<ResponseEntity<Void>> deleteCategory(@PathVariable(value = "id") String categoryId) { return coreCategoryService.deleteCategory(categoryId) .map(statusCode -> new ResponseEntity<Void>(statusCode)); } |
Đến đây thì chúng ta đã hoàn thành việc xây dựng API xoá category cho API Category Service, hãy test thử xem sao nhé các bạn.
Giả sử hiện tại ứng dụng Questions Management của chúng ta đang có những category như sau:
thì khi mình request để xoá category với id “5b469aafe77a570af0f3cf33”, kết quả sẽ là:
Bây giờ chúng ta sẽ thêm mới Unit Test cho code mà chúng ta vừa thêm vào, các bạn nhé!
Trong bài viết trước, mình đã tạo mới class test cho CategoryController tên là CategoryControllerTest, đối tượng Mock cho CoreCategoryService và inject đối tượng Mock này vào class CategoryController, khởi tạo mock mỗi khi chạy một test case:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 |
package com.huongdanjava.categoryservice; import org.junit.Before; import org.mockito.InjectMocks; import org.mockito.Mock; import org.mockito.MockitoAnnotations; import com.huongdanjava.categoryservice.service.CoreCategoryService; public class CategoryControllerTest { @Mock private CoreCategoryService coreCategoryService; @InjectMocks private CategoryController categoryController; @Before public void init() { MockitoAnnotations.initMocks(this); } } |
Giờ mình sẽ thêm mới hai phương thức để test cho phương thức của deleteCategory() của class CategoryController như sau:
Một phương thức để test cho trường hợp có category dựa vào id truyền vào:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
@Test public void testDeleteExistingCategory() { // Mock deleteCategory() method of CoreCategoryService to return status code 200 when(coreCategoryService.deleteCategory("123")).thenReturn(Mono.just(HttpStatus.OK)); // Call method Mono<ResponseEntity<Void>> delete = categoryController.deleteCategory("123"); ResponseEntity<Void> responseEntity = delete.block(); // Assertions assertEquals(HttpStatus.OK, responseEntity.getStatusCode()); } |
Một phương thức để test cho trường hợp không có category dựa vào id truyền vào:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
@Test public void testDeleteNoExistingCategory() { // Mock deleteCategory() method of CoreCategoryService to return status code 404 when(coreCategoryService.deleteCategory("123")).thenReturn(Mono.just(HttpStatus.NOT_FOUND)); // Call method Mono<ResponseEntity<Void>> delete = categoryController.deleteCategory("123"); ResponseEntity<Void> responseEntity = delete.block(); // Assertions assertEquals(HttpStatus.NOT_FOUND, responseEntity.getStatusCode()); } |
Chạy “Maven test” trong STS hoặc “mvn test” với Apache Maven, các bạn sẽ không lỗi nào cả.
