„Quarkus“ testų, testavimo talpyklų ir „Liquibase“ integravimo problemų sprendimas

Tinkamos „Liquibase“ ir „TestContainers“ integracijos užtikrinimas „Quarkus“.

Backend sprendimas naudojant Quarkus su TestContainers PostgreSQL ir Liquibase migracijai valdyti. Šis scenarijus išsprendžia sudėtinio rodinio nesutapimo problemas.

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

Programos-Liquibase integracijos patvirtinimas naudojant vienetų testus

Modulinis ir daugkartinio naudojimo Quarkus testo pavyzdys, kuris patikrina duomenų bazės ryšį ir perkėlimo scenarijaus vykdymą.

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

Konfigūracijos nuoseklumo užtikrinimas visuose bandymo profiliuose

Pasirinktinė bandymo profilio konfigūracija, užtikrinanti Liquibase ir taikomųjų programų konteinerių suderinimą.

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 modeliavimas duomenų patvirtinimui

Dinaminis sąsajos kodo fragmentas, užtikrinantis, kad duomenys iš duomenų bazės integravimo būtų tinkamai rodomi.

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

Užpakalinės ir priekinės dalies nuoseklumo vienetų testai

Bandomųjų scenarijų pavyzdžiai, skirti patvirtinti užpakalinės sistemos logiką ir sąsajos integraciją su bandymo duomenimis.

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

DUK apie Quarkus, TestContainers ir Liquibase integraciją

1. Koks yra vaidmuo TestContainers integracijos testuose?
2. TestContainers padeda valdyti izoliuotus duomenų bazės atvejus testavimo metu, užtikrinant nuoseklią aplinką.
3. Kodėl man reikia withReuse(true) komandą?
4. The withReuse(true) komanda leidžia pakartotinai naudoti tą patį konteinerį atliekant kelis bandymus, taupant išteklius ir sąrankos laiką.
5. Koks yra tikslas TC_INITSCRIPT nuosavybė?
6. The TC_INITSCRIPT ypatybė nurodo inicijavimo SQL scenarijų, kad būtų galima pradėti duomenų bazę paleidžiant konteinerį.
7. Kaip užtikrinti, kad „Liquibase“ perkėlimas būtų pritaikytas tinkamai?
8. Konfigūruodami quarkus.liquibase.jdbc.url ypatybę, galite užtikrinti, kad „Liquibase“ naudotų tą patį duomenų bazės konteinerį kaip ir programa.
9. Kokius žurnalo lygius turėčiau naudoti derinimui?
10. Nustatyti TRACE arba DEBUG lygiai, skirti Liquibase ir TestContainers stebėti duomenų bazės operacijas ir perkėlimą.
11. Kaip galiu išbandyti API atsakymus su pradiniais duomenimis?
12. Naudokite tokius įrankius kaip RestAssured siųsti užklausas galutiniams taškams ir patikrinti, ar pateikti duomenys atitinka bandymo duomenis.
13. Ką daro @QuarkusTestResource anotacija daryti?
14. The @QuarkusTestResource anotacija registruoja pasirinktinį gyvavimo ciklo tvarkyklę išorinėms priklausomybėms, pvz., duomenų bazėms.
15. Kodėl man reikia pasirinktinio TestProfileResolver?
16. Tai užtikrina, kad būtų įkeltos teisingos konfigūracijos, kad būtų galima atlikti testą, suderinti aplinkos kintamuosius ir išteklius.
17. Kaip nustatyti, ar kuriami keli konteineriai?
18. Patikrinkite „Docker Desktop“ arba stebėkite konsolės žurnalus, ar nėra pasikartojančių konteinerių egzempliorių ir atitinkamų jų prievadų.
19. Koks yra geriausias būdas išvalyti bandymo išteklius?
20. Nepaisyti stop savo gyvavimo ciklo tvarkytuvėje, kad sustabdytumėte ir pašalintumėte konteinerį, kai bus baigti bandymai.

Pagrindiniai bandymų konfliktų sprendimo būdai

Norint užtikrinti, kad perkėlimas ir duomenų bazės sąveika būtų suderinta, norint atlikti integracijos testavimą su Quarkus, Liquibase ir TestContainers reikia kruopščiai nustatyti. Tinkindami bandomųjų išteklių tvarkyklę ir naudodami vieningą konfigūraciją, galite pašalinti konfliktus tarp „Liquibase“ naudojamų konteinerių ir programos.

Šie veiksmai padeda supaprastinti testavimo procesą, todėl lengviau derinti ir patvirtinti testus. Nepamirškite naudoti išsamių žurnalų, pvz., įgalinimo TRACE Liquibase, kad galėtumėte stebėti savo testų veikimą ir anksti pašalinti neatitikimus. Taikydami šį metodą galite užtikrintai kurti keičiamus ir prižiūrimus testus. 🐛