Rješavanje problema s Quarkus testovima, testnim spremnicima i integracijom Liquibase

Osiguravanje pravilne integracije između Liquibase i TestContainers u Quarkusu

Pozadinsko rješenje koje koristi Quarkus s TestContainers za upravljanje PostgreSQL i Liquibase migracijama. Ova skripta rješava probleme neusklađenosti spremnika.

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

Provjera integracije aplikacije i Liquibase pomoću testova jedinica

Modularni primjer Quarkus testa za višekratnu upotrebu koji provjerava vezu s bazom podataka i izvršavanje skripte za migraciju.

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

Osiguravanje dosljednosti konfiguracije kroz testne profile

Prilagođena konfiguracija testnog profila koja jamči usklađenost između Liquibase i spremnika aplikacija.

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 provjeru valjanosti podataka

Dinamički prednji isječak koda kako bi se osiguralo ispravno prikazivanje podataka iz integracije baze podataka.

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

Jedinični testovi za dosljednost pozadinskog i prednjeg dijela

Primjeri testnih skripti za provjeru pozadinske logike i front-end integracije s testnim podacima.

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

Često postavljana pitanja o integraciji Quarkus, TestContainers i Liquibase

1. Koja je uloga TestContainers u integracijskim testovima?
2. TestContainers pomaže u upravljanju izoliranim instancama baze podataka tijekom testiranja, osiguravajući konzistentna okruženja.
3. Zašto mi treba withReuse(true) naredba?
4. The withReuse(true) naredba vam omogućuje ponovnu upotrebu istog spremnika u više testova, štedeći resurse i vrijeme postavljanja.
5. Koja je svrha TC_INITSCRIPT vlasništvo?
6. The TC_INITSCRIPT svojstvo specificira inicijalizacijsku SQL skriptu za sijanje baze podataka pri pokretanju spremnika.
7. Kako mogu osigurati ispravnu primjenu Liquibase migracija?
8. Konfiguriranjem quarkus.liquibase.jdbc.url svojstvu, možete osigurati da Liquibase koristi isti spremnik baze podataka kao i aplikacija.
9. Koje razine zapisnika trebam koristiti za otklanjanje pogrešaka?
10. set TRACE ili DEBUG razine za Liquibase i TestContainers za praćenje operacija baze podataka i migracija.
11. Kako mogu testirati odgovore API-ja s unesenim podacima?
12. Koristite alate poput RestAssured za slanje zahtjeva krajnjim točkama i provjeru podudaranja vraćenih podataka s testnim podacima.
13. Što znači @QuarkusTestResource napomena učiniti?
14. The @QuarkusTestResource annotation registrira prilagođeni upravitelj životnog ciklusa za vanjske ovisnosti poput baza podataka.
15. Zašto mi treba prilagođeni TestProfileResolver?
16. Osigurava učitavanje ispravnih konfiguracija za izvođenje testa, usklađivanje varijabli okoline i resursa.
17. Kako mogu otkriti stvara li se više spremnika?
18. Provjerite svoju radnu površinu Docker ili pratite zapise konzole za duplicirane instance spremnika i njihove odgovarajuće priključke.
19. Koji je najbolji način za čišćenje testnih resursa?
20. Nadjačaj stop metodu u vašem upravitelju životnog ciklusa za zaustavljanje i uklanjanje spremnika nakon završetka testova.

Ključni zaključci za rješavanje sukoba testiranja

Testiranje integracije s Quarkusom, Liquibaseom i TestContainersima zahtijeva pažljivo postavljanje kako bi se osiguralo usklađivanje migracija i interakcija baze podataka. Prilagođavanjem upravitelja testnih resursa i korištenjem objedinjene konfiguracije možete eliminirati sukobe između spremnika koje koristi Liquibase i vaše aplikacije.

Ovi koraci pomažu pojednostaviti vaš proces testiranja, olakšavajući otklanjanje pogrešaka i provjeru valjanosti vaših testova. Ne zaboravite koristiti detaljne zapisnike, kao što je omogućavanje TRAG za Liquibase, za praćenje ponašanja vaših testova i rano rješavanje nepodudarnosti. Ovim pristupom možete pouzdano izraditi skalabilne testove koji se mogu održavati. 🐛