Indholdsfortegnelse

Opsætning af udviklingsmiljø

Alt koden kan findes i følgende Subversion repository:

https://svn.nspop.dk/svn/importers/sebimporter/

Koden kan derefter importeres som projekt i en ønsket IDE (som Eclipse eller IntelliJ).

Projektet bygges af Maven, og er lavet til at køre under Java 8 og Wildfly 8.

Det anbefales også at installere Docker, men det er ikke strengt nødvendigt.

Beskrivelse af kodens struktur

Importeren er organiseret i et enkelt modul, som ud over koden indeholder sql-filer til opsætning af databasetabeller.

Der ud over indeholder projektet et docker-compose setup som der kan afvikles integrationstests mod.

Bygge WAR-fil

For at bygge projektet og producere en war-fil køres kommandoen

Flaget skipTests er nødvendigt, da udførsel af tests forudsætter en kørende MySQL-database.

Beskrivelse af test setup

For at køre projektets tests startes det inkluderede docker-compose setup først:

Dernæst kan tests udføres med kommandoen

Hvis test coverage rapporten skal skrives, skal Maven's package step også køres. I det tilfælde vil kommandoen se sådan ud:

Coverage rapporten vil kunne findes under følgende lokation:

target/site/jacoco/index.html

Tests kan indstilles ved at rette i filen:

src/test/resources/test.properties

Alle test properties burde allerede være opsat som de bør være, og ingen konfiguration er nødvendigt.

Deployment

En war fik kan genereres ved at køre Maven kommandoen:

mvn package

I mappen compose/development findes en docker-compose.yml fil, som laver et deployment af import modulet og opsætning, samt database for stamdata modulet. Dette er den anbefalede måde at prøve en deployment på, da det vil ske i et produktionslignende miljø hver gang.