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æseren forventes at have kendskab til National Sundheds-IT's platform NSP, samt generelt kendskab til WildFly applikation server, MariaDB og java.
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 |
Definition | Beskrivelse |
NSP | Den nationale service platform (inden for sundheds-IT) |
Udover java (JDK 1.8) og WildFly, så kræver MinLog2 2 databaser for at kunne afvikles lokalt
MinLog2 databasen kan oprettes via script fra sql/initial_schema.sql fra modulet shared-configuration.
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ø.
MinLog2 er et standard maven projekt og bygges med
|
Helt som det er standard fører det til et byg af alle moduler, herunder war-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.
Der findes 1 modul - consumer. Dette modul lytter på et kafka topic efter entries til MinLog2. Ved modtagelse indsættes de i databasen.
Modulet er en SpringBoot applikation som bygges på standard maven måden
mvn clean install |
Her er det muligt at få dannet en projektrapport i targetfolderen – herunder coverage (folderen site) – ved at køre
mvn site |
Der findes 3 undermoduler
├── lookup
│ ├── lookup-core
│ ├── lookup-ear
│ └── lookup-ws
├── registration
│ ├── registration-core
│ ├── registration-war
│ └── registration-ws
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 war-filen i target/.
Databasekonfiguration er angivet i en persistence unit, der peger på datasource.
Kode/konfiguration delt mellem registration, lookup og consumer. Se beskrivelse i MinLog2 - Min Log Opslag - Guide til udviklere#Shared