Problémák megoldása Quarkus tesztekkel, teszttárolókkal és Liquibase integrációval

Megfelelő integráció biztosítása a Liquibase és a TestContainers között a Quarkusban

Backend megoldás Quarkus és TestContainers használatával a PostgreSQL és Liquibase migráció kezeléséhez. Ez a szkript megoldja a tároló helytelen igazítási problémáit.

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

Alkalmazás-Liquibase integráció érvényesítése egységtesztek segítségével

Moduláris és újrafelhasználható Quarkus tesztpélda, amely ellenőrzi az adatbázis-kapcsolatot és a migrációs parancsfájl végrehajtását.

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

Konfigurációs konzisztencia biztosítása a tesztprofilok között

Egyéni tesztprofil-konfiguráció a Liquibase és az alkalmazástárolók közötti összehangolás garantálásához.

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 szimuláció az adatok érvényesítéséhez

Dinamikus előtér-kódrészlet, amely biztosítja az adatbázis-integrációból származó adatok helyes megjelenítését.

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

A háttér és az előtér konzisztenciájának egységtesztjei

Példa tesztparancsfájlok a háttérlogika és az előtér-integráció ellenőrzésére tesztadatokkal.

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

GYIK a Quarkusról, a TestContainersről és a Liquibase Integrationről

1. Mi a szerepe TestContainers integrációs tesztekben?
2. TestContainers segít kezelni az elszigetelt adatbázis-példányokat a tesztelés során, konzisztens környezetet biztosítva.
3. Miért van szükségem a withReuse(true) parancs?
4. A withReuse(true) A parancs lehetővé teszi, hogy ugyanazt a tárolót több teszt során is felhasználja, így erőforrásokat és beállítási időt takaríthat meg.
5. Mi a célja a TC_INITSCRIPT ingatlan?
6. A TC_INITSCRIPT tulajdonság megad egy inicializálási SQL-parancsfájlt az adatbázis indításához a tároló indításakor.
7. Hogyan biztosíthatom, hogy a Liquibase-áttelepítések megfelelően legyenek alkalmazva?
8. A konfigurálásával a quarkus.liquibase.jdbc.url tulajdonságot, biztosíthatja, hogy a Liquibase ugyanazt az adatbázis-tárolót használja, mint az alkalmazás.
9. Milyen naplózási szinteket használjak a hibakereséshez?
10. Készlet TRACE vagy DEBUG szinteket a Liquibase és a TestContainers számára az adatbázis-műveletek és a migráció figyeléséhez.
11. Hogyan tesztelhetem az API-válaszokat magolt adatokkal?
12. Használjon olyan eszközöket, mint pl RestAssured kéréseket küldeni a végpontoknak, és ellenőrizni, hogy a visszaküldött adatok egyeznek-e a tesztadatokkal.
13. Mit jelent a @QuarkusTestResource annotáció csinálni?
14. A @QuarkusTestResource Az annotation egy egyéni életciklus-kezelőt regisztrál a külső függőségek, például az adatbázisok számára.
15. Miért van szükségem egyéni TestProfileResolverre?
16. Biztosítja a megfelelő konfigurációk betöltését a tesztvégrehajtáshoz, a környezeti változók és erőforrások összehangolásához.
17. Hogyan észlelhetem, ha több konténer jön létre?
18. Ellenőrizze a Docker Desktopot, vagy figyelje a konzolnaplókat a duplikált tárolópéldányok és a hozzájuk tartozó portok után.
19. Mi a legjobb módja a tesztforrások megtisztításának?
20. Felülírja a stop módszert az életciklus-kezelőben a tároló leállításához és eltávolításához a tesztek befejezése után.

A tesztelési konfliktusok megoldásának kulcsfontosságú lépései

A Quarkus, Liquibase és TestContainers integrációs tesztelése gondos beállítást igényel az áttelepítések és az adatbázis-interakciók összehangolása érdekében. A teszterőforrás-kezelő testreszabásával és egységes konfiguráció használatával kiküszöbölheti a Liquibase és az alkalmazás által használt tárolók közötti ütközéseket.

Ezek a lépések segítenek leegyszerűsíteni a tesztelési folyamatot, megkönnyítve a tesztek hibakeresését és érvényesítését. Ne felejtsen el részletes naplókat használni, például az engedélyezést NYOM a Liquibase esetében a tesztek viselkedésének nyomon követésére és az eltérések korai feloldására. Ezzel a megközelítéssel magabiztosan készíthet méretezhető és karbantartható teszteket. 🐛