Page History
...
FSK Registry er en Java baseret komponent, der baserer sig på Java 7 8 og Spring frameworket. Der anvendes Spring Boot som konfiguration og konventionsværktøj omkring Spring Frameworket.
...
I det følgende antages at koden er hentet ned fra SVN: https://svn.nspop.dk/svn/kvalitetsitcomponents/fskregistry/
Krav til software
Krav til applikationsserveren og operativsystemet er de samme som til produktionsmiljøet. De specifikke krav kan ses i FSK Registry Adapter - Installationsvejledning
Derudover er der en række krav til de anvendte udviklingsværktøjer:
Maven 3.0.3 eller højere anvendes.
Docker 18.09.6 eller højere anvendes.
Docker Compose 1.23.2 eller højere anvendes.
Bygge WAR filen
Man skal bruge Apache Maven til at bygge FSK Registry, hvilket gøres ved at køre kommandoen
$ mvn clean
| Code Block | ||
|---|---|---|
| ||
mvn clean install |
Efter by byg kan den installerbare WAR fil findes her:
/fskregistry-war/target/fskregistry.war
Deployment på Wildfly
Der henvises til installationsvejledningen FSK Registry Adapter - Installationsvejledning for nærmere instrukser.
...
Når man udvikler kan det være praktisk at foretage deploy til en lokal Wildfly.lokal applikationsserver.
Da vi bruger docker og docker-compose, så gøre dette ved at kalde:
| Code Block | ||
|---|---|---|
| ||
docker-compose -f compose/development/docker-compose.yml up --build |
Beskrivelse af systemdesign
...
Beskrivelse af kildekodens strukturering og design
Kode strukturering
Kildekoden bygges vha Apache Maven, og kildekoden er struktureret som Maven moduler, som vist
nedenfor.
...
Kodestrukturering
Folderen "compose" indeholder alle filer som skal bruges til at starte FSK Registry vha. docker-compose. Eneste undtagelser er fskregistry-war/Dockerfile og fskregistry-war/target/fskregistry.war
fskregistry-qa modulet indeholder en code coverage rapport.
fskregistry-xds modulet indeholder koden til selve ITI-18 servicen.
...
fskregistry-war står for selve pakketeringen som WAR fil. Herunder JBoss specifikke deployment descriptor samt eksempel konfiguration (WildFly Modul).
Beskrivelse af testsetup
Unittests Unit tests (JUnit)
JUnit anvendes til implementering af unit tests. Der er kontinuert gennemført unit tests på alle komponenter i projektet.
Unit tests kan afvikles ved at køre:
| Code Block | ||
|---|---|---|
| ||
mvn test |
Integrationstests
Integrationstests kan afvikles ved at køre:
| Code Block | ||
|---|---|---|
| ||
mvn test -Pintegration-tests -Dintegrationtestpropdir=src/test/integrationstest-localhost |
Bemærk at dette forudsætter, at FSK Registry er deployeret på JBoss-serverenstartet op via "docker compose", da integrationstestene afvikles imod kørende service(s).