Page History
...
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:
- odrskr-parent
skr-schemas
JAX-WS-artifakt generator genererer Java-klasser ud fra projektets WSDL-filer.skr-service
Selve servicens funktionalitet.skr-test
skr-test-data-creatorDatageneratorkomponent til brug ifm. performancetesting.
Integrationstests.
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
Version | Dato | Ændring | Ansvarlig |
---|---|---|---|
1.0.0 | 2018-09-11 | Initialt dokument | Trifork |
1.0.12 | 2019-25-09 | Ajourført | Trifork |
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:
...
Bemærk: Det kan tage op mod et minut før containeren er klar. De nødvendige databaser bliver oprettet automatisk.
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-scripteri en in-memory H2 database, 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.
.
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.
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 skr-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 skr-service/src/test/resources/db/migration.
XSD-vedligehold
XSDerne der eksporteres og benyttes i servicen ligger i modulet skr-schema. Der genereres JAXB-klasser som defineret i modulets pom.xml
...
En Subversion-klient
Java 8
Maven
MariaDB
Gennemfør følgende steps for at bygge WAR filer:
...
Klon projektet fra SVNOpret database via førnævnte SQL-script
For at bygge projektet, foretage unittests samt at bygge war-filer foretages kommandoen: mvn clean install
...