Reševanje težav s testi Quarkus, testnimi vsebniki in integracijo Liquibase

Zagotavljanje ustrezne integracije med Liquibase in TestContainers v Quarkus

Zaledna rešitev, ki uporablja Quarkus s TestContainers za upravljanje selitev PostgreSQL in Liquibase. Ta skript odpravlja težave z neporavnanostjo vsebnika.

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

Preverjanje integracije aplikacij in Liquibase z uporabo testov enot

Modularen in ponovno uporabljiv primer preizkusa Quarkus, ki preverja povezavo z bazo podatkov in izvedbo migracijskega skripta.

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

Zagotavljanje doslednosti konfiguracije med testnimi profili

Konfiguracija testnega profila po meri za zagotavljanje usklajenosti med Liquibase in vsebniki aplikacij.

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 simulacija za validacijo podatkov

Dinamični izrezek kode na sprednji strani za zagotovitev pravilnega prikaza podatkov iz integracije baze podatkov.

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

Preizkusi enote za doslednost zadnjega in sprednjega dela

Primeri testnih skriptov za preverjanje tako logike zaledja kot sprednje integracije s testnimi podatki.

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

Pogosta vprašanja o integraciji Quarkus, TestContainers in Liquibase

1. Kakšna je vloga TestContainers v integracijskih testih?
2. TestContainers pomaga pri upravljanju izoliranih primerkov baze podatkov med testiranjem, kar zagotavlja dosledna okolja.
3. Zakaj potrebujem withReuse(true) ukaz?
4. The withReuse(true) vam omogoča ponovno uporabo istega vsebnika v več testih, s čimer prihranite vire in čas nastavitve.
5. Kakšen je namen TC_INITSCRIPT lastnina?
6. The TC_INITSCRIPT Lastnost podaja inicializacijski skript SQL za zasedanje baze podatkov ob zagonu vsebnika.
7. Kako zagotovim, da so migracije Liquibase pravilno uporabljene?
8. S konfiguracijo quarkus.liquibase.jdbc.url lahko zagotovite, da Liquibase uporablja isti vsebnik baze podatkov kot aplikacija.
9. Katere ravni dnevnika naj uporabim za odpravljanje napak?
10. Set TRACE oz DEBUG ravni za Liquibase in TestContainers za spremljanje operacij baze podatkov in migracij.
11. Kako lahko preizkusim odzive API-ja s sejanimi podatki?
12. Uporabite orodja, kot je RestAssured za pošiljanje zahtev končnim točkam in preverjanje ujemanja vrnjenih podatkov s testnimi podatki.
13. Kaj pomeni @QuarkusTestResource opomba narediti?
14. The @QuarkusTestResource annotation registrira upravljalnik življenjskega cikla po meri za zunanje odvisnosti, kot so baze podatkov.
15. Zakaj potrebujem TestProfileResolver po meri?
16. Zagotavlja, da so naložene pravilne konfiguracije za izvajanje testa, usklajevanje spremenljivk okolja in virov.
17. Kako lahko ugotovim, ali se ustvarja več vsebnikov?
18. Preverite namizje Docker ali spremljajte dnevnike konzole glede podvojenih primerkov vsebnika in njihovih ustreznih vrat.
19. Kateri je najboljši način za čiščenje testnih virov?
20. Preglasi stop metodo v upravitelju življenjskega cikla, da ustavite in odstranite vsebnik po končanih preskusih.

Ključni zaključki za reševanje sporov pri testiranju

Testiranje integracije s Quarkusom, Liquibase in TestContainers zahteva skrbno nastavitev, da se zagotovi usklajenost migracij in interakcij baze podatkov. S prilagoditvijo upravitelja testnih virov in uporabo poenotene konfiguracije lahko odpravite konflikte med vsebniki, ki jih uporablja Liquibase, in vašo aplikacijo.

Ti koraki pomagajo poenostaviti vaš postopek testiranja, kar olajša odpravljanje napak in preverjanje vaših testov. Ne pozabite uporabiti podrobnih dnevnikov, kot je omogočanje TRACE za Liquibase, za spremljanje obnašanja vaših testov in zgodnje odpravljanje neskladij. S tem pristopom lahko samozavestno zgradite razširljive in vzdržljive teste. 🐛