Build | Code quality check |
---|---|
Jednoduchý úvod do Spring boot s použitím Gradlu a Java 11
Projekt je rozdelený na kroky, pričom každý krok je už výsledná aplikácia
Inštalácia open jdk 11 z https://jdk.java.net/11 do adresára (c:/Program Files/Java Na zapisovanie do adresára "Program Files" sú nutné admin práva)
Clone repository
V hlavnom adresáry v súbore gradle.properties je nutné zadať cestu k jave
org.gradle.java.home=c:/Program Files/Java/jdk-11.0.2
Keďže v hlavnom adresári je gradle (a v settings.gradle je include subprojektov), tak každý podadresár dedí všetky gradle nastavenia. V každom kroku je len vlastný súbor build.gradle ktorý špecifikuje, aké časti spring frameworku sa budu využívať.
Celý projekt sa dá skompilovať z príkazového riadku pomocou gradlew build
(skompiluje celý projekt s spustí všetky testy)
Jednotlivé projekty sa dajú spustiť pomocou gradlew bootRun
. Spustiť program má zmysel len pre Step3 ktorý spustí lokálny Tomcat (embedded) server a čaká na REST Requesty. Step1 a Step2 sa po spustení hneď ukončia.
Pre projekt [Step 2 - JPA] je potrebné nainštalovať Databázu mariadb. V Databáze treba zadať heslo 'root' pre užívateľa 'root' (meno a heslo do databázy sa v springboot zadávajú v resource súbore application.yml)
Pre projekt [Step 3 - REST] je potrebné nainštalovať aplikáciu postman na posielanie REST Requestov
Jedná sa o projekt, ktorý bude demonštrovať spring-boot na jednoduchej aplikácii.
Aplikácia by mala mať na starosti spravovanie koľají (naozaj železničných koľají :-) ). Jednotlivé kroky na seba nadväzujú
- Step 1 - Dependency injection Dve Komponenty TrackCalculator a TrackRepository demonštrujú použitie anotácie
@Component
a ako sa dá izolovane otestovať jedna Komponente pomocou@MockBean
- Step 2 - JPA Komponenta TrackRepository bude zapisovať do Databázy pomocou JPA
- Step 3 - REST Nová komponenta TrackRepositoryController bude sprístupňovať REST Api a použiva TrackRepository. Na testovanie REST Api použijeme postman (treba do postmana naimportovať súbor z adresára postman kde sú už pripravené REST Requesty )
Každá koľaj je jednoznačne identifikovateľná pomocou dvoch číselných (integer) parametrov.
TrackId
Typ | Meno Premennej | Význam |
---|---|---|
short | nid_c | Verzia projektovania. Pri každej zmene (napr. dĺžky koľaje sa musí zmeniť aj táto verzia) |
integer | nid_sp | Číselná identifikácia koľaje |
Gradle preberá frameworky z maven repository čo je centrálne web úložisko. Napr. spring-boot verzia 2.1.3 Release je https://mvnrepository.com/artifact/org.springframework.boot/spring-boot/2.1.3.RELEASE Samotný spring-boot referencuje ďaľších 53 Projektov (napr. logger, junit, springframework...)