Przejdź do treści

Strona może być nieaktualna

Nikt jej nie zmieniał od 24 miesięcy (ostatni commit: 2024-11-04, Dariusz Bąkowski). Jeśli opisuje stan, którego już nie ma, zgłoś ją jako nieaktualną.

Testy integracyjne - dokumentacja

Spis treści

Wprowadzenie

Testy integracyjne powinny być wykonywane w środowisku, które nie jest zależne od zewnętrznych serwisów.

Główne cechy

  • Mockowanie API Marcos za pomocą MarcosMockApiEngine
  • Brak mockowania połączenia RabbitMQ (wymagany lokalny RabbitMQ)
  • Izolacja testów od zewnętrznych zależności
  • Możliwość testowania scenariuszy błędów
  • Redukcja obciążenia zewnętrznego API podczas testów

Klasa bazowa BaseIntegrationTest

Opis

BaseIntegrationTest to podstawowa klasa dla testów integracyjnych, która dostarcza wspólną infrastrukturę testową.

Funkcjonalności

  • Konfiguracja środowiska testowego z pliku 'application.yaml' (w module testów)
  • Ustawienie mocka MarcosApi przy użyciu MarcosMockApiEngine
  • Zapewnienie czystego środowiska dla każdego testu

Przykład implementacji

class MyIntegrationTest : BaseIntegrationTest() {
    @Test
    fun `test endpoint behavior`() = withTestApplication {
        // Kod testu
    }
}

Metoda withTestApplication

protected fun withTestApplication(block: suspend ApplicationTestBuilder.() -> Unit)

Parametry

  • block - kod testu do wykonania w kontekście aplikacji, zapewnia dostęp do ApplicationTestBuilder

Mockowanie odpowiedzi HTTP

Struktura mocków

Odpowiedzi HTTP można mockować poprzez tworzenie klas dziedziczących po BaseMockResponse.

Przykład mocka odpowiedzi

object LoadsMockResponse : BaseMockResponse() {
    override fun invoke(): String {
        return """
            {
                "@odata.context": "https://hoffmann.e-mbis.eu:1228/odata/${'$'}metadata#LoadsForPlaces",
                "value": [
                    {
                        "GrossWeight": 0.000,
                        "GrossWeightKg": 0.000,
                        "Amount": 25.000,
                        "Amount2": null,
                        "Id": 100000324,
                        "Weight": null,
                        "WeightGross": 0.000,
                        "WeightGrossKg": 0.000,
                        "Quantity": 25.000,
                        "Lenght": 0.00,
                        "Height": 0.00,
                        "Width": 0.00,
                        "Name": "Gips",
                        "Package": "luz",
                        "LoadingMeters": null,
                        "Volume": null
                        ...
                    }
                ]
            }
        """
    }
}

Ostatnia zmiana: 2024-11-04 · Dariusz Bąkowski
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e