Spring Boot Integration Testing with TestContainers | اختبار التكامل في سبرينغ بوت

وبالـ application.properties:

spring.sql.init.mode=always

إعداد الـ Test Class

@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
class EmployeeIntegrationTest {

    static PostgreSQLContainer<?> postgres = new PostgreSQLContainer<>("postgres:16-alpine");

    @LocalServerPort
    private Integer port;

    @DynamicPropertySource
    static void configureProperties(DynamicPropertyRegistry registry) {
        registry.add("spring.datasource.url", postgres::getJdbcUrl);
        registry.add("spring.datasource.username", postgres::getUsername);
        registry.add("spring.datasource.password", postgres::getPassword);
    }

    @BeforeAll
    static void startContainer() {
        postgres.start();
    }

    @AfterAll
    static void stopContainer() {
        postgres.stop();
    }
}

• RANDOM_PORT - يشغل السيرفر على Port عشوائي لتجنب التعارض
• @DynamicPropertySource - يعطي TestContainers معلومات الاتصال للـ Spring
• postgres متغير static لأن الـ Container يشتغل مرة وحدة لكل الـ Tests

تنظيف البيانات قبل كل Test

لازم نبدأ كل Test Case ببيانات نظيفة:

@Autowired
private EmployeeRepository employeeRepository;

@Autowired
private DepartmentRepository departmentRepository;

@Autowired
private UserAccountRepository userAccountRepository;

private Department department;

@BeforeEach
void setup() {
    // الترتيب مهم - نحذف الـ Child قبل الـ Parent
    userAccountRepository.deleteAll();
    employeeRepository.deleteAll();
    departmentRepository.deleteAll();

    department = departmentRepository.save(
        new Department(null, "IT")
    );
}

الترتيب بالحذف مهم بسبب الـ Foreign Key Constraints.

كتابة Test Case

@Test
void shouldGetAllEmployeesAsAdmin() {
    // Arrange
    Employee employee = createEmployee("John", "Doe", "john@example.com");
    UserAccount admin = createAdminAccount("admin", "password", employee);

    // Login لأخذ الـ Token
    String token = RestAssured.given()
        .port(port)
        .contentType("application/json")
        .body("""
            {"username": "admin", "password": "password"}
            """)
        .when()
        .post("/auth/login")
        .then()
        .statusCode(201)
        .extract()
        .path("data");

    // استخدام الـ Token لجلب الموظفين
    RestAssured.given()
        .port(port)
        .header("Authorization", "Bearer " + token)
        .when()
        .get("/employees")
        .then()
        .statusCode(200)
        .body("data.content.size()", equalTo(1));
}

اختبار الـ Forbidden Cases

@Test
void shouldNotGetAllEmployeesAsUser() {
    // نفس الـ Flow بس مع User عادي مش Admin
    String userToken = loginAs("regular-user");

    RestAssured.given()
        .port(port)
        .header("Authorization", "Bearer " + userToken)
        .when()
        .get("/employees")
        .then()
        .statusCode(403);
}

Helper Methods

بنعمل دوال مساعدة لتقليل تكرار الكود:

private Employee createEmployee(String firstName, String lastName, String email) {
    Employee employee = new Employee();
    employee.setFirstName(firstName);
    employee.setLastName(lastName);
    employee.setEmail(email);
    employee.setDepartment(department);
    return employeeRepository.save(employee);
}

ملاحظات مهمة

لا تعملوا Integration Test للـ Email Service أو الـ Payment Gateway - اعملوا لهم Mock. قاعدة البيانات مناسبة تماماً للـ Integration Tests لأن TestContainers بتسهّل عملية إنشاء بيئة نظيفة.

التستات رح تأخذ بضع ثواني لتشغيل Docker Container - هذا طبيعي. بعد الانتهاء، Docker رح يسكر والـ Database رح تختفي.

الـ Integration Tests بتكمل الـ Unit Tests وليست بديلاً عنها. الاثنين مع بعض بيعطونكم ثقة أكبر بالكود.