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:

parameterbeskrivelsedefault
sts.hostHvor skal testen trække SOSI Idkort, der skal anvendes under testenhttp://test1.ekstern-test.nspop.dk:8080
nsp.hostHvilket miljø skal testen rammelocalhost
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_testdataSkal der oprettes testdata, inden testen køres?false
db_userDatabasebruger, der skal anvendes til at oprette testdata (hvis testdata skal oprettes)root
db_pwdPassword 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

  • No labels