Quarkus Testleri, Test Kapları ve Liquibase Entegrasyonu ile İlgili Sorunları Çözme

Quarkus'ta Liquibase ve TestContainer'lar Arasında Uygun Entegrasyonun Sağlanması

PostgreSQL ve Liquibase geçişlerini yönetmek için Quarkus'u TestContainers ile kullanan arka uç çözümü. Bu komut dosyası kapsayıcının yanlış hizalanması sorunlarını çözer.

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

Birim Testlerini Kullanarak Uygulama-Liquibase Entegrasyonunun Doğrulanması

Veritabanı bağlantısını ve geçiş komut dosyası yürütmesini doğrulayan modüler ve yeniden kullanılabilir bir Quarkus test örneği.

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

Test Profilleri Arasında Yapılandırma Tutarlılığının Sağlanması

Liquibase ve uygulama konteynerleri arasında hizalamayı garanti etmek için özel test profili konfigürasyonu.

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

Veri Doğrulaması için Ön Uç Simülasyonu

Veritabanı entegrasyonundan elde edilen verilerin doğru şekilde görüntülenmesini sağlamak için dinamik ön uç kod pasajı.

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

Arka Uç ve Ön Uç Tutarlılığı için Birim Testleri

Test verileriyle hem arka uç mantığını hem de ön uç entegrasyonunu doğrulamak için örnek test komut dosyaları.

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

Quarkus, TestContainers ve Liquibase Entegrasyonu Hakkında SSS

1. Rolü nedir? TestContainers entegrasyon testlerinde?
2. TestContainers test sırasında yalıtılmış veritabanı örneklerinin yönetilmesine yardımcı olarak tutarlı ortamlar sağlar.
3. Neden ihtiyacım var? withReuse(true) emretmek?
4. withReuse(true) komutu, aynı kapsayıcıyı birden çok testte yeniden kullanmanıza, kaynaklardan ve kurulum süresinden tasarruf etmenize olanak tanır.
5. Amacı nedir? TC_INITSCRIPT mülk?
6. TC_INITSCRIPT özelliği, kapsayıcı başlangıcında veritabanını tohumlamak için bir başlatma SQL komut dosyasını belirtir.
7. Liquibase geçişlerinin doğru şekilde uygulandığından nasıl emin olabilirim?
8. Yapılandırarak quarkus.liquibase.jdbc.url özelliğini kullanarak Liquibase'in uygulamayla aynı veritabanı kapsayıcısını kullanmasını sağlayabilirsiniz.
9. Hata ayıklama için hangi günlük düzeylerini kullanmalıyım?
10. Ayarlamak TRACE veya DEBUG Veritabanı işlemlerini ve geçişlerini izlemek için Liquibase ve TestContainers seviyeleri.
11. API yanıtlarını tohumlanmış verilerle nasıl test edebilirim?
12. Gibi araçları kullanın RestAssured uç noktalara istek göndermek ve döndürülen verilerin test verileriyle eşleştiğini doğrulamak için.
13. Ne yapar @QuarkusTestResource ek açıklama?
14. @QuarkusTestResource ek açıklama, veritabanları gibi harici bağımlılıklar için özel bir yaşam döngüsü yöneticisini kaydeder.
15. Neden özel bir TestProfileResolver'a ihtiyacım var?
16. Ortam değişkenlerini ve kaynaklarını hizalayarak testin yürütülmesi için doğru yapılandırmaların yüklenmesini sağlar.
17. Birden fazla konteynerin oluşturulup oluşturulmadığını nasıl tespit edebilirim?
18. Yinelenen konteyner örnekleri ve ilgili bağlantı noktaları için Docker Masaüstünüzü kontrol edin veya konsol günlüklerini izleyin.
19. Test kaynaklarını temizlemenin en iyi yolu nedir?
20. Geçersiz kıl stop Testler tamamlandıktan sonra yaşam döngüsü yöneticinizdeki konteyneri durdurup kaldırma yöntemini kullanın.

Test Anlaşmazlıklarını Çözmeye Yönelik Temel Çıkarımlar

Quarkus, Liquibase ve TestContainers ile entegrasyon testleri, geçişlerin ve veritabanı etkileşimlerinin uyumlu olmasını sağlamak için dikkatli kurulum gerektirir. Test kaynak yöneticinizi özelleştirerek ve birleşik bir konfigürasyon kullanarak, Liquibase tarafından kullanılan konteynerler ile uygulamanız arasındaki çakışmaları ortadan kaldırabilirsiniz.

Bu adımlar test sürecinizi kolaylaştırmaya yardımcı olarak testlerinizde hata ayıklamayı ve doğrulamayı kolaylaştırır. Etkinleştirme gibi ayrıntılı günlükleri kullanmayı unutmayın. İZ Liquibase için testlerinizin davranışını izlemek ve tutarsızlıkları erkenden çözmek için. Bu yaklaşımla güvenle ölçeklenebilir ve bakımı yapılabilir testler oluşturabilirsiniz. 🐛