Problēmu risināšana ar Quarkus testiem, testa konteineriem un Liquibase integrāciju

Pareizas integrācijas nodrošināšana starp Liquibase un TestContainers Quarkus

Aizmugursistēmas risinājums, izmantojot Quarkus ar TestContainers, lai pārvaldītu PostgreSQL un Liquibase migrācijas. Šis skripts atrisina konteinera neatbilstības problēmas.

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

Lietojumprogrammu-Liquibase integrācijas apstiprināšana, izmantojot vienību testus

Modulārs un atkārtoti lietojams Quarkus testa piemērs, kas pārbauda datu bāzes savienojumu un migrācijas skripta izpildi.

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ācijas konsekvences nodrošināšana testa profilos

Pielāgota testa profila konfigurācija, lai garantētu saskaņošanu starp Liquibase un lietojumprogrammu konteineriem.

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

Priekšgala simulācija datu validācijai

Dinamisks priekšgala koda fragments, lai nodrošinātu datu no datu bāzes integrācijas pareizu attēlošanu.

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

Vienību testi aizmugursistēmas un priekšgala konsekvencei

Testa skriptu piemēri, lai pārbaudītu gan aizmugurloģiku, gan priekšgala integrāciju ar testa datiem.

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

Bieži uzdotie jautājumi par Quarkus, TestContainers un Liquibase integrāciju

1. Kāda ir loma TestContainers integrācijas testos?
2. TestContainers palīdz pārvaldīt izolētas datu bāzes gadījumus testēšanas laikā, nodrošinot konsekventu vidi.
3. Kāpēc man vajag withReuse(true) komanda?
4. The withReuse(true) komanda ļauj atkārtoti izmantot vienu un to pašu konteineru vairākos testos, ietaupot resursus un iestatīšanas laiku.
5. Kāds ir mērķis TC_INITSCRIPT īpašums?
6. The TC_INITSCRIPT rekvizīts norāda inicializācijas SQL skriptu, lai sāktu datubāzi konteinera startēšanas laikā.
7. Kā nodrošināt, ka Liquibase migrācijas tiek piemērotas pareizi?
8. Konfigurējot quarkus.liquibase.jdbc.url īpašumu, varat nodrošināt, ka Liquibase izmanto to pašu datu bāzes konteineru kā lietojumprogramma.
9. Kādus žurnāla līmeņus man vajadzētu izmantot atkļūdošanai?
10. Iestatīt TRACE vai DEBUG līmeņi Liquibase un TestContainers, lai uzraudzītu datu bāzes darbības un migrāciju.
11. Kā es varu pārbaudīt API atbildes ar sākotnējiem datiem?
12. Izmantojiet tādus rīkus kā RestAssured lai nosūtītu pieprasījumus galapunktiem un pārbaudītu, ka atgrieztie dati atbilst testa datiem.
13. Ko dara @QuarkusTestResource anotācija darīt?
14. The @QuarkusTestResource anotācija reģistrē pielāgotu dzīves cikla pārvaldnieku ārējām atkarībām, piemēram, datu bāzēm.
15. Kāpēc man ir nepieciešams pielāgots TestProfileResolver?
16. Tas nodrošina, ka testa izpildei tiek ielādētas pareizās konfigurācijas, saskaņojot vides mainīgos un resursus.
17. Kā es varu noteikt, vai tiek izveidoti vairāki konteineri?
18. Pārbaudiet savu Docker Desktop vai pārraugiet konsoles žurnālus, lai atrastu dublētus konteinera gadījumus un to attiecīgos portus.
19. Kāds ir labākais veids, kā iztīrīt testa resursus?
20. Ignorēt stop metodi savā dzīves cikla pārvaldniekā, lai apturētu un noņemtu konteineru pēc testu pabeigšanas.

Galvenās metodes testēšanas konfliktu risināšanai

Integrācijas testēšanai ar Quarkus, Liquibase un TestContainers ir nepieciešama rūpīga iestatīšana, lai nodrošinātu migrācijas un datu bāzes mijiedarbības saskaņošanu. Pielāgojot testa resursu pārvaldnieku un izmantojot vienotu konfigurāciju, varat novērst konfliktus starp Liquibase izmantotajiem konteineriem un jūsu lietojumprogrammu.

Šīs darbības palīdz racionalizēt testēšanas procesu, atvieglojot testu atkļūdošanu un apstiprināšanu. Atcerieties izmantot detalizētus žurnālus, piemēram, iespējot TRACE Liquibase, lai uzraudzītu jūsu testu darbību un savlaicīgi novērstu neatbilstības. Izmantojot šo pieeju, varat droši izveidot mērogojamus un uzturējamus testus. 🐛