Page History
| Navitabs | ||||||
|---|---|---|---|---|---|---|
| ||||||
Indhold
| Table of Contents |
|---|
Indledning
Dette dokument beskriver, hvordan MinLog2-løsningen bygges og hvad de forskellige moduler indeholder.
Dokumentet kan med fordel læses sammen med dokumentet "arkitektur_design" for overordnet forståelse. Desuden henvises der undervejs til "testvejledning" og "installationsvejledning".
Læsevejledning
Læseren forventes at have kendskab til National Sundheds-IT's platform NSP, samt generelt kendskab til WildFly applikation server, MariaDB og java.
Dokumenthistorik
Version | Dato | Ansvarlig | Beskrivelse |
| 1.2 | 20-09-2018 | Openminds | Yderligere specifikation i forbindelse med borgerservice |
1.1 | 12-12-2017 | Openminds | Ny borgerservice |
1.0 | 15-06-2017 | Openminds |
...
...
...
Definitioner og forkortelser
Definition | Beskrivelse |
NSP | Den nationale service platform (inden for sundheds-IT) |
...
...
...
Forudsætninger
Udover java (JDK 1.8) og WildFly, så kræver MinLog2 2 to databaser for at kunne afvikles lokalt
- MinLog2
- Stamdata
...
Stamdata databasen kan oprettes via script fra sql/stamdata_tables.sql som dog kun opretter de tabeller som er relevant for MinLog2. Det anbefales at importere et databasedump fra feks. et testmiljø.
...
Byg
MinLog2 er et standard maven projekt og bygges med
...
Helt som det er standard fører det til et byg af alle moduler, herunder earwar-filer som indeholder den kode, der skal deployes.
Projektet er delt i 2:
├── jee
└── kafka
Maven kan afvikles i de respektive foldere. Som en del af bygget afvikles alle unit-tests. Der er ingen af disse unit-tests, der har afhængigheder til netværk, database eller lignende.
I jee er det muligt at få dannet en projektrapport i targetfolderen – herunder coverage (folderen site) – ved at køre
...
Moduler
Der findes to undermoduler under service:
├── lookup
├── registration
...
Der findes 3 undermoduler
├── lookup
│ ├── lookup-core
│ ├── lookup-ear
│ └── lookup-ws
├── registration
│ ├── registration-core
│ ├── registration-ear
│ └── registration-ws
└── shared
├── shared-configuration
├── shared-core
└── shared-test
...
Lookup
Dette modul håndterer opslag udstillet som webservice og der er overvågningservices til rådighed.
Webservicen er beskrevet i en wsdl fil (contract first) og på baggrund af denne dannes java klasser med CXF.
Lookup-idws
Dette modul håndterer opslag udstillet som webservice og der er overvågningservices til rådighed.
Webservicen er beskrevet i en wsdl fil (contract first) og på baggrund af denne dannes java klasser med CXF. Vær opmærksom på at sikkerhed på denne service er defineret vha. WS-Policy.
...
Core
Databasekonfiguration er angivet i en persistence unit, der peger på datasource.
Indeholder service (forretningskode) og domain delene.
...
WS
Indeholder webservice implementeringen.
...
War
Artifaktet som kan deployes til JBossWildfly. Find earwar-filen i target/.
Databasekonfiguration er angivet i en persistence unit, der peger på datasource.
...
Shared
Shared ligger i roden af projektet. Den indeholder komponenter, der på den ene eller anden måde er delt mellem registration, lookup og consumer.
Nedenfor beskrives indholdet af de enkelte komponenter.
...
Dette modul håndterer registrering af log hændelser udstillet som webservice, overvågningservices til rådighed.
Webservicen er beskrevet i en wsdl fil (contract first) og på baggrund af denne dannes java klasser med CXF.
...
Indeholder service (forretningskode) og domain delene.
Databasekonfiguration er angivet i en persistence unit, der peger på datasource. Det skal nævnes at registreringer på nuværende tidspunkt udelukkende foretages direkte til den centrale MinLog2 database.
...
Indeholder webservice implementeringen.
...
Artifaktet som kan deployes til JBoss. Find ear-filen i target/.
Databasekonfiguration er angivet i en persistence unit, der peger på datasource.
...
Disse moduler er fælles moduler og ikke nødvendigvis en del af den deployede kode.
...
Shared-configuration
Dette modul gør det muligt at få dannet de filer, der skal være på JBoss Wildfly serveren. Indeholder primært filer til opsætning af logning og datasources.
...
Dokumentet installationsvejledning indeholder yderligere information om brugen af disse.
...
...
Shared-
...
ws
Fælles kode til blandt andet håndtering af sikkerhed, audit, SLA logning og en del utility klasser.
...
shared-db
Fælles kode til skrivning af log entries til database.
shared-domain-api
Objekter, der udveksles via Kafka.
...
Shared-test
Dette modul anvendes i forbindelse med afviklingen af integrationtests: Dels har to formål
- Benyttes til afvikling af integrationtests
- Indeholder kode til dannelse af IDCard (wsse header), dels kode til dannelse og eksekvering af webservicerequests.
Anvendelsen af dette er beskrevet i dokumentet "testvejledning".
Shared-test-idws
Dette modul anvendes Som shared-test anvendes dette modul delse i forbindelse med afviklingen af integrationtests: Dels , dels til generering af klient kode og eksekvering af webservicerequests.
Anvendelsen af dette er beskrevet i dokumentet "testvejledning".