شرح Unit Testing في Spring Boot مع Mockito واختبار الـ Controller | Fullstack Yazan

شرح Unit Testing في Spring Boot مع Mockito واختبار الـ Controller | Fullstack Yazan

كود الدرس

بالدرسة رح نعمل Unit Tests للـ Controller والـ Service. الـ Unit Test بتركز على وحدة واحدة (Function أو Class) بمعزل عن باقي المكونات.

الفكرة الأساسية - الـ Mock

بالـ Unit Test ما بهمنا نختبر الـ Database أو الإيميل أو أي Service خارجي. همنا بس نتأكد إنه الكود المحدد يعمل صح.

الـ Mock هو إحلال أي Dependency خارجية بـ Fake Implementation. بدل ما نروح الـ Database، بنقوله "خذ هالـ Data الوهمية وكفي الكود".

الـ Dependencies المطلوبة

Spring Boot بيجي مع spring-boot-starter-test تلقائياً. بنضيف كمان:

<dependency>
    <groupId>org.springframework.security</groupId>
    <artifactId>spring-security-test</artifactId>
    <scope>test</scope>
</dependency>

اختبار الـ Controller

بننشئ Class بمجلد test:

@WebMvcTest(EmployeeController.class)
class EmployeeControllerTest {

    @MockBean
    private JwtHelper jwtHelper;

    @MockBean
    private EmployeeService employeeService;

    @MockBean
    private LeaveRequestService leaveRequestService;

    @Autowired
    private

اشترك في النشرة البريدية

دروس جديدة، مقالات، وأدوات مباشرة لبريدك.

@Test
void shouldReturnAllEmployees() throws Exception {
    // Arrange - تجهيز الداتا الوهمية
    List<Employee> fakeEmployees = List.of(
        new Employee(UUID.randomUUID(), "John", "Doe", "john@example.com",
                    "555-1234", LocalDate.now(), department)
    );

    Mockito.when(employeeService.findAll(0, 3))
           .thenReturn(fakeEmployees);

    // Act - تنفيذ الـ Request
    mockMvc.perform(
        MockMvcRequestBuilders.get("/employees")
            .with(SecurityMockMvcRequestPostProcessors.user("john").roles("ADMIN"))
    )
    // Assert - التحقق من النتيجة
    .andExpect(MockMvcResultMatchers.status().isOk())
    .andExpect(MockMvcResultMatchers.jsonPath("$.data[0].firstName").value("John"));
}

private Department department;
private UUID departmentId;

@BeforeEach
void setup() {
    departmentId = UUID.randomUUID();
    department = new Department(departmentId, "IT");
}

@Test
void shouldThrowExceptionWhenDepartmentNotFound() {
    // Arrange
    Mockito.when(departmentRepository.findById(departmentId))
           .thenReturn(Optional.empty());

    // Act & Assert
    CustomResponseException exception = assertThrows(
        CustomResponseException.class,
        () -> employeeService.createOne(employeeCreateDto)
    );

    assertTrue(exception.getMessage().contains("Department with id"));
}

@Test
void shouldSendEmailOnceWhenCreatingEmployee() {
    // ...
    
    // تأكيد إنه الإيميل انبعث مرة وحدة بس
    Mockito.verify(emailService, Mockito.times(1))
           .sendAccountCreationEmail(anyString(), anyString());
}

@ExtendWith(MockitoExtension.class)
class EmployeeServiceTest {

    @Mock
    private EmployeeRepository employeeRepository;

    @Mock
    private DepartmentRepository departmentRepository;

    @InjectMocks
    private EmployeeServiceImpl employeeService;

    @Test
    void shouldCreateEmployee() {
        Mockito.when(departmentRepository.findById(departmentId))
               .thenReturn(Optional.of(department));

        Employee result = employeeService.createOne(employeeCreateDto);

        assertEquals("John", result.getFirstName());
    }
}