Bevezetés a Spring Boot CLI-be

1. Bemutatkozás

A Spring Boot CLI a parancssori absztrakció, amely lehetővé teszi számunkra, hogy a Groovy-szkriptek formájában kifejezett Spring szolgáltatásokat futtassuk. Ezenkívül egyszerűsített és továbbfejlesztett függőségkezelést biztosít ezen szolgáltatások számára.

Ez a rövid cikk gyorsan áttekinti hogyan konfigurálhatjuk a Spring Boot CLI-t, és hogyan hajthatunk végre egyszerű terminálparancsokat az előre konfigurált mikraszolgáltatások futtatásához.

A Spring Boot CLI 2.0.0 verziót fogjuk használni. A Spring Boot CLI legújabb verziója megtalálható a Maven Central oldalán.

2. A tavaszi csomagtartó CLI beállítása

A Spring Boot CLI beállításának egyik legegyszerűbb módja az SDKMAN használata. Az SDKMAN telepítési és telepítési útmutatói itt találhatók.

Az SDKMAN telepítése után futtassa a következő parancsot a Spring Boot CLI automatikus telepítéséhez és konfigurálásához:

$ sdk telepítse a springboot programot

A telepítés ellenőrzéséhez futtassa a következő parancsot:

$ tavasz - verzió

Telepíthetjük a Spring Boot CLI-t is forrásból történő fordítással, és a Mac-felhasználók használhatják a Homebrew vagy a MacPorts előre elkészített csomagjait. Az összes telepítési opciót lásd a hivatalos dokumentációban.

3. Közös terminálparancsok

A Spring Boot CLI számos hasznos parancsot és funkciót kínál a dobozból. Az egyik leghasznosabb szolgáltatás a Spring Shell, amely a szükséges parancsokkal burkolja a parancsokat tavaszi előtag.

Nak nek indítsa el a beágyazott héjat, futunk:

rugós héj

Innen közvetlenül beírhatjuk a kívánt parancsokat anélkül, hogy előre várnánk a tavaszi kulcsszó (mivel most tavaszi héjban vagyunk).

Például megtehetjük az aktuális verzió megjelenítése írja be a futó CLI-t:

változat

Az egyik legfontosabb parancs azt mondja a Spring Boot CLI-nek, hogy futtasson egy Groovy parancsfájlt:

futtassa a [SCRIPT_NAME] .groovy alkalmazást

A Spring Boot CLI vagy automatikusan kikövetkezteti a függőségeket, vagy a helyesen megadott kommentárokkal meg fogja tenni. Ezt követően elindít egy beágyazott webes tárolót és alkalmazást.

Vizsgáljuk meg közelebbről, hogyan kell használni a Groovy szkriptet a Spring Boot CLI-vel!

4. Alapvető Groovy szkriptek

Groovy és Spring együtt jönnek a Spring Boot CLI-vel lehetővé teszik az erőteljes, teljesítő mikrohullámú szolgáltatások gyors szkriptelését az egyfájlú Groovy-telepítésekben.

A többszörösen szkriptelt alkalmazások támogatásához általában további építőeszközökre van szükség, például a Maven vagy a Gradle.

Az alábbiakban bemutatjuk a Spring Boot CLI leggyakoribb használati eseteit, összetettebb beállításokat fenntartva más cikkek számára.

Az összes tavasszal támogatott Groovy-kommentár felsorolásához kérjük, olvassa el a hivatalos dokumentumokat.

4.1. @Megragad

A @Megragad annotáció és Groovy Java-esque-je import záradékok lehetővé teszik egyszerű függőségkezelés és injekció.

Valójában a legtöbb kommentár elvonatkoztatja, leegyszerűsíti és automatikusan tartalmazza a szükséges importálási utasításokat. Ez lehetővé teszi számunkra, hogy több időt fordítsunk az építészetre és a telepíteni kívánt szolgáltatások mögöttes logikájára.

Vessünk egy pillantást a @Megragad kommentár:

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

