Przejdź do treści

Dane testowe z build-test-data

Strona opisuje, jak tworzyć obiekty domenowe w testach integracyjnych apollo-backend za pomocą pluginu build-test-data. Jest dla programistów, którzy piszą specyfikacje w src/integration-test. Uruchamianie testów i infrastrukturę opisuje strona Testy integracyjne z Testcontainers.

Zasada działania

Plugin io.github.longwa:build-test-data w wersji 5.0.0 dodaje do każdej encji domenowej metodę build(). Metoda wypełnia wszystkie wymagane pola, czyli nullable: false, i buduje wymagane powiązania. Na końcu zapisuje obiekt w bazie. Nowe pole wymagane w encji zwykle nie wymaga zmiany w testach.

Plugin buduje tylko właściwości wymagane. Opcjonalne powiązania zostają puste, dopóki test ich nie poda.

Podstawowe użycie

Company.build()                          // wszystkie wartości domyślne, encja zapisana
Company.build(name: 'ACME')              // nadpisanie jednego pola
Checkpoint.build()                       // buduje też Transport, Task, Workflow i Person
Task.build(workflow: workflow)           // przekazane powiązanie jest używane ponownie
Company.build(save: false)               // poprawna, ale niezapisana encja
Company.findOrBuild()                    // istniejąca encja albo nowa
build(Company, [name: 'ACME'])           // metoda traitu TestDataBuilder

Specyfikacja dziedziczy po IntegrationSpec, który implementuje trait TestDataBuilder. Trait dostarcza metodę build(Class, props) i sprząta cache między testami.

Gotowe przykłady zawiera src/integration-test/groovy/logintegra/BuildTestDataSampleSpec.groovy.

Gdzie trzymać wartości

Miejsce Co tam trafia
Test Tylko wartości istotne dla asercji, na przykład Checkpoint.build(expectedDate: yesterday).
src/integration-test/resources/TestDataConfig.groovy Reguły obowiązujące wszędzie: pola unique, wartości o określonym formacie, reguły sprawdzane w kodzie zamiast w constraintach.
Metoda pomocnicza w support/ Powtarzalne scenariusze z wieloma encjami, na przykład transport na checkpoincie załadunku z potwierdzonym awizo.

Wpis w TestDataConfig.groovy dodajemy dopiero wtedy, gdy build() zgłasza błąd walidacji. Wartość podana jako domknięcie liczy się przy każdym wywołaniu build().

testDataConfig {
    sampleData {
        'logintegra.user.Person' {
            username = { -> "user-${System.nanoTime()}".toString() }
        }
    }
}

Plik leży w src/integration-test/resources, więc nie trafia do artefaktu produkcyjnego. Nie umieszczamy go w grails-app/conf.

Konfiguracja dla jednego testu

Metoda doWithTestDataConfig() zwraca domknięcie z konfiguracją, która scala się z globalną na poziomie encji. Po teście trzeba przywrócić konfigurację globalną.

Ostatnia zmiana: 2026-10-16 · Dariusz Bakowski
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e