Introduktion

Formål

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

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

• Unittests, der verificerer, at de individuelle enheder i kildekoden virker efter hensigten, herunder måling af code coverage.

• Integrationstest: Integrationstests, der afvikles op imod kørende EAS service til verifikation af funktionalitet og deployment.

Læsevejledning

Dokumentet henvender sig til udviklere og testere.

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

UnitTests

Der findes UnitTests af centrale enheder (klasser) i EAS. Testene er implementeret vha JUnit.

Testene udføres som en integreret del af byg af komponenten, men kan også afvikles separat med kommandoen

mvn test

Ønsker man en detaljeret rapport af testudførslerne, kan dette gøres via Surefire:

mvn surefire-report:report

Herefter vil der findes testrapporter for de individuelle moduler under:

target/reports/surefire.html

Testcoverage

Jacoco anvendes til at lave en testrapport med coverage for hele applikationen. Rapporten generes ved at køre

mvn verify

Herefter vil Jacoco rapporten være at finde under:

coverage/target/site/jacoco-aggregate/index.html

Integrationstests

Integrationstestene for EAS er implementeret vha Cucumber og JUnit i modulet integrationtests, og er beregnet til afvikling mod en kørende udgave af EAS.

Testene er implementeret i "EasIT.java", og er inddelt i en feature for hver EAS-operation. I hver af disse features benyttes forskellige nøgler afhængigt af, hvilke data der findes på det konkrete miljø.

Integrationstestene tjekker primært om kaldene går igennem, eller giver fejl, alt efter hvad forventningen er i den givne situation. Mere specifik forretningslogik testes igennem unit-testene.

Afvikling

Først og fremmest skal der udføres scripts, som opsætter keystore med signeringscertifikatet fra Keycloak (Inkl. hele certifikatkæden), samt opsætter klientcertifikater til anvendelse mod EAS og fra EAS mod EER.

• setup_client_certificate.sh
  setup_keycloak_trust.sh

De 2 scripts kan udføres via nspbuilder fra og med version 4.0.5:

docker run --rm -it -v "$PWD":/workspace -w /workspace -e revision="snapshot" registry.nspop.dk/tools/nspbuilder:4.0.5 ./setup_keycloak_trust.sh
docker run --rm -it -v "$PWD":/workspace -w /workspace -e revision="snapshot" registry.nspop.dk/tools/nspbuilder:4.0.5 ./setup_client_certificate.sh

Afvikling af Integrationstests aktiveres via Maven med følgende kommando:

mvn verify -pl integrationtest -Pintegration-test -Denvironment=local

Dette vil afvikle integrationstestene mod lokalt kørende EAS-services.

Testene kan også afvikles mod NSP's test miljøer ved at ændre argumentet environment. F.eks.

mvn verify -pl integrationtest -Pintegration-test -Denvironment=test1

Der er følgende muligheder for test miljøer:

Bemærk. hvis det ønskes at afvikle integrationstests mod services køres i lokalt docker-compose setup, skal services først startes (se Guide til udviklere).

Afhængigt af valget af "environment" skal der findes konfiguration til afvikling af testen - hvis der fx vælges environment=local skal der findes en local.properties. Indholdet af filen beskrives i tabellen nedenfor: