Rezolvarea problemelor cu testele Quarkus, containerele de testare și integrarea Liquibase

Asigurarea integrării corespunzătoare între Liquibase și TestContainers în Quarkus

Soluție de backend care utilizează Quarkus cu TestContainers pentru a gestiona migrările PostgreSQL și Liquibase. Acest script rezolvă problemele de nealiniere a containerului.

import org.testcontainers.containers.PostgreSQLContainer;
import org.testcontainers.utility.DockerImageName;
import java.util.HashMap;
import java.util.Map;
public class PostgreSQLTestResource implements QuarkusTestResourceLifecycleManager {
    private static PostgreSQLContainer<?> postgreSQLContainer;
    @Override
    public Map<String, String> start() {
        postgreSQLContainer = new PostgreSQLContainer<>(DockerImageName.parse("postgres:alpine"))
            .withDatabaseName("test")
            .withUsername("postgres")
            .withPassword("password")
            .withReuse(true);
        postgreSQLContainer.start();
        Map<String, String> config = new HashMap<>();
        config.put("quarkus.datasource.jdbc.url", postgreSQLContainer.getJdbcUrl());
        config.put("quarkus.datasource.username", postgreSQLContainer.getUsername());
        config.put("quarkus.datasource.password", postgreSQLContainer.getPassword());
        return config;
    }
    @Override
    public void stop() {
        if (postgreSQLContainer != null) {
            postgreSQLContainer.stop();
        }
    }
}

Validarea integrării aplicație-Liquibase folosind teste unitare

Un exemplu de testare Quarkus modular și reutilizabil care verifică conexiunea la baza de date și execuția scriptului de migrare.

import org.junit.jupiter.api.Test;
import io.quarkus.test.junit.QuarkusTest;
import io.quarkus.test.junit.TestProfile;
@QuarkusTest
@TestProfile(TestProfileResolver.class)
public class XServiceTest {
    @Inject
    XTypeVersionService xTypeVersionService;
    @Test
    public void getXTypeVersion() {
        List<XTypeVersionEntity> entities = xTypeVersionService.get();
        assertFalse(entities.isEmpty(), "The entity list should not be empty.");
    }
}

Asigurarea coerenței configurației între profilurile de testare

Configurare personalizată a profilului de testare pentru a garanta alinierea între Liquibase și containerele de aplicații.

public class TestProfileResolver implements QuarkusTestProfile {
    @Override
    public String getConfigProfile() {
        return "test";
    }
    @Override
    public Map<String, String> getConfigOverrides() {
        return Map.of("quarkus.config.locations", "src/test/resources/application.yaml");
    }
}

Simulare front-end pentru validarea datelor

Fragment de cod front-end dinamic pentru a se asigura că datele din integrarea bazei de date sunt afișate corect.

fetch('/api/xTypeVersion')
    .then(response => response.json())
    .then(data => {
        const list = document.getElementById('entity-list');
        data.forEach(entity => {
            const item = document.createElement('li');
            item.textContent = entity.name;
            list.appendChild(item);
        });
    })
    .catch(error => console.error('Error fetching data:', error));

Teste unitare pentru consistența backend și front-end

Exemple de scripturi de testare pentru a valida atât logica backend, cât și integrarea front-end cu datele de testare.

import org.junit.jupiter.api.Test;
public class FrontEndValidationTest {
    @Test
    public void fetchData() {
        given().when().get("/api/xTypeVersion")
            .then().statusCode(200)
            .body("size()", greaterThan(0));
    }
}

Întrebări frecvente despre Quarkus, TestContainers și Integrarea Liquibase

1. Care este rolul TestContainers în teste de integrare?
2. TestContainers ajută la gestionarea instanțelor izolate de baze de date în timpul testării, asigurând medii consistente.
3. De ce am nevoie de withReuse(true) comanda?
4. The withReuse(true) comanda vă permite să reutilizați același container în mai multe teste, economisind resurse și timp de configurare.
5. Care este scopul TC_INITSCRIPT proprietate?
6. The TC_INITSCRIPT proprietatea specifică un script SQL de inițializare pentru a genera baza de date la pornirea containerului.
7. Cum mă asigur că migrările Liquibase sunt aplicate corect?
8. Prin configurarea quarkus.liquibase.jdbc.url proprietate, vă puteți asigura că Liquibase utilizează același container de bază de date ca și aplicația.
9. Ce niveluri de jurnal ar trebui să folosesc pentru depanare?
10. Set TRACE sau DEBUG niveluri pentru Liquibase și TestContainers pentru a monitoriza operațiunile și migrațiile bazei de date.
11. Cum pot testa răspunsurile API cu date seeded?
12. Folosiți instrumente precum RestAssured pentru a trimite cereri către punctele finale și pentru a verifica că datele returnate se potrivesc cu datele de testare.
13. Ce înseamnă @QuarkusTestResource adnotare face?
14. The @QuarkusTestResource adnotarea înregistrează un manager personalizat de ciclu de viață pentru dependențe externe, cum ar fi bazele de date.
15. De ce am nevoie de un TestProfileResolver personalizat?
16. Se asigură că sunt încărcate configurațiile corecte pentru execuția testului, aliniind variabilele de mediu și resursele.
17. Cum pot detecta dacă sunt create mai multe containere?
18. Verificați desktopul dvs. Docker sau monitorizați jurnalele consolei pentru instanțele de container duplicat și porturile respective.
19. Care este cel mai bun mod de a curăța resursele de testare?
20. Ignorați stop metoda din managerul ciclului de viață pentru a opri și elimina containerul după finalizarea testelor.

Recomandări cheie pentru rezolvarea conflictelor de testare

Testarea integrării cu Quarkus, Liquibase și TestContainers necesită o configurare atentă pentru a se asigura că migrările și interacțiunile cu bazele de date sunt aliniate. Personalizând managerul de resurse de testare și folosind o configurație unificată, puteți elimina conflictele dintre containerele utilizate de Liquibase și aplicația dvs.

Acești pași vă ajută să vă simplificați procesul de testare, facilitând depanarea și validarea testelor. Nu uitați să utilizați jurnalele detaliate, cum ar fi activarea URMĂ pentru Liquibase, pentru a monitoriza comportamentul testelor și pentru a rezolva din timp discrepanțele. Cu această abordare, puteți construi cu încredere teste scalabile și care pot fi întreținute. 🐛