streamalism.org

1. Úvod

Spring Boot CLI je a abstrakcia príkazového riadku, ktorá nám umožňuje ľahko spúšťať jarné mikroslužby vyjadrené ako Groovy skripty. Poskytuje tiež zjednodušené a vylepšené riadenie závislostí pre tieto služby.

Na tento krátky článok sa pozrieme rýchlo ako nakonfigurovať Spring Boot CLI a vykonávať jednoduché príkazy terminálu na spustenie predkonfigurovaných mikroslužieb.

Pre tento článok použijeme Spring Boot CLI 2.0.0.RELEASE. Najnovšiu verziu rozhrania Spring Boot CLI nájdete na serveri Maven Central.

2. Nastavenie rozhrania Spring Boot CLI

Jedným z najjednoduchších spôsobov nastavenia rozhrania Spring Boot CLI je použitie nástroja SDKMAN. Pokyny na nastavenie a inštaláciu nástroja SDKMAN nájdete tu.

Po inštalácii SDKMAN spustite nasledujúci príkaz na automatickú inštaláciu a konfiguráciu rozhrania Spring Boot CLI:

$ sdk nainštalovať springboot

Inštaláciu overíte spustením príkazu:

$ jar - verzia

Spring Boot CLI môžeme nainštalovať aj kompiláciou zo zdroja a používatelia počítačov Mac môžu používať vopred pripravené balíčky z Homebrew alebo MacPorts. Všetky možnosti inštalácie nájdete v oficiálnych dokumentoch.

3. Bežné príkazy terminálu

Rozhranie Spring Boot CLI poskytuje niekoľko užitočných príkazov a funkcií, ktoré sú pripravené na použitie. Jednou z najužitočnejších funkcií je Spring Shell, ktorá obsahuje potrebné príkazy jar predpona.

To spustite vložený shell, bežíme:

pružinová škrupina

Odtiaľto môžeme priamo zadávať požadované príkazy bez predbežného čakania na jar kľúčové slovo (keďže sme teraz v jarnom prostredí).

Napríklad môžeme zobraziť aktuálnu verziu spusteného CLI zadaním:

verzia

Jedným z najdôležitejších príkazov je povedať Spring Boot CLI, aby spustil Groovy skript:

spustiť [SCRIPT_NAME] .grovy

Spring Boot CLI buď automaticky odvodí závislosti, alebo to urobí na základe správne dodaných anotácií. Potom spustí integrovaný webový kontajner a aplikáciu.

Poďme sa bližšie pozrieť na to, ako používať Groovy skript s Spring Boot CLI!

4. Základné groovy skripty

Groovy a Spring prichádzajú spolu s Spring Boot CLI do umožňujú rýchle skriptovanie výkonných a výkonných mikroslužieb v nasadeniach Groovy s jedným súborom.

Podpora viacnásobne skriptovaných aplikácií zvyčajne vyžaduje ďalšie nástroje na zostavenie, ako sú Maven alebo Gradle.

Ďalej sa budeme venovať niektorým z najbežnejších prípadov použitia rozhrania Spring Boot CLI a rezervovať zložitejšie nastavenia pre ďalšie články.

Zoznam všetkých jarných anotácií Groovy nájdete v oficiálnych dokumentoch.

4.1. @Uchmatnúť

The @Uchmatnúť anotácia a Groovyov jazyk Java dovoz doložky umožňujú jednoduchá správa a vkladanie závislostí.

Väčšina anotácií v skutočnosti abstrahuje, zjednodušuje a automaticky obsahuje potrebné dovozné príkazy. To nám umožňuje tráviť viac času premýšľaním o architektúre a základnej logike služieb, ktoré chceme nasadiť.

Poďme sa pozrieť na to, ako používať @Uchmatnúť anotácia:

