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