Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Navitabs
rootDigital Post Adapter Generisk udstilling (MHD) - Leverancebeskrivelse


...

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

...

Dette dokument er en del af den samlede dokumentation for DPAMHD.

Dokumentets relation til de øvrige dokumenter er beskrevet i dokumentationsoversigten for DPAMHD.

Læsevejledning

Læser forventes at have kendskab til ...Java, Maven, Wildfly, Spring og NSP Access Handler.

Introduktion til

...

MHD

DPA MHD Snitfladen er defineret i en ... MHD - Adgang, brug og snitflader

MHD er en Java-baseret komponentDPA er Java baserede komponenter, der baserer sig på Java 21 og ??? frameworket, WildFly 34.0.0 som applikationsserver, og anvender Jakarta Web Services (Jakarta WS) til eksponering af webservice-endpoints.

Design og arkitektur er beskrevet : ....i MHD - Design- og arkitekturbeskrivelse

Opsætning af udviklingsmiljø

I det følgende antages at koden er hentet fra git: https://git.nspop.dk/scm/bffcom/minmobile-graviditetaccess-backendto-forhealth-frontenddocuments.git

Krav til software

DPA deployeres vha. ...MHD deployeres til Docker via docker compose:

Derudover er der krav til de anvendte udviklingsværktøjer:

  • Maven ??? 3.6.3 eller højere anvendes.

Bygge komponeten

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

...


Efter byg kan WAR filer findes her:

./dros-warservice/target/drosmhd.war

Afvikling

Efter byg kan DPA MHD afvikles vha. .... Til dette formål findes ....For at starte DPA Docker. For at starte MHD afvikles følgende kommando:

Udviklers workstation

...

Dette kan gøres vha. ....:

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

...


./docker-compose -f compose/development/docker-compose.yml build --pull

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

Beskrivelse af systemdesign

Systemdesign er beskrevet i MHD - Design- og arkitekturbeskrivelse.

...

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

commonIndeholder kode fælles for moduler bl.a.  konfiguration og af komponenten  
dds-clientIndeholder kode til at tilgå dokument delings service (dds)
serviceIndeholder kode til udstilling af end points
integration-testIndeholder test der kræver en kørende instans

Beskrivelse af testsetup

Unittests

??? JUnit anvendes til implementering af unit tests . Der er kontinuert gennemført unit tests på alle komponenter i projektet.Unit tests afvikling under byg vha ??? plugin for Maven, men kan separat afvikles ved at køreog kan afvikles som følger:

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

Integrationstests ligger i modulet ??? og kan afvikles med:

...

mvn verify -???

...


Integrationstests

Integrationstests afvikles med:

Hvor følgende gælder:

test.urlAdresse på MHD'en some man ønsker at integrationstests skal udføres mod. 
dros.urlAdresse på Dynamisk Request Generator, som benyttes af integrationstesten til at oprette relevante dokumenter i DDS, hvis disse ikke i forvejen eksisterer.

Hvis man ønsker af afvikle testen op mod en andet miljø f.eks. test1 eller test2 henvises til MHD - Testvejledning., kan man angive det ved at ændre test url

Dokument Historik

3/4 2025Martin Henriksen/SDSEtablering af dokumentation
27/6 2025Thomas GlæsnerUdfyldt