Initial uppsättning av utvecklingsmiljön
Sätt upp utvecklingsmiljö enligt följande: Generella instruktioner för utvecklare.
När detta är gjort kan man hämta ut källkoden för tjänsteadresseringskatalogen på https://github.com/skltp/tak
$ git clone https://github.com/skltp/tak.git Cloning into 'tak'... $ cd tak
Källkoden för TAK har följande struktur med undermoduler:
- tak-parent
- tak-core - gemensamma klasser
- tak-schemas - kodgenerering från tjänstekontrakt
- tak-services - web services (SOAP och REST)
- tak-web - webbgränssnitt för administration
- report - hjälpmodul för att skapa JaCoCo kodtäckningsrapport
Kontrollera att Maven använder Java 8 (mvn -v), det fungerar inte att bygga med nyare versioner.
Öppna därefter ett kommandofönster för att bygga och testa källkoden med hjälp av Maven:
mvn clean install
Installation av MySQL och Tomcat
Dessa komponenter krävs inte alltid men kan vara bra att ha på plats för att kunna köra i mer produktionslik miljö.
När man kör i en lokal Tomcat måste konfiguration (för exempelvis databas) finns på liknande sätt som i en vanlig driftmiljö. Enklast är att sätta miljövariabeln TAK_HOME till en sökväg <repo>/resources/etc och modifiera filen tak-application.properties efter behov. Se SKLTP TAK - Konfiguration - version 3.0 och senare för detaljer.
Modul tak-web
Modulen tak-web är byggd med Spring Boot och Spring MVC. Det kan startas i utvecklarläge (med profilen dev) med följande kommando. Den kommer då starta upp med en H2 in-memory-databas och exponera webbgränssnittet på port 8080.
cd tak-web mvn spring-boot:run
Modul tak-services
Modulen tak-services kräver att Tomcat eller motsvarande applikationsserver är installerad för att köra.
Commit och Release
För att committa källkod på GitHub följer vi standardproceduren beskriven på: Generella instruktioner för utvecklare.
För att bygga en release följer vi standardproceduren beskriven på: Generella instruktioner för utvecklare.