Overblik

Dette dokument beskriver projektstrukturen i Organdonorregister-servicen og har derudover til formål at gøre det muligt for andre end den oprindelige leverandør at overtage videreudvikling af projektet. Dokumentet bygger videre på informationen beskrevet i de andre dokumenter tilhørende projektet.

Projektet er opbygget som et Maven multi-module project, hvor nogle moduler kompilerer til jar-filer og andre til war-filer. De nævnes her i den rækkefølge de kompileres:

• odr-parent

  • odr-schemas
    JAX-WS-artifakt generator genererer Java-klasser ud fra projektets WSDL-filer.

  • odr-service
    Selve servicens funktionalitet.

  • odr-service-wildfly
    Wildfly-specifik funktionalitet.

  • odr-migration
    Migreringskomponent.

  • odr-datagenerator
    Datageneratorkomponent.

For at kunne fungere med DGWS og IDWS forudsættes at DGWS/IDWS Proxy Service også er installeret.  Der henvises til guide for udviklere for proxy'en for nærmere beskrivelse af denne.

Ændringslog

Afvikling af unit-tests

For at afvikle unit-tests skal en MariaDB-database være tilgængelig.

I udviklingssammenhæng og ved unit-tests kan man nøjes med én databasebruger og én database. Disse kan oprettes vha. scripterne recreate_service_user.sql og recreate_database.sql som er lokaliseret under odr-service/src/test/resources/db. Derefter kan Flyway automatisk initialisere databasen.

Datasourcen i testafviklingen auto-konfigureres vha. Spring Boot som anvender database-credentials fra odr-service/src/test/resources/application.properties. De default værdier matcher værdierne i de førnævnte SQL-scripts.

Projektet skal være fuldt bygget for at lokale dependencies er på plads, og dernæst kan unit tests afvikles med følgende Maven kommando:

mvn clean test

Der genereres desuden en testrapport.

Databasevedligehold

Servicen benytter i udviklingssammenhæng Flyway, hvilket gør at databasen i udviklingsmiljøet automatisk opdateres til gældende version. Eneste forudsætning er at recreate_database.sql script samt recreate_service_user.sql script, som er placeret i odr-service/src/test/resources/db/, er blevet afviklet mod databasen.

På miljøer hvor der skal være mulighed for rollback, benyttes migrerings scripts fra odr-service/src/test/resources/db/migration.

XSD-vedligehold

XSDerne der eksporteres og benyttes i servicen ligger i modulet organdonor-schema. Der genereres JAXB-klasser som defineret i modulets pom.xml

Adgange

Der er behov for adgange til følgende systemer:

• SVN-repository for ODR: https://svn.nspop.dk/svn/trifork/odr/

• Dependencies trækkes fra NSP's Nexus-repository: https://nexus.nspop.dk

Opsætning af udviklingsmiljø

Al kode findes i SVN: https://svn.nspop.dk/svn/trifork/odr/

Efter at projektet er checket ud vil man typisk gøre følgende:

• Opsætte udviklingsmiljø (her antages IntelliJ)

• Bygge war-filen med Maven og køre tests 

Kodestruktur

Koden er opdelt i 5 maven-moduler:

1. odr-schemas: Indeholder de WSDL og XSD-filer som definerer servicens webservice-snitflade. 
2. odr-service: Indeholder selve service-funktionaliteten, inkl Unit -og integrationsTest
3. odr-service-wildfly: Indeholder wildfly specifikke elementer
4. odr-migration: Indeholder al logik til migrering, afhængig af odr-service
5. odr-datagenerator: Bruges kun i test-sammenhæng til at generere realistiske data og datamængder

Bygge WAR filer

Følgende software er nødvendigt for at bygge projektet

• En Subversion-klient

• Java 8

• Maven

• MariaDB

Gennemfør følgende steps for at bygge WAR filer:

1. Installér og start MariaDB

2. Klon projektet fra SVN: https://svn.nspop.dk/svn/trifork/odr/

3. Opret database via script i odr-service/src/test/resources/db

4. For at bygge projektet, foretage unittests samt at bygge war-filer foretages kommandoen: mvn clean install

Opsætning af IntelliJ Idea

Man åbner blot pom.xml fra rodbiblioteket. Efter en mvn clean install bør dependencies være på plads.

Deployment på Wildfly

Når man udvikler kan det være praktisk at deploye applikationen på en lokal Wildfly server, da det er denne applikationsserver som bruges i NSP produktionsmiljø. Der henvises til Installationsvejledning (ODR) for nærmere instrukser.