Indholdsfortegnelse

Introduktion

Formål

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

Først beskrives de softwaremæssige krav, der er til miljøet, samt hvordan kode hentes og bygges. Dernæst beskrives deployment-miljøet.

Kodestrukturen, kodemæssige afhængigheder til tredjeparts moduler og de forskellige servicemodulers ansvar og design beskrives sidst i dette dokument sammen med testdesign.

Sammenhæng med øvrige dokumenter

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

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

Læsevejledning

Læser forventes at have kendskab til Java, Maven og Spring.

Introduktion til DPA

DPA Snitfladen er defineret i en ...

DPA er Java baserede komponenter, der baserer sig på Java 21 og ??? frameworket.

Design og arkitektur er beskrevet: ....

Opsætning af udviklingsmiljø

I det følgende antages at koden er hentet fra git: https://git.nspop.dk/scm/bff/min-graviditet-backend-for-frontend.git

Krav til software

DPA deployeres vha. ...

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

• Maven ??? eller højere anvendes.

Bygge komponeten

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

Efter byg kan WAR filer findes her:

Afvikling

Efter byg kan DPA afvikles vha. .... Til dette formål findes ....

For at starte DPA afvikles følgende kommando:

Udviklers workstation

Når man udvikler kan det være praktisk at foretage lokal deployment.

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

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

• Services: Se ...

Beskrivelse af systemdesign

Systemdesign er beskrevet i DPA - Design- og arkitekturbeskrivelse.

Beskrivelse af kildekodens strukturering og design

Kode strukturering

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

Beskrivelse af testsetup

Unittests

??? 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øre:

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:

Dette forudsætter at alle services er startet som angivet i ??? setuppet

Hvis man ønsker af afvikle testen op mod en andet miljø f.eks. test1 eller test2 henvises til DPA - Testvejledning.

Dokument Historik