Ahogy látjuk, rugós-csomagtartó-indító-működtető előre konfigurálva van, amely lehetővé teszi a szkriptek tömör telepítését anélkül, hogy szükség lenne testreszabott alkalmazásra vagy környezeti tulajdonságokra, XML, vagy más programozási konfiguráció, bár ezek a dolgok szükség esetén megadhatók.

A teljes lista @Megragad Az argumentumok - mindegyik megad egy könyvtárat a letöltéshez és importáláshoz - itt érhetők el.

4.2. @Controller, @RestController, és @EnableWebMvc

A telepítés további felgyorsítása érdekében alternatív módon is megtehetjük felhasználhatja a Spring Boot CLI által biztosított „megragadási tippeket”, hogy automatikusan következtethessen az importálandó helyes függőségekre.

Az alábbiakban áttekintjük a leggyakoribb használati eseteket.

Például használhatjuk a megszokottat @Vezérlő és @Szolgáltatás annotációk a gyorsan állványoz egy szabványos MVC vezérlőt és szolgáltatást:

@RestController osztály példa {@Autowired private MyService myService; @GetMapping ("/") public String helloWorld () {return myService.sayWorld (); }} @Service osztály MyService {public String sayWorld () {return "Világ!"; }}

A Spring Boot CLI támogatja a Spring Boot összes alapértelmezett konfigurációját. Tehát megtehetjük, hogy a Groovy alkalmazásunk automatikusan hozzáfér a statikus erőforrásokhoz a szokásos alapértelmezett helyükről.

4.3. @EnableWebSecurity

Nak nek adja hozzá a Spring Boot Security opciókat az alkalmazásunkhoz, használhatjuk a @EnableWebSecurity kommentár, amelyet azután a Spring Boot CLI automatikusan letölt.

Az alábbiakban ennek a folyamatnak egy részét fogjuk elvonatkoztatni a spring-boot-starter-security függőség, amely kihasználja a @EnableWebSecurity felirat a motorháztető alatt:

csomag bael.security @Grab ("spring-boot-starter-security") @RestController osztály SampleController {@RequestMapping ("/") public def example () {[message: "Hello World!"]}} 

Az erőforrások védelmével és a biztonság kezelésével kapcsolatos további információkért kérjük, olvassa el a hivatalos dokumentációt.

4.4. @Teszt

Nak nek állítson be egy egyszerű JUnit tesztet, hozzáadhatjuk a @Grab (‘junit’) vagy @Teszt kommentárok:

csomag bael.test @Grab ('junit') osztály teszt {// ...}

Ez lehetővé teszi számunkra a JUnit tesztek egyszerű végrehajtását.

4.5. Adatforrás és JdbcTemplate

Állandó adatopciók adhatók meg, beleértve a Adatforrás vagy JdbcTemplate anélkül, hogy kifejezetten a @Megragad annotáció:

csomag bael.data @Grab ('h2') @Configuration @EnableWebMvc @ComponentScan ('bael.data') osztály DataConfig {@Bean DataSource dataSource () {return new EmbeddedDatabaseBuilder () .setType (EmbeddedDatabaseType.H2. ; }}

A megszokott tavaszi babkonfigurációs konvenciók egyszerű használatával, megfogtuk a H2 beágyazott adatbázist és beállítottuk Adatforrás.

5. Egyéni konfiguráció

Két fő módja van a Spring Boot mikraszolgáltatás konfigurálásának a Spring Boot CLI használatával:

  1. argumentumparamétereket adhatunk a terminálparancsainkhoz
  2. testreszabott YAML fájlt használhatunk az alkalmazás konfigurálásához

A Spring Boot automatikusan megkeresi a / config könyvtár a alkalmazás.yml vagy alkalmazás.tulajdonságok

├── app ├── app.groovy ├── config ├── application.yml ... 

Beállíthatjuk:

├── app ├── example.groovy ├── example.yml ...

Az alkalmazás tulajdonságainak teljes listája itt található a Spring oldalon.

6. Következtetés

Ezzel befejezzük a Spring Boot CLI gyors áttekintését! További részletekért nézze meg a hivatalos dokumentumokat.

És mint általában, a cikk forráskódja megtalálható a GitHubon.