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:
- argumentumparamétereket adhatunk a terminálparancsainkhoz
- 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.