Page History
Indhold
| Table of Contents |
|---|
Introduktion
Formål
Formålet mked dette dokument er at beskrive, hvordan et udviklingsmiljø til videreudvikling af CAVE, kan sættes op, samt hvordan koden bygges, deployes og testes.
...
Der forefindes også en beskrivelse af de forskellige modulers ansvar samt hvordan unit og integrationstest afvikles. .
Læsevejledning
Læser forventes at have kendskab til Java softwareudvikling med anvendelse af Maven og WildFly.
Dokument historik
Dato | Ansvarlig | Beskrivelse |
|---|---|---|
| 5/2-2018 | KvalitetsIT | Initiel version |
Definitioner og referencer
Reference | Beskrivelse |
NSP | Den nationale service platform (inden for sundheds-IT) |
LAR service | Den service der kalder CAVE servicen. |
| HAPI | |
| FHIR | Fast Health Interoperability Resources |
Introduktion til CAVE servicen
CAVE servicen udstiller en standard FHIR REST snitflade.
...
Design og arkitektur er beskrevet: CAVE - Design- og Arkitekturbeskrivelse
Opsætning af udviklingsmiljø
I det følgende antages at koden er hentet ned fra SVN: https://svn.nspop.dk/svn/kvalitetsit/cave/
Krav til software
Krav til applikationsserveren og operativsystemet er de samme som til produktionsmiljøet. De specifikke krav kan ses i https://www.nspop.dk/display/public/web/Husregler+for+udvikling+til+NSP
...
Maven 3.0.3 eller højere anvendes.
Bygge WAR filen
Man skal bruge Apache Maven til at bygge CAVE servicen, hvilket gøres ved at køre kommandoen
$ mvn clean install
...
/cave-war/target/cave.war
Deployment på Wildfly
Der henvises til installationsvejledningen CAVE - Driftsvejledning for nærmere instrukser.
Udviklers workstation
Når man udvikler, kan det være praktisk at foretage deploy til en lokal Wildfly.
Beskrivelse af systemdesign
Systemdesign er beskrevet i CAVE - Design- og Arkitekturbeskrivelse
Beskrivelse af kildekodens strukturering og design
Kode strukturering
Kildekoden bygges vha Apache Maven, og kildekoden er struktureret som Maven moduler, som vist nedenfor.
...
cave-testclient er konfiguration af en web test client. Den kan bruges til at læse cave oplysninger i forbindelse med test og udvikling.
Logningsstrategi
Logning i applikationsloggen gøres efter følgende regler:
- Fejl logges med værdier når relevant
- Dette kan f.eks. være valideringsfejl
- Det må ikke være personhenførbar information
- Der logges med følgende niveauer:
- DEBUG: anvendes til at kunne følge en given logik. Mellemregninger.
- INFO: anvendes til at informere om et givet resultat, f.eks. hvad værdien er, når der opstår en valideringsfejl
- ERROR: anvendes i fejlsituationer, hvor driften skal adviseres, f.eks. når der ikke kan skrives til SLA loggen
- TRACE: anvendes typisk i ind og udgange af metoder
Beskrivelse af testsetup
Unittests (JUnit)
JUnit anvendes til implementering af unit tests. Der er kontinuert gennemført unit tests på alle komponenter i projektet.
Unit tests kan afvikles ved at køre:
mvn test
Integrationstests
Integrationstests kan afvikles på to måder. De kan enten afvikles mod en vilkårlig JBOSS instans eller mod en installation i docker på den lokale maskine. Sidst nævnte metode sørger selv for at starte containere med database og applikationsserver. Det sker ved hjælpe af tescontainers.org.
...