...

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:

• ltr-btr-parent

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

  • ltr-btr-service
    Selve servicens funktionalitet.

  • ltr-btr-service-wildfly
    Wildfly-specifik funktionalitet.

  • ltr-migration
    Migreringskomponent.

  • ltr-btr-test-data-creator
    Datageneratorkomponent til brug ifm. performancetesting.

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. Når projektet bygges, så pakkes en war-fil til servicen og en war-fil til baggrundsjobbet.

Ændringslog

Afvikling af unit-tests

For at afvikle unit-tests skal en MariaDB-database være tilgængelig. Dette opnår man lettest ved at køre MariaDB i en Docker-container. Følgende kommando køres fra projektroden:

docker-compose -f compose/development/docker-compose.yml up --build

Bemærk: Det kan tage op mod et minut før containeren er klar. De nødvendige databaser bliver oprettet automatisk. Bemærk at projektet skal bygges før ovenstående kommando fungerer, dette gøres med følgende kommando, ligeledes fra projektroden:

mvn clean install -DskipTests=true

I application.properties-filen i projektet er datasources som default sat til at anvende root-user med tomt password. Database-strukturen bliver automatisk oprettet vha. Flyway SQL-scripter, når unit-testene afvikles.

Datasourcen i testafviklingen auto-konfigureres vha. Spring Boot som anvender database-credentials fra ltr-btr-service/src/test/resources/application.properties.

Afvikling af unit-tests

Projektet bygges og 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 testinstall

Der genereres desuden en testrapport.

...

• En Subversion-klient

• Java 8

• MavenMariaDB

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

...

1. Klon projektet fra SVN

2. Opret database via førnævnte SQL-script

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

Bygge WAR filer (Docker)

Et alternativ måde at bygge war filerne på, hvor kan man bl.a. bruger Docker-compose setup.

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

• En Subversion-klient

• Java 8

• Maven

• Docker

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

1. Klon projektet fra SVN
   • svn co https://svn.nspop.dk/svn/components/btr/trunk/
2. Byg projektet
   • mvn clean install

Deployment med Docker

Når man udvikler kan det være praktisk at deploye applikationen lokalt. Dette kan gøres vha. Docker Compose-filen under compose/development/docker-compose.yml.

...