Acest tutorial iluminează crearea pas cu pas a aplicației de pornire de primăvară utilizând Mapperul de relații obiect Grails (GORM) și Hibernate.
Ce vei crea?
Veți crea o aplicație de primăvară care salvează datele într-o bază de date în memorie folosind GORM.
În această lecție se folosește numai biblioteca Grails GORM. Nu trebuie să utilizați întregul Web-stiluri Grails.
Ce ai nevoie
Cum să treci această lecție
Ca cele mai multe clase de primăvară, puteți începe de la zero și să faceți fiecare pas sau să săriți pașii de bază pe care îi cunoașteți deja. Oricum, vei termina cu un cod de lucru.
Când ați terminat. Puteți compara rezultatul rezultat cu eșantionul în gs-accessing-data-gorm / complete.
Configurarea proiectului
În primul rând, trebuie să configurați un script de bază. Puteți utiliza orice sistem de construire pe care vă place să construiți proiecte de primăvară, dar în această lecție, luați în considerare codul pentru lucrul cu Gradle. Dacă nu sunteți familiarizați cu aceasta, verificați lecția corespunzătoare Construirea unui proiect Java folosind Gradle.
Crearea unei structuri de directoare
În directorul de proiect pe care l-ați selectat, creați următoarea structură de directoare; De exemplu, src comanda mkdir -p / principal / Groovy / alo pentru * nix sisteme:
Crearea unui fișier de construcție Gradle
Mai jos este fișierul inițial de construire Gradle. Dacă utilizați programul Spring Tool Suite (STS). puteți importa o lecție direct din ea.
Dacă te uiți la pom.xml. veți găsi că este specificată versiunea pentru maven-compiler-plugin. În general, acest lucru nu este recomandat. În acest caz, este conceput pentru a rezolva probleme cu sistemul nostru CI, care implicit are o versiune veche (înainte de versiunea Java 5) a acestui plugin.
Pluginul Plugin Plugin Plugin oferă multe caracteristici convenabile:
- Colectează toate borcanele în calea de clasă și colectează un "über-jar" unic, executabil, ceea ce face mai convenabil să executați și să vă furnizați serviciul
- Se caută metoda public void static (), ca semn al clasei executabile
- Acesta oferă o rezoluție de dependență încorporată, cu numere de versiune specifice pentru dependențele de primăvară corespunzătoare. Puteți să înlocuiți toate versiunile pe care le doriți, dar va fi implicit pentru Boot de setul de versiuni selectat
Crearea unei entități GORM
În acest exemplu, simulăm o entitate simplă persoană care utilizează GORM:
Blocul de restricții descrie orice reguli de validare. În acest caz, numai utilizarea câmpurilor care nu sunt goale este restricționată.
Crearea unui controler de resurse
Creați un controler pentru aplicația dvs. Groovy Spring:
Exemplul descrie două puncte de ieșire REST:
- addPerson vă permite să adăugați o persoană nouă
- salut salută o persoană după numele său
Apoi, veți vedea cum să porniți aplicația și să creați o nouă entitate Persoană.
Creați o executabilă a aplicației
În ciuda faptului că pachetul acestui serviciu poate face parte din fișierele de aplicații web și de fișiere WAR, abordarea mai simplă prezentată mai jos creează o aplicație autonomă separată. Împachetați totul într-un singur fișier JAR executabil, care rulează prin metoda veche familiar () familiar Java. Pe parcurs, utilizați suportul de primăvară pentru containerul de servlet pentru Tomcat încorporat ca o durată de execuție HTTP în loc să îl implementați la o instanță terță parte.
Metoda principal () trece controlul la clasa auxiliară SpringApplication. unde Application.class este argumentul metodei run (). Acest lucru spune de primăvară de citire adnotări de metadate ale aplicației și managementul acesteia ca o componentă într-un context aplicație de primăvară.
Annotarea @ComponentScan îi spune lui Spring căutarea recursivă a cursurilor din pachetul hello și descendenții săi, etichetați direct sau indirect de adnotarea de primăvară @Component. Această directivă garantează că Primăvara găsește și înregistrează un GreetingController. deoarece este marcat @Controller. care, la rândul său, este un fel de adnotare @Component.
Adnotarea @EnableAutoConfiguration comută la un comportament implicit, bazat pe conținutul căii dvs. de clasă. De exemplu, pentru că Aplicația depinde de versiunea încorporată Tomcat (tomcat-embed-core.jar), serverul Tomcat este instalat și configurat pentru un comportament implicit în numele dvs. Și de atunci Aplicația depinde, de asemenea, de primăvara MVC (spring-webmvc.jar), Spring MVC DispatcherServlet este configurat și înregistrat pentru tine - web.xml nu este necesar! Autoconfigurarea este un mecanism util și flexibil. Pentru mai multe informații, consultați documentul API.
Construirea unui JAR executabil
Puteți compila un singur fișier executabil JAR care conține toate dependențele, clasele și resursele necesare. Acest lucru facilitează descărcarea, versiunea și implementarea serviciului ca aplicație pe tot parcursul perioadei de dezvoltare, în medii diferite și așa mai departe.
Apoi puteți rula fișierul JAR:
Dacă utilizați Maven, puteți rula aplicația utilizând mvn spring-boot: run. sau puteți construi o aplicație cu un pachet mvn clean și rulați JAR-ul astfel:
Procedura descrisă mai sus creează un JAR executabil. Puteți crea, de asemenea, un fișier clasic WAR în schimb.
Rularea aplicației
Dacă folosiți Gradle, puteți începe serviciul dvs. din linia de comandă:
Dacă utilizați Maven, puteți porni serviciul dvs. astfel: pachet mvn clean java -jar țintă / gs-accessing-data-gorm-0.1.0.jar.
Alternativ, puteți rula serviciul direct de la Gradle, astfel:
Cu mvn - mvn, cizma de primăvară: rulați.
Testarea aplicației
Când începe aplicația, puteți crea o persoană nouă prin trimiterea unei solicitări POST. De exemplu, utilizând instrumentul * nix curl.
Rezultatul răspunsului arătat mai jos indică faptul că resursa a fost creată:
Apoi puteți trimite cererea GET către / salut pentru a primi salutul:
Suport Script Groovy
Exemplul precedent vă cere să instalați sistemul de construcție Gradle sau Maven, dar puteți utiliza, de asemenea, GORM într-un script Groovy simplu.
De exemplu, creați un nou fișier app.groovy și puneți în el următorul cod:
Nu contează unde este localizat fișierul.
Rulați-l după cum se arată mai jos:
Se presupune că ați finalizat aplicația anterioară pentru a evita coliziunile porturilor.
Configurarea sursei de date
javax.sql.DataSource. folosit pentru a crea conexiuni, poate fi configurat în conformitate cu instrucțiunile din manualul de utilizare Spring Boot.
Felicitări! Tocmai ați creat o aplicație de primăvară utilizând GORM pentru a accesa datele.
Puteți citi textul original al lecției pe spring.io.