Page History
...
- odr-parent
skr-schemas
JAX-WS-artifakt generator genererer Java-klasser ud fra projektets WSDL-filer.skr-service
Selve servicens funktionalitet.skr-test
Integrationstests.- skr-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.
Ændringslog
Version | Dato | Ændring | Ansvarlig |
---|---|---|---|
1.0.0 | 2018-09-11 | Initialt dokument | Trifork |
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 skr-service/src/test/resources/db. Derefter kan Flyway automatisk initialisere databasenoprette de nødvendige database-schemas vha. scriptet compose/database/db/create_db.sql. 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 skrltr-btr-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:
...
Der er behov for adgange til følgende systemer:
- NSP SVN-repository for ODR: https://svn.nspop.dk/svn/trifork/skr/
- Dependencies trækkes fra NSP's Nexus-repository: https://nexus.nspop.dk
Opsætning af udviklingsmiljø
Al kode findes i NSP SVN: https://svn.nspop.dk/svn/trifork/skr/
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 3 maven-moduler:
...
Bygge WAR filer
Følgende software er nødvendigt for at bygge projektet
...
Installér og start MariaDB
Klon projektet fra SVN: https://svn.nspop.dk/svn/trifork/skr/
Opret database via script i skr-service/src/test/resources/dbførnævnte SQL-script
For at bygge projektet, foretage unittests samt at bygge war-filer foretages kommandoen: mvn clean install
...
Man åbner blot pom.xml fra rodbiblioteket. Efter en mvn clean install bør dependencies være på plads.
...
Deployment med Docker
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 (SKR) for nærmere instrukser.lokalt. Dette kan gøres vha. Docker Compose-filen under compose/development/docker-compose.yml.
docker-compose up -d --build