Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

1. Introduktion

1.1. Formål

Formålet med dette dokument er at beskrive hvordan et udviklingsmiljø, til videreudvikling af DROS, kan sættes op, samt hvordan koden bygges, deployes og testes.

...

Hvor der i teksten er angivet <component base> refereres til topniveaufolderen for kildekoden for komponenten.

1.4. Dokument Historik


1/3 2021Eva Troels/KITUdarbejdet ved etableringen af DROS

1.5. Introduktion til DROS

...

Man skal bruge Maven til at bygge DROS, hvilket gøres ved at køre kommandoen

mvn package


Efter byg kan WAR filer findes her:

./dros-war/target/dros.war

3. Afvikling

Der henvises til installationsvejledningen for nærmere instrukser.

...

Dette kan gøres vha. docker-compose:

docker-compose -f compose/development/docker-compose.yml up --bulid

Når DROS er startet er, svarer den på:

...

Kildekoden bygges vha Maven, og kildekoden er struktureret som Maven moduler. DROS består af følgende moduler:

dros-xds

Sætter dependencies op i forhold til openehealth framework (en række exclusions er tilrådelige for at anvende dette framework på NSP).

Modulet indeholder også konfigurationsklasse til konfiguration af ITI-backends. Dette anvendes både af internt af DROS (til NSP XDS backends) samt til integrationstestene for DROS.

Derudover inderholder modulet statiske koder (f.eks. OID for CPR registeret og SOR), der anvendes rundt om i DROS.

dros-testutilitiesHjælpeklasser, der både skal bruges af unit tests samt af integrationstests for DROS ligger her.
dros-appDROS service- og forretningsfunktionalitet er samlet her. Se DROS - Design- og arkitekturbeskrivelse for en grundigere beskrivelse af strukturen i dette modul.
dros-war

Modul, der er ansvarlig for at pakke DROS som en NSP service - herunder angivelse af modulafhængigheder i deploymentdescriptor.

Indeholder også Dockerfile til selve byg af Docker image.

dros-qa

Integrationstest for DROS

dros-testreportModul til at samle jacoco test reports og beregne samlet test coverage.

4.2. Beskrivelse af testsetup

...

Unit tests afvikling under byg vha jacoco plugin for Maven, men kan separat afvikles ved at køre:

mvn test

Hvis der derimod laves en verify, så vil der også blive genereret code coverage, hvor fremkommende rapport kan ses i testreport/target/site/jacoco-aggregate/index.html

...

Integrationstests ligger i modulet dros-qa og kan afvikles med:

mvn -Plocal verify

Dette forudsætter at alle services er startet som angivet i docker-compose setuppet.

...