...

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.

Ændringslog

Integrationstests

Integrationstests kan både afvikles på en lokal automatisk konfiguret Wildfly-server og på et eksternt miljøIntegrationstest skal afvikles mod den deployede komponent med test-opsætning.

Selve integrationstestene består af en test-klasser med en række forskellige typer kald.

• DGWSITCase: Tester succesfuldt DGWS kald.
• IDWSITCase: Tester succesfuldt IDWS kald.
• ExampleFilesITCase: Tester forskellige eksempler på operationer (fx create, update, delete) ved kald direkte på servicen, som kun er muligt under lokal integrationstest. Ved ekstern integrationstest køres nogle af testene på det eksterne miljø vha. DGWS kald.
• ServletITCase: Tester diverse ikke-webservice-endpoints (fx /isAlive og /dksconfig).

...

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:

• En Wildfly-server startes automatisk op og der inkluderes servicens Wildfly-modul med konfigurationsfiler.
• wsproxy komponentens konfigurationsfiler kopieres ind i Wildfly's configuration-mappe.
• En MariaDB database-driver deployes.
• Der installeres en datasource, der peger på samme database som beskrevet under afvikling af unit-tests.
• wsproxy komponenten deployes.
• Selve servicen skr-service deployes.
• Integrationstestene køres.

Afvikling mod eksternt miljø

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 specificerede miljø:

mvn verify -pl skr-test -PextITs -DitAddress=http://127.0.0.1:8080/skr

I ovenstående kommando erstattes kan 127.0.0.1:8080 med  erstattes med adressen på det eksterne eksternt 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 transaktionelidempotent.

Afvikling af unittests

Vejledning til afvikling af unit-tests er beskrevet i installationsvejledningen.

...