Introduktion

Formål

Formålet med dette dokument er at beskrive de tests, som er udviklet og afviklet forud for release af LAR servicen.

Følgende typer af test bruges indgår i udviklingsarbejdet:

Unittests: Unittests tester, at de individuelle/isolerede enheder (klasser) i kildekoden virker som de skal.
Integrationstest: Integrationstests afvikles op i mod en kørende LAR service til verifikation af funktion og deployment. Herved verificeres det, at de individuelle enheder kan integreres og arbejde sammen i en kørende service.
Performancetest: Verificerer, at servicen performer med hensyn til svartider og er stabil under et specifikt load.

Andre typer af tests (ikke en del af udviklingen af LAR):

Endurancetests, der verificerer at servicen fungerer under længerevarende belastning og ikke har f.eks. memory leaks, som kan udføres i stagning/produktionslignende miljø.

De i LAR anvendte tests gennemgåes i det følgende.

Dokumentet henvender sig til udviklere og testere.

Læseren forventes at have kendskab til Java software udvikling, herunder unittesting ved anvendelse af JUnit og Maven.

Følgende tests er afviklet som en del af udviklingen af LAR.

Der henvises i øvrigt til LAR Udviklerguide for udførselsvejledning og LAR Testrapport for resultat.

Der findes UnitTests af alle centrale enheder (klasser) i LAR.

Placeringen af disse følger standarden foreskrevet af Maven og er placeret i src/test/java i hvert af LAR servicens moduler.

Unittests er navngivet med navnet på den klasse, som de tester, efterfulgt af Test.

Således ligger unittesten for klassen:

./larservice-cave/src/main/java/dk/sds/larservice/cave/client/CaveClient.java

implementeret i:

./larservice-cave/src/test/java/dk/sds/larservice/cave/client/CaveClientTest.java

Unittests er stilmæssigt opbygget på følgende måde:

Hver testcase er implementeret som en metode i den relevante testklasse
Testcasen er navngivet, så det tydeligt fremgår, hvad formålet med testen er
Kommentarer i testcasen inddeler tydeligt i præcondition (Given), udførsel (When), tjek (Then) som beskrevet f.eks. Martin Fowler: Given-When-Then

Unittests er implementeret vha JUnit og kan eksekveres af Mavens standard testplugin SureFire.

Til udregning af testcoverage anvendes Jacoco Maven Plugin (se JaCoCo Maven plug-in).

Testcoverage udregnes i de enkelte Maven moduler i LAR servicen og aggregeres til en samlet rapport i modulet larservice-integrationtest.

Således er en samlet rapport over testcoverage tilgængelig i

./larservice-integrationtest/target/site/jacoco-aggregate/

Unittests og tilhørende udregning af testcoverage udføres som en integreret del af byg af komponenten (se i øvrigt LAR Udviklerguide).

Integrationstestene for LAR er implementeret vha JUnit, og er beregnet til afvikling mod en kørende udgave af LAR.

Integrationstest aktiveres via Maven ved følgende kommando:

mvn test -Pintegration-tests -Dintegrationtestpropdir=src/test/integrationstest-localhost

hvor "integrationtestpropdir" udpeger det underbibliotek, hvor den skal ledes efter test.properties (og eventuelle jks).

Integrationstesten afvikles ikke som en del af byg.

Indholdet af test.properties er som følger:

Property	Beskrivelse

Ved aktivering af integrationstesten vil helbreds/versionsservice afprøves.

Derudover vil der laves test af oprettelse samt hentning af allergioplysninger via LAR.

TODO