balíček org.test @Grab ("spring-boot-startér-aktuátor") @RestController trieda ExampleRestController {// ...}

Ako vidíme, aktivátor pružiny-štartéra-štartéra je predkonfigurovaný tak, aby umožňoval stručné nasadenie skriptov bez potreby prispôsobenej aplikácie alebo vlastností prostredia, XMLalebo iná programová konfigurácia, aj keď každú z týchto vecí je možné v prípade potreby špecifikovať.

Celý zoznam @Uchmatnúť argumenty - každá špecifikujúca knižnicu na stiahnutie a import - je k dispozícii tu.

4.2. @Controller, @RestController, a @EnableWebMvc

Pre ďalšie urýchlenie nasadenia môžeme alternatívne využívať Spring Boot CLI poskytované „tipy“ na automatické odvodenie správnych závislostí pri importe.

Ďalej si prejdeme niektoré z najbežnejších prípadov použitia.

Napríklad môžeme použiť známe @ Kontrolór a @Služba anotácie k rýchlo vygenerovať štandardný radič MVC a služby:

@RestController - trieda Príklad {@Autowired private MyService myService; @GetMapping ("/") public String helloWorld () {return myService.sayWorld (); }} @Service class MyService {public String sayWorld () {return "World!"; }}

Spring Boot CLI podporuje všetku predvolenú konfiguráciu pre Spring Boot. Takže môžeme, aby naše aplikácie Groovy automaticky pristupovali k statickým zdrojom z ich obvyklých predvolených umiestnení.

4.3. @EnableWebSecurity

To pridajte do našej aplikácie možnosti Spring Boot Security, môžeme použiť @EnableWebSecurity anotáciu, ktorá sa potom automaticky stiahne pomocou rozhrania Spring Boot CLI.

Ďalej budeme abstraktovať časť tohto procesu pomocou zabezpečenie jarného štartéra-štartéra závislosť, ktorá využíva @EnableWebSecurity anotácia pod kapotou:

balíček bael.security @Grab ("spring-boot-starter-security") @RestController trieda SampleController {@RequestMapping ("/") verejný príklad def () {[správa: "Hello World!"]}} 

Ďalšie informácie o tom, ako chrániť zdroje a zaobchádzať so zabezpečením, nájdete v oficiálnej dokumentácii.

4.4. @Test

To nastaviť jednoduchý test JUnit, môžeme pridať @Grab („junit“) alebo @Test anotácie:

balíček test triedy bael.test @Grab ('junit') {// ...}

Toto nám umožní ľahké vykonávanie testov JUnit.

4.5. Dátový zdroj a JdbcTemplate

Trvalé možnosti údajov je možné určiť vrátane Dátový zdroj alebo JdbcTemplate bez výslovného použitia @Uchmatnúť anotácia:

balíček bael.data @Grab ('h2') @Configuration @EnableWebMvc @ComponentScan ('bael.data') trieda DataConfig {@Bean DataSource dataSource () {vrátiť nový EmbeddedDatabaseBuilder () .setType (EmbeddedDatabaseType.H2) .build) ; }}

Jednoduchým použitím známych konvencií konfigurácie jarných bôbov, chytili sme vloženú databázu H2 a nastavili ju ako Dátový zdroj.

5. Vlastná konfigurácia

Existujú dva primárne spôsoby konfigurácie mikroslužby Spring Boot pomocou rozhrania Spring Boot CLI:

1. môžeme do našich príkazov terminálu pridať parametre argumentov
2. môžeme použiť prispôsobený súbor YAML na poskytnutie konfigurácie aplikácie

Spring Boot automaticky prehľadá / konfigur adresár pre aplikácia.yml alebo application.properties

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

Môžeme tiež nastaviť:

├── aplikácia ├── example.groovy ├── example.yml ...

Celý zoznam vlastností aplikácie nájdete tu na jar.

6. Záver

Týmto je ukončený náš rýchly prechod na Spring Boot CLI! Ďalšie informácie nájdete v oficiálnych dokumentoch.

A ako obvykle, zdrojový kód tohto článku nájdete na GitHub.