حل المشكلات المتعلقة باختبارات Quarkus وحاويات الاختبار وتكامل Liquibase

ضمان التكامل السليم بين Liquibase وحاويات الاختبار في Quarkus

حل الواجهة الخلفية باستخدام Quarkus مع TestContainers لإدارة عمليات ترحيل PostgreSQL وLiquibase. يعمل هذا البرنامج النصي على حل مشكلات عدم محاذاة الحاوية.

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

التحقق من صحة تكامل التطبيق-Liquibase باستخدام اختبارات الوحدة

مثال اختبار Quarkus المعياري والقابل لإعادة الاستخدام والذي يتحقق من اتصال قاعدة البيانات وتنفيذ البرنامج النصي للترحيل.

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

ضمان اتساق التكوين عبر ملفات تعريف الاختبار

تكوين ملف تعريف اختبار مخصص لضمان التوافق بين Liquibase وحاويات التطبيق.

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

محاكاة الواجهة الأمامية للتحقق من صحة البيانات

مقتطف التعليمات البرمجية الديناميكي للواجهة الأمامية لضمان عرض البيانات من تكامل قاعدة البيانات بشكل صحيح.

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

اختبارات الوحدة لتناسق الواجهة الخلفية والأمامية

أمثلة على البرامج النصية للاختبار للتحقق من صحة منطق الواجهة الخلفية وتكامل الواجهة الأمامية مع بيانات الاختبار.

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 وLiquibase

1. ما هو دور TestContainers في اختبارات التكامل؟
2. TestContainers يساعد في إدارة مثيلات قاعدة البيانات المعزولة أثناء الاختبار، مما يضمن بيئات متسقة.
3. لماذا أحتاج إلى withReuse(true) يأمر؟
4. ال withReuse(true) يسمح لك الأمر بإعادة استخدام نفس الحاوية عبر اختبارات متعددة، مما يوفر الموارد ووقت الإعداد.
5. ما هو الغرض من TC_INITSCRIPT ملكية؟
6. ال TC_INITSCRIPT تحدد الخاصية برنامج نصي SQL للتهيئة لقاعدة البيانات عند بدء تشغيل الحاوية.
7. كيف أتأكد من تطبيق عمليات ترحيل Liquibase بشكل صحيح؟
8. من خلال تكوين quarkus.liquibase.jdbc.url الخاصية، يمكنك التأكد من أن Liquibase يستخدم نفس حاوية قاعدة البيانات مثل التطبيق.
9. ما مستويات السجل التي يجب أن أستخدمها لتصحيح الأخطاء؟
10. تعيين TRACE أو DEBUG مستويات Liquibase وTestContainers لمراقبة عمليات قاعدة البيانات وعمليات الترحيل.
11. كيف يمكنني اختبار استجابات واجهة برمجة التطبيقات باستخدام البيانات المصنفة؟
12. استخدم أدوات مثل RestAssured لإرسال الطلبات إلى نقاط النهاية والتحقق من تطابق البيانات التي تم إرجاعها مع بيانات الاختبار.
13. ماذا يفعل @QuarkusTestResource الشرح تفعل؟
14. ال @QuarkusTestResource يسجل التعليق التوضيحي مدير دورة حياة مخصصًا للتبعيات الخارجية مثل قواعد البيانات.
15. لماذا أحتاج إلى TestProfileResolver مخصص؟
16. فهو يضمن تحميل التكوينات الصحيحة لتنفيذ الاختبار، ومحاذاة متغيرات البيئة والموارد.
17. كيف يمكنني اكتشاف ما إذا كان يتم إنشاء حاويات متعددة؟
18. تحقق من Docker Desktop أو راقب سجلات وحدة التحكم بحثًا عن مثيلات الحاوية المكررة والمنافذ الخاصة بها.
19. ما هي أفضل طريقة لتنظيف موارد الاختبار؟
20. تجاوز stop طريقة في مدير دورة الحياة لإيقاف الحاوية وإزالتها بعد اكتمال الاختبارات.

الوجبات السريعة الرئيسية لحل تعارضات الاختبار

يتطلب اختبار التكامل مع Quarkus، وLiquibase، وTestContainers إعدادًا دقيقًا لضمان توافق عمليات الترحيل وتفاعلات قاعدة البيانات. من خلال تخصيص مدير موارد الاختبار الخاص بك واستخدام تكوين موحد، يمكنك التخلص من التعارضات بين الحاويات التي يستخدمها Liquibase وتطبيقك.

تساعد هذه الخطوات في تبسيط عملية الاختبار، مما يسهل تصحيح أخطاء اختباراتك والتحقق من صحتها. تذكر استخدام السجلات التفصيلية، مثل التمكين يتعقب لـ Liquibase، لمراقبة سلوك اختباراتك وحل التناقضات مبكرًا. باستخدام هذا النهج، يمكنك بثقة إنشاء اختبارات قابلة للتطوير وقابلة للصيانة. 🐛