Dette dokument beskriver en testvejledning for Stamkortregister-servicen. Det forudsættes at projektet er bygget og installeret, og med denne vejledning kan man således afvikle integrations- og performancetests og derved kontrollere robustheden.
Version | Dato | Ændring | Ansvarlig |
|---|---|---|---|
1.0.0 | 2018-08-31 | Initialt dokument | Trifork |
Integrationstests kan både afvikles på en lokal automatisk konfiguret Wildfly-server og på et eksternt miljø.
Selve integrationstestene består af en test-klasser med en række forskellige typer kald.
Ved lokal afvikling af integrationstests starter Maven automatisk en Wildfly-server op, konfigurerer den med de nødvendige ressourcer, deployer servicen og endeligt køres integrationstestene på dette miljø.
For at afvikle integrationstests lokalt skal Maven-profilen ITs aktiveres, og dette gøres med følgende Maven kommando:
mvn clean install -PITs
Bemærk at dette først bygger hele projektet og afvikler unit-tests; se installationsvejledningen for vejledning til afvikling af disse. Under afvikling af unit-tests opretter Flyway automatisk de database-tabeller der også anvendes i den lokale integrationstest.
Når Maven når til integration-test-fasen, og ITs-profilen er aktiveret, sker der følgende:
Når servicens er installeret og deployet på et eksternt miljø, kan korrekt deployment verificeres ved at køre integrationstestene på det eksterne miljø. Dette gøres ved at anvende følgende Maven-kommando, som aktiverer Maven-profilen extITs og specificerer adressen på det eksterne miljø:
mvn verify -pl skr-test -PextITs -DitAddress=http://127.0.0.1:8080/skr
I ovenstående kommando erstattes 127.0.0.1:8080 med adressen på det eksterne miljø.
Bemærk at dette kræver, at projektet er fuldt bygget, for at lokale dependencies er på plads.
Bemærk endeligt at integrationstestene opretter data, der ikke slettes igen, dvs. afviklen er altså ikke transaktionel.
Vejledning til afvikling af unit-tests er beskrevet i installationsvejledningen.
Efter afvikling af unit-tests genereres en testrapport med Maven-plugin’et JaCoCo. Rapporten kan ses ved at åbne følgende fil i en browser skr-service/target/site/jacoco/index.html.
Rapporten dækker selve servicen, dvs. koden i modulet skr-service. Codecoverage er minimum 80%. Der henvises til JaCoCo testrapporten for yderligere information vedr. coverage. Bemærk at JaCoCo ikke kan verificere linjer, der kaster exceptions, og at sådanne linjer altid vil stå som missed.