Stručný sprievodca po Spring Roo

1. Prehľad

Spring Roo je nástroj pre rýchly vývoj aplikácií (RAD), ktorého cieľom je prinášať rýchle a okamžité výsledky zamerané na jarné webové aplikácie a novšie jarné technológie. Umožňuje nám generovať štandardný kód a štruktúru projektu pre jarné aplikácie pomocou ľahko použiteľných príkazov.

Roo možno použiť ako samostatnú aplikáciu spustenú z príkazového riadku operačného systému. Nie je potrebné používať Eclipse, Spring Tool Suite (STS) alebo iné IDE; na napísanie kódu môžeme v skutočnosti použiť akýkoľvek textový editor!

Pre jednoduchosť však použijeme STS IDE s Roo Extension.

2. Inštalácia Spring Roo

2.1. Požiadavky

Ak chcete postupovať podľa tohto návodu, je potrebné nainštalovať tieto:

  1. Java JDK 8
  2. STS
  3. Jarné roo

2.2. Inštalácia

Po stiahnutí a inštalácii Java JDK a STS musíme Spring Roo rozbaliť a pridať do systémovej cesty.

Vytvorme ROO_HOME premenná prostredia a pridať % ROO_HOME% \ bin na cestu.

Aby sme overili, či je Roo nainštalovaný správne, môžeme otvoriť príkazový riadok a vykonať nasledujúce príkazy:

mkdir baeldung cd baeldung roo ukončiť

