Uvod u CLI Spring Boot

1. Uvod

Spring Boot CLI je apstrakcija naredbenog retka koja nam omogućuje lako pokretanje proljetnih mikro usluga izraženih kao Groovy skripte. Također pruža pojednostavljeno i poboljšano upravljanje ovisnošću za te usluge.

Ovaj kratki članak donosi brzi pregled kako konfigurirati CLI Spring Boot i izvršiti jednostavne naredbe terminala za pokretanje unaprijed konfiguriranih mikro-usluga.

Za ovaj ćemo članak upotrijebiti Spring Boot CLI 2.0.0.RELEASE. Najnoviju verziju Spring Boot CLI možete pronaći na Maven Central.

2. Postavljanje CLI proljetnog pokretanja

Jedan od najjednostavnijih načina postavljanja Spring Boot CLI-a je korištenje SDKMAN-a. Upute za postavljanje i instalaciju SDKMAN-a možete pronaći ovdje.

Nakon instalacije SDKMAN-a, pokrenite sljedeću naredbu da biste automatski instalirali i konfigurirali CLI Spring Boot:

$ sdk instalirati springboot

Da biste provjerili instalaciju, pokrenite naredbu:

$ proljeće --verzija

Spring Boot CLI također možemo instalirati kompajliranjem iz izvora, a korisnici Maca mogu koristiti unaprijed izgrađene pakete iz Homebrew ili MacPorts. Pogledajte službene dokumente za sve mogućnosti instalacije.

3. Uobičajene naredbe terminala

Spring Boot CLI pruža nekoliko korisnih naredbi i značajki koje su dostupne odmah. Jedna od najkorisnijih značajki je Spring Shell koja obavija naredbe s potrebnim Proljeće prefiks.

Do pokrenite ugrađenu ljusku, trčimo:

proljetna ljuska

Odavde možemo izravno unijeti željene naredbe bez prethodnog čekanja Proljeće ključna riječ (jer smo sada u proljetnoj ljusci).

Na primjer, možemo prikaz trenutne verzije tekućeg CLI-a upisivanjem:

verzija

Jedna od najvažnijih naredbi je reći Spring Boot CLI-u da pokrene Groovy skriptu:

pokrenite [SCRIPT_NAME] .groovy

CLI Spring Boot ili će automatski zaključiti ovisnosti ili će to učiniti s obzirom na ispravno isporučene napomene. Nakon toga pokrenut će ugrađeni web spremnik i aplikaciju.

Pogledajmo bliže kako koristiti Groovy skriptu s Spring Boot CLI!

4. Osnovne Groovyjeve skripte

Groovy i Spring dolaze zajedno s Spring Boot CLI na omogućuju brzo skriptiranje moćnih, učinkovitih mikro usluga u Groovyjevim implementacijama s jednom datotekom.

Podrška za višestruko skriptirane programe obično zahtijeva dodatne alate za izgradnju poput Maven ili Gradle.

U nastavku ćemo pokriti neke od najčešćih slučajeva upotrebe za Spring Boot CLI, rezervirajući složenije postavke za ostale članke.

Popis svih napomena Groovyja podržanih za proljeće potražite u službenim dokumentima.

4.1. @ Grab

The @ Grab anotacija i Groovyjeva Java-esque uvoz klauzule dopuštaju lako upravljanje ovisnostima i ubrizgavanje.

U stvari, većina bilješki apstrahira, pojednostavljuje i automatski uključuje potrebne izjave o uvozu. To nam omogućuje da provedemo više vremena razmišljajući o arhitekturi i temeljnoj logici usluga koje želimo implementirati.

Pogledajmo kako koristiti @ Grab napomena:

paket org.test @Grab ("spring-boot-starter-actuator") @RestController klasa ExampleRestController {// ...}

Kao što vidimo, pokretač pokretača opruge-čizme dolazi unaprijed konfiguriran omogućavajući sažetu skriptu bez potrebe za prilagođenom aplikacijom ili svojstvima okoliša, XMLili druga programska konfiguracija, iako se svaka od tih stvari može navesti kada je to potrebno.

Cjelovit popis @ Grab Argumenti - svaki koji navodi biblioteku za preuzimanje i uvoz - dostupni su ovdje.

4.2. @Controller, @RestController, i @EnableWebMvc

Da bismo dalje ubrzali raspoređivanje, možemo i alternativno koristite Spring Boot CLI-jeve "savjete za hvatanje" za automatsko zaključivanje ispravnih ovisnosti za uvoz.

U nastavku ćemo razmotriti neke od najčešćih slučajeva upotrebe.

Na primjer, možemo se poslužiti poznatim @Controller i @Servis bilješke na brzo skelirajte standardni MVC kontroler i uslugu:

Primjer klase @RestController {@Autowired private MyService myService; @GetMapping ("/") javni niz helloWorld () {return myService.sayWorld (); }} @Service klasa MyService {javni niz sayWorld () {return "Svijet!"; }}

Spring Boot CLI podržava sve zadane konfiguracije za Spring Boot. Dakle, možemo da naše Groovy aplikacije automatski pristupe statičkim resursima sa svojih uobičajenih zadanih lokacija.

4.3. @EnableWebSecurity

Do dodajte opciju Spring Boot Security u našu aplikaciju, možemo koristiti @EnableWebSecurity napomena koju će automatski preuzeti Spring Boot CLI.

U nastavku ćemo sažeti dio ovog postupka pomoću spring-boot-starter-sigurnost ovisnost, koja koristi @EnableWebSecurity napomena ispod haube:

paket bael.security @Grab ("spring-boot-starter-security") @RestController klasa SampleController {@RequestMapping ("/") javni def primjer () {[poruka: "Pozdrav svijetu!"]}} 

Za više detalja o tome kako zaštititi resurse i postupati sa sigurnošću, pogledajte službenu dokumentaciju.

4.4. @Test

Do postaviti jednostavan test JUnit, možemo dodati @Grab ('junit') ili @Test napomene:

paket bael.test @Grab ('junit') klasa Test {// ...}

To će nam omogućiti lako izvršavanje JUnit testova.

4.5. Izvor podataka i JdbcTemplate

Mogu se navesti trajne mogućnosti podataka, uključujući Izvor podataka ili JdbcTemplate bez izričitog korištenja @ Grab bilješka:

paket bael.data @Grab ('h2') @Configuration @EnableWebMvc @ComponentScan ('bael.data') klasa DataConfig {@Bean DataSource dataSource () {return new EmbeddedDatabaseBuilder () .setType (EmbeddedDatabaseType. ; }}

Jednostavnim korištenjem poznatih konvencija o konfiguraciji Spring bean-a, zgrabili smo ugrađenu bazu podataka H2 i postavili je kao Izvor podataka.

5. Prilagođena konfiguracija

Postoje dva osnovna načina za konfiguriranje mikro usluge Spring Boot pomoću CLI Spring Boot:

  1. možemo dodati parametre argumenta našim naredbama terminala
  2. možemo koristiti prilagođenu YAML datoteku za pružanje konfiguracije aplikacije

Spring Boot će automatski pretraživati / config imenik za primjena.iml ili primjena.svojstva

├── aplikacija ├── app.groovy ├── konfiguracija ├── application.yml ... 

Također možemo postaviti:

├── aplikacija ├── primjer.groovy ├── primjer.iml ...

Cjelovit popis svojstava aplikacije možete pronaći ovdje na Springu.

6. Zaključak

Ovim je završen naš brzi prolazak kroz Spring Boot CLI! Za više pojedinosti pogledajte službene dokumente.

Kao i obično, izvorni kod za ovaj članak može se naći na GitHubu.