Page History
...
Formålet med dette dokument er at beskrive hvordan et udviklingsmiljø, til videreudvikling af DDS registry Registry og Repository, kan sættes op, samt hvordan koden bygges, deployes og testes.
...
Læser forventes at have kendskab til Java softwareudvikling med anvendelse af Maven, WildFly applikationsserver Docker og MySQL.
Hvor der i teksten er angivet <component base> refereres til topniveaufolderen for kildekoden for komponenten.
...
Introduktion til DDS Registry og Repository
Realisering af DDS registry Registry og repository Repository består af en Java-baseret baserede webservices.
Webservicene tillader anvender systemer at
lave forespørgsler til dokumentdelingsservice og få metadata om patientinformationer, der er gemt derii de bagvedliggende XDS Registries, retur. Den filtrerer resultatet baseret på borgerens samtykker.
- foretage udtræk af patient specifikke dokumenter fra XDS dokument kildesystemer. Den filtrerer dokumenterne DDS filtrerer under visse omstændigheder dokumentindholdet baseret på borgerens samtykker.
...
Opsætning af udviklingsmiljø
I det følgende antages at koden er hentet ned fra softwarebørsen el.lign.DDS source koden ligger i SVN på følgende URL: https://svn.nspop.dk/svn/components/dds/
Krav til software
Krav til applikationsserveren, operativsystemet og databasen udviklingsmaskiner er de samme som til produktionsmiljøet. De specifikke krav kan ses i [DDS - Installationsvejledning] afsnit 2.
Derudover er der en række krav til de anvendte udviklingsværktøjer:Krav til
- Maven
...
- 3.0.3 eller højere
...
- .
Krav til Docker
...
- Docker 18.x eller højere.
- docker-compose version 1.23.x eller højere
...
- .
Bygge komponenten
Udfør følgende kommando for at bygge komponenten:
mvn clean install
Det tager lidt tid, da der skal genereres kode ud fra et større antal wsdl-filer.
Unit test (JUnit)
...
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
Integrationstest
For at køre integrationstesten gøres følgende:
Byg DDS, som beskrevet ovenfor
Udfør følgende kommandoer:
...
Aktuel code coverage beregnes også af Jenkins. Se https://jenkins.nspop.dk/.
Afvikle komponenten
Efter byg kan DDS afvikles vha docker-compose. Til dette formål findes compose-setup i mappen compose.
For at starte DDS afvikles følgende kommando (build parameteren sikrer, at DDSens Docker images bygges):
cd compose/development docker-compose |
...
up |
...
--build |
Vent på at setuppet kommer op (loggen falder til ro).
Integrationstest
For at køre integrationstesten gøres følgende. DDS komponenten afvikles i docker-compose som beskrevet ovenfor.
Dernæst kan integrationstestene startes med følgende kommandoer:
cd integrationstest mvn |
...
verify |
...
-Plocal,integration-tests |
Det er muligt at ramme andre miljøer end det lokale ved at udskifte local med test1 eller test2.
...