Po niekoľkých sekundách uvidíme:

 _ ___ _ __ _ __ (_) _ __ __ _ _ __ ___ ___ / __ | „_ \ | „__ | | „_ \ / _` | | „__ / _ \ / _ \ \ __ \ | _) | | | | | | | (_ | | | | | (_) | (_) | | ___ / .__ / | _ | | _ | _ | | _ | \ __, | | _ | \ ___ / \ ___ / | _ | | ___ / 2.0.0.RC1 Vitajte v Spring Roo. Pomoc získate stlačením klávesu TAB alebo zadaním výrazu „hint“ a následným stlačením klávesu ENTER.

Roo je nainštalovaný a funguje. Upozorňujeme, že verzia Spring Roo sa bude líšiť a kroky a pokyny môžu závisieť od použitej skutočnej verzie.

Dôležité: Spring Roo 2.0 nie je spätne kompatibilný s 1.x.

2.3. Pridanie a konfigurácia rozšírenia STS

STS ihneď po vybalení podporuje vývoj jarných aplikácií a obsahuje rozšírenia pripravené na použitie. Rozšírenie Spring Roo však nie je súčasťou dodávky. Preto ho budeme musieť pridať manuálne.

V STS poďme na Nainštalujte nový softvér a importovať záložky do Dostupné softvérové ​​stránky. Momentálne sú záložky v priečinku % ROO_HOME% \ conf priečinok. Po importovaní záložiek môžeme hľadať jednoducho roo a nainštalujte si najnovšiu verziu Jarná podpora IDE Roo. Nakoniec budeme požiadaní o reštartovanie STS.

Podrobné a aktuálne kroky môžeme kedykoľvek skontrolovať a skontrolovať dokumentáciu Začíname pracovať na jar.

Po nainštalovaní podpory Roo v STS musíme nastaviť rozšírenie. Je to také ľahké ako nasmerovať podporu Roo na % ROO_HOME% priečinok. Spring Roo Getting Started opäť poskytuje podrobné kroky, ako na to.

Teraz môžeme ísť do ponuky aplikácie „Okno“ ešte raz a vybrať Zobraziť Zobraziť> Roo Shell.

3. Prvý projekt

3.1. Príprava projektu v STS

V STS otvorme Roo škrupina okno a kliknite na Vytvorte nový projekt Roo ikona. Týmto sa otvorí a Nový projekt Roo okno.

Pomenujeme projekt roo a použitie com.baeldung ako náš názov balíka najvyššej úrovne. Všetky ostatné predvolené hodnoty môžeme nechať a pokračovať až do konca, aby sme pomocou Roo vytvorili nový projekt.

V STS to pre nás spustí nasledujúci príkaz:

nastavenie projektu --topLevelPackage com.baeldung --projectName "roo" --java 8 --balenie JAR

Ako už bolo spomenuté, IDE nepotrebujeme a tento príkaz sme mohli spustiť sami od Roo Shell! Pre jednoduchosť používame zabudované funkcie STS.

Ak sa zobrazí nasledujúca chyba:

Nepodarilo sa vypočítať plán zostavenia: Plugin org.codehaus.mojo: aspectj-maven-plugin: 1.8 alebo jednu z jeho závislostí nebolo možné vyriešiť: Nepodarilo sa načítať deskriptor artefaktu pre org.codehaus.mojo: aspectj-maven-plugin: jar: 1.8

najjednoduchší spôsob, ako to opraviť, je ručná úprava pom.xml súbor a aktualizácia aspectj.plugin.verzia od 1.8 do 1.9:

1.9

V tejto fáze by v projekte nemali byť žiadne chyby a bude tu pre nás niekoľko automaticky generovaných súborov.

3.2. Roo škrupina

Teraz je čas oboznámiť sa s Roo Shell. Primárnym používateľským rozhraním Spring Roo je v skutočnosti príkazový riadok!

Vráťme sa preto späť do okna Roo Shell. V ňom spustíme prvý príkaz zadaním klávesu „h“ a stlačením klávesov CTRL + SPACE:

roo> h nápoveda

Roo za nás automaticky navrhne a automaticky dokončí príkazy. Môžeme napísať „ahoj“, stlačiť CTRL + SPACE a Roo automaticky navrhne náznak príkaz.

Ďalšou skvelou vlastnosťou Roo Shell je kontextové povedomie. Napríklad výstup súboru náznak príkaz sa zmení v závislosti od predchádzajúceho vstupu.

Poďme teraz vykonať náznak príkaz a uvidíme, čo sa stane:

roo> hint Roo vyžaduje inštaláciu konfigurácie perzistencie. Zadajte príkaz „jpa setup“ a stlačte kombináciu klávesov CTRL + SPACE. Navrhujeme, aby ste napísali „H“, potom CTRL + SPACE, čím dokončíte „HIBERNATE“. Po --provider, stlačte CTRL + SPACE pre výber databázy. Na účely testovania zadajte (alebo CTRL + SPACE) HYPERSONIC_IN_MEMORY. Ak znova stlačte kombináciu klávesov CTRL + SPACE, uvidíte, že už nie sú k dispozícii žiadne ďalšie možnosti. Ako taký ste pripravení stlačiť kláves ENTER na vykonanie príkazu. Po nainštalovaní protokolu JPA zadajte pre ďalší návrh výraz „hint“ a kláves ENTER.

Poskytuje nám ďalšie kroky, ktoré musíme vykonať. Teraz pridajme databázu:

roo> nastavenie jpa --provider HIBERNATE --database HYPERSONIC_IN_MEMORY Vytvorené SRC_MAIN_RESOURCES \ application.properties Aktualizované SRC_MAIN_RESOURCES \ application.properties Aktualizované SRC_MAIN_RESOURCES \ application-dev.properties Aktualizované ROOT \ pom.xml Aktualizované ROOT \ pom.xml Aktualizované ROOT \ pom.xml -starter-data-jpa :, org.springframework.boot: spring-boot-starter-jdbc :, org.hsqldb: hsqldb :; pridaná vlastnosť 'springlets.version' = '1.2.0.RC1'; pridané závislosti io.springlets: springlets-data-jpa: $ {springlets.version}, io.springlets: springlets-data-jpa: $ {springlets.version}; pridané závislosti io.springlets: springlets-data-commons: $ {springlets.version}, io.springlets: springlets-data-commons: $ {springlets.version}]

V tejto fáze budeme musieť vykonať niektoré príkazy. Medzi každým z nich môžeme vždy bežať náznak príkaz, aby ste zistili, čo navrhuje Roo. Toto je veľmi užitočná funkcia.

Najprv spustime príkazy, a potom si nimi prejdeme:

roo> entity jpa --class ~ .domain.Reťazec poľa knihy --fieldfield názov --notNull reťazec poľa --fieldName autor --notNull reťazec poľa --fieldName isbn --notNull úložisko jpa --entity ~ .domain.Book service --všetko nastavenie webu mvc nastavenie webu mvc - typ THYMELEAF webový radič mvc --entity ~ .domain.Book --response typ THYMELEAF

Teraz sme pripravení spustiť našu aplikáciu. Vráťme sa však v príkazoch späť, aby sme videli, čo sme urobili.

Najskôr sme vytvorili novú pretrvávajúcu entitu JPA v src / main / java priečinok. Ďalej sme vytvorili tri String polia v Kniha triedy, dal im meno a nastavil, že nebudú nulový.

Potom sme pre zadanú entitu vytvorili úložisko Spring Data a vytvorili nové rozhranie služby.

Nakoniec sme zahrnuli Spring MVC konfiguráciu, nainštalovali Thymeleaf a vytvorili nový radič, ktorý spravuje našu entitu. Pretože sme ako typ odpovede prešli Thymeleaf, vygenerované metódy a zobrazenia to budú odrážať.

3.3. Spustenie aplikácie

Obnovme projekt a kliknite pravým tlačidlom myši na roo projekt a vyberte Spustiť ako> Aplikácia Spring Boot.

Po spustení aplikácie môžeme otvoriť webový prehliadač a prejsť na // localhost: 8080. Ďalej na ikonu Roo uvidíme Kniha ponuky a pod dvoma možnosťami: Vytvoriť knihu a Zoznam kníh. To môžeme použiť na pridanie knihy do našej aplikácie a na prezeranie zoznamu pridaných kníh.

3.4. Ďalšie funkcie

Keď otvoríme Book.java súbor triedy, všimneme si, že trieda je anotovaná @Roo anotácie. Tieto pridal Roo Shell a používajú sa na kontrolu a prispôsobenie obsahu súborov AspectJ inter-type declaration (ITD). Súbory môžeme zobraziť v Prieskumníku balíkov v STS zrušením výberu filtra „Skryť vygenerované ITD Spring Roo“ v ponuke Zobraziť alebo môžeme súbory otvoriť priamo zo súborového systému.

Roo anotácie majú ZDROJ retenčná politika. To znamená anotácie nebudú prítomné v kompilovanom bajtkóde triedya v nasadených aplikáciách nebude závislosť od Roo.

Ďalšia, zjavne chýbajúca časť v Book.java triedy sú getry a stavače. Ako už bolo spomenuté, sú uložené v samostatných súboroch AspectJ ITD. Spoločnosť Roo bude tento štandardný kód pre nás aktívne udržiavať. Preto sa zmeny polí v ktorejkoľvek triede automaticky prejavia v ITD AspectJ, pretože Roo „sleduje“ všetky zmeny - buď prostredníctvom Roo Shell, alebo priamo vývojárom v IDE.

Roo sa postará o opakujúci sa kód ako natiahnuť() alebo rovná sa () metódy tiež.

Rámec je navyše možné z projektu ľahko odstrániť, aby sa zabránilo zablokovaniu dodávateľa odstránením anotácií a zavedením AspectJ ITD do štandardného kódu Java.

4. Záver

V tomto rýchlom príklade sa nám podarilo nainštalovať a nakonfigurovať Spring Roo v STS a vytvorili sme malý projekt.

Na jeho nastavenie sme použili program Roo Shell a nebolo potrebné písať ani jeden riadok skutočného kódu Java! A podarilo sa nám získať funkčný prototyp aplikácie za pár minút a Roo sa za nás postaral o všetok štandardný kód.

Ako vždy, kód použitý v diskusii nájdete na GitHub.


$config[zx-auto] not found$config[zx-overlay] not found