Menyelesaikan Isu dengan Ujian Quarkus, Bekas Ujian dan Penyepaduan Liquibase

Memastikan Penyepaduan Betul Antara Liquibase dan TestContainers dalam Quarkus

Penyelesaian backend menggunakan Quarkus dengan TestContainers untuk mengurus migrasi PostgreSQL dan Liquibase. Skrip ini menyelesaikan isu salah jajaran kontena.

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

Mengesahkan Penyepaduan Aplikasi-Liquibase Menggunakan Ujian Unit

Contoh ujian Quarkus modular dan boleh digunakan semula yang mengesahkan sambungan pangkalan data dan pelaksanaan skrip pemindahan.

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

Memastikan Konfigurasi Konsisten Merentas Profil Ujian

Konfigurasi profil ujian tersuai untuk menjamin penjajaran antara Liquibase dan bekas aplikasi.

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

Simulasi Bahagian Hadapan untuk Pengesahan Data

Coretan kod bahagian hadapan dinamik untuk memastikan data daripada penyepaduan pangkalan data dipaparkan dengan betul.

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

Ujian Unit untuk Konsistensi Bahagian Belakang dan Bahagian Depan

Contoh skrip ujian untuk mengesahkan kedua-dua logik bahagian belakang dan penyepaduan bahagian hadapan dengan data ujian.

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

Soalan Lazim Mengenai Quarkus, TestContainers dan Penyepaduan Liquibase

1. Apakah peranan TestContainers dalam ujian integrasi?
2. TestContainers membantu mengurus kejadian pangkalan data terpencil semasa ujian, memastikan persekitaran yang konsisten.
3. Mengapa saya memerlukan withReuse(true) perintah?
4. The withReuse(true) arahan membolehkan anda menggunakan semula bekas yang sama merentas berbilang ujian, menjimatkan sumber dan masa persediaan.
5. Apakah tujuan TC_INITSCRIPT harta benda?
6. The TC_INITSCRIPT hartanah menentukan skrip SQL permulaan untuk membenihkan pangkalan data pada permulaan kontena.
7. Bagaimanakah cara saya memastikan migrasi Liquibase digunakan dengan betul?
8. Dengan mengkonfigurasi quarkus.liquibase.jdbc.url harta, anda boleh memastikan Liquibase menggunakan bekas pangkalan data yang sama seperti aplikasi.
9. Apakah tahap log yang harus saya gunakan untuk nyahpepijat?
10. Tetapkan TRACE atau DEBUG tahap untuk Liquibase dan TestContainers untuk memantau operasi pangkalan data dan migrasi.
11. Bagaimanakah saya boleh menguji respons API dengan data berbiji?
12. Gunakan alatan seperti RestAssured untuk menghantar permintaan ke titik akhir dan mengesahkan data yang dikembalikan sepadan dengan data ujian.
13. Apa yang @QuarkusTestResource anotasi lakukan?
14. The @QuarkusTestResource anotasi mendaftarkan pengurus kitaran hayat tersuai untuk kebergantungan luaran seperti pangkalan data.
15. Mengapa saya memerlukan TestProfileResolver tersuai?
16. Ia memastikan konfigurasi yang betul dimuatkan untuk pelaksanaan ujian, menjajarkan pembolehubah persekitaran dan sumber.
17. Bagaimanakah saya boleh mengesan jika berbilang bekas sedang dibuat?
18. Semak Desktop Docker anda atau pantau log konsol untuk contoh bekas pendua dan port masing-masing.
19. Apakah cara terbaik untuk membersihkan sumber ujian?
20. mengatasi stop kaedah dalam pengurus kitaran hayat anda untuk menghentikan dan mengalih keluar bekas selepas ujian selesai.

Pengambilan Utama untuk Menyelesaikan Konflik Ujian

Ujian integrasi dengan Quarkus, Liquibase dan TestContainers memerlukan persediaan yang teliti untuk memastikan migrasi dan interaksi pangkalan data sejajar. Dengan menyesuaikan pengurus sumber ujian anda dan menggunakan konfigurasi bersatu, anda boleh menghapuskan konflik antara bekas yang digunakan oleh Liquibase dan aplikasi anda.

Langkah ini membantu memperkemas proses ujian anda, menjadikannya lebih mudah untuk nyahpepijat dan mengesahkan ujian anda. Ingat untuk menggunakan log terperinci, seperti mendayakan JEJAK untuk Liquibase, untuk memantau tingkah laku ujian anda dan menyelesaikan percanggahan lebih awal. Dengan pendekatan ini, anda boleh membina ujian berskala dan boleh diselenggara dengan yakin. 🐛