Lösa problem med Quarkus-tester, testbehållare och Liquibase-integration

Säkerställa korrekt integration mellan Liquibase och TestContainers i Quarkus

Backend-lösning som använder Quarkus med TestContainers för att hantera PostgreSQL- och Liquibase-migreringar. Det här skriptet löser problem med behållarens feljustering.

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();
        }
    }
}

Validera applikation-Liquibase-integration med hjälp av enhetstester

Ett modulärt och återanvändbart Quarkus-testexempel som verifierar databasanslutningen och körningen av migreringsskript.

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.");
    }
}

Säkerställ konfigurationskonsistens över testprofiler

Anpassad testprofilkonfiguration för att garantera anpassning mellan Liquibase och applikationsbehållare.

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");
    }
}

Front-end-simulering för datavalidering

Dynamiskt gränssnittskodavsnitt för att säkerställa att data från databasintegration visas korrekt.

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));

Enhetstester för konsistens i backend och front-end

Exempel på testskript för att validera både backend-logik och front-end-integrering med testdata.

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));
    }
}

Vanliga frågor om Quarkus, TestContainers och Liquibase Integration

1. Vad är rollen för TestContainers i integrationstester?
2. TestContainers hjälper till att hantera isolerade databasinstanser under testning, vilket säkerställer konsekventa miljöer.
3. Varför behöver jag withReuse(true) kommando?
4. De withReuse(true) kommandot låter dig återanvända samma behållare över flera tester, vilket sparar resurser och konfigureringstid.
5. Vad är syftet med TC_INITSCRIPT egendom?
6. De TC_INITSCRIPT egenskapen anger ett initialiserings-SQL-skript för att seed databasen vid containerstart.
7. Hur säkerställer jag att Liquibase-migreringar tillämpas korrekt?
8. Genom att konfigurera quarkus.liquibase.jdbc.url egenskap, kan du se till att Liquibase använder samma databasbehållare som applikationen.
9. Vilka loggnivåer ska jag använda för felsökning?
10. Uppsättning TRACE eller DEBUG nivåer för Liquibase och TestContainers för att övervaka databasoperationer och migrering.
11. Hur kan jag testa API-svar med seedad data?
12. Använd verktyg som RestAssured att skicka förfrågningar till endpoints och verifiera att de returnerade data stämmer överens med testdata.
13. Vad gör @QuarkusTestResource anteckning göra?
14. De @QuarkusTestResource annotation registrerar en anpassad livscykelhanterare för externa beroenden som databaser.
15. Varför behöver jag en anpassad TestProfileResolver?
16. Det säkerställer att korrekta konfigurationer laddas för testkörning, anpassning av miljövariabler och resurser.
17. Hur kan jag upptäcka om flera behållare skapas?
18. Kontrollera din Docker Desktop eller övervaka konsolloggarna för dubbletter av containerinstanser och deras respektive portar.
19. Vad är det bästa sättet att rensa upp testresurser?
20. Åsidosätt stop metod i din livscykelhanterare för att stoppa och ta bort behållaren efter att testerna är klara.

Nyckelalternativ för att lösa testkonflikter

Integrationstestning med Quarkus, Liquibase och TestContainers kräver noggrann installation för att säkerställa att migrationer och databasinteraktioner stämmer överens. Genom att anpassa din testresurshanterare och använda en enhetlig konfiguration kan du eliminera konflikter mellan behållarna som används av Liquibase och din applikation.

Dessa steg hjälper till att effektivisera din testprocess, vilket gör det lättare att felsöka och validera dina tester. Kom ihåg att använda detaljerade loggar, som att aktivera SPÅRA för Liquibase, för att övervaka beteendet hos dina tester och lösa avvikelser tidigt. Med detta tillvägagångssätt kan du med säkerhet bygga skalbara och underhållbara tester. 🐛