1. Indholdsfortegnelse
2. Introduktion
2.1. Formål
Dette dokument beskriver testvejledning for BRS.
Projektet bygges med Maven og kræver Java 8 samt Docker for at kunne afvikle tests.
2.2. 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 og Maven.
3. Afvikling af unittests
Afvikling af unit tests sker i forbindelse med byg af servicen, og byg er kun succesfuldt, hvis alle unit tests udføres succesfuldt.
Afvikling af test kan også ske ved udførsel af "mvn clean test".
Der dannes en rapport med test coverage. Rapoprten er en HTML rapport og findes i folderen "testreport/target/site/jacoco-aggregate". I denne folder er der en index.html fil.
4. Afvikling af integrationstests
Integrationstestene for BRS ligger som en del af BRS sourcekoden i mappen integration.
Testen kan afvikles med følgende kommando:
mvn test -Dsts.host=[stshost] -Dnsp.host=[nsphost] -Dbrs.minnotifications=[number] -Dcreate_testdata=[false/true] -Ddb_user=[mysqlusername] -Ddb_pwd=[mysqlpassword] |
---|
De konkrete værdierne til parametrene defineres udfra følgende beskrivelse:
parameter | beskrivelse | default |
---|---|---|
sts.host | Hvor skal testen trække SOSI Idkort, der skal anvendes under testen | http://test1.ekstern-test.nspop.dk:8080 |
nsp.host | Hvilket miljø skal testen ramme | localhost |
brs.minnotifications | brs.minnotifications bør være sat til en værdi som er en smule mindre end største serialnumber på en notifikation i miljøet. En for høj værdi giver funktionelle fejl. En for lav værdi giver en lang/længere initialiseringstid. | 0 |
create_testdata | Skal der oprettes testdata, inden testen køres? | false |
db_user | Databasebruger, der skal anvendes til at oprette testdata (hvis testdata skal oprettes) | root |
db_pwd | Password for databasebrugeren (hvis testdata skal oprettes) |
Defaultværdierne svarer til at afvikle integrationstesten mod det Dockerbaserede udviklingssetup, der er beskrevet i BRS - Guide til Udviklere.
Hvis man ønsker at oprette testdata i det Dockerbaserde udviklingssetup, kan man med fordel anvende følgende:
mvn test -Dcreate_testdata=true -Ddb_pwd=rootroot
Eksempelværdier til afvikling af integrationsttests mod NSP miljøet TEST1:
mvn test -Dsts.host=http://test1.ekstern-test.nspop.dk:8080 -Dnsp.host=http://test1.ekstern-test.nspop.dk:8080 -Dbrs.minnotifications=690000
5. Code coverage
Efter afvikling af unittests genereres en testrapport med Maven-plugin’et JaCoCo. Rapporten kan ses ved at åbne følgende fil i en browser:
testreport/target/site/jacoco-aggregate/index.html