MyCodeSchool

Pasul 1 din 5

Spring Boot

Pasul 1 din 5 · Ce construiești

  • Spring Boot
  • Mediu
  • 13 minute

Ce face Spring Boot pentru tine

Pornești o aplicație care spune câte mese libere are un club de șah. Are o singură clasă importantă, dar răspunde deja pe HTTP. Așa arată când rulează:

Terminalul aplicației
Pornit pe portul 8731
Al doilea terminal
$ curl localhost:8731/stare
Clubul Pion: 12 mese libere

Nu ai scris niciun server web, niciun fișier XML și nicio linie care pornește Tomcat. Le face Spring Boot, pe baza a ce găsește în proiect. În lecția asta afli ce anume face și cum îl controlezi.

Lecția presupune că știi ce e un bean și cum îl primești prin constructor. Dacă nu, începe cu containerul Spring și injecția de dependențe.

Pasul 2 din 5

Urmărește pornirea

Apasă pe „Linia următoare”. În stânga vezi ce află Spring despre aplicație, în dreapta ce apare în terminal. La final, cineva cere /stare.

ClubApp.java
package ro.exemplu.club;import org.springframework.boot.*;import org.springframework.boot.autoconfigure.*;import org.springframework.boot.context.properties.*;import org.springframework.web.bind.annotation.*;@SpringBootApplication@ConfigurationPropertiesScanpublic class ClubApp {    public static void main(String[] args) {        SpringApplication.run(ClubApp.class, args);    }}@ConfigurationProperties("club")record Club(String nume, int mese) {}@RestControllerclass StareController {    private final Club club;    StareController(Club club) {        this.club = club;    }    @GetMapping("/stare")    String stare() {        return club.nume() + ": "                + club.mese() + " mese libere";    }}

Ce știe Spring

Ce apare în terminal


      

  1. Linia 12. SpringApplication.run pornește totul. Primul lucru: citește application.properties din src/main/resources. Acolo stau portul, numele clubului și numărul de mese.
  2. Linia 8. @SpringBootApplication adună trei adnotări. @ComponentScan îi spune lui Spring să caute clase marcate în pachetul ro.exemplu.club și în subpachetele lui.
  3. Linia 8, din nou. A treia parte, @EnableAutoConfiguration, se uită ce biblioteci sunt în proiect. Găsește Spring MVC și Tomcat, aduse de starterul web, și le configurează singur.
  4. Liniile 16–17. @ConfigurationPropertiesScan de la linia 9 găsește recordul Club. Spring ia toate cheile care încep cu club. și le pune în câmpurile cu același nume. "12" din fișier devine int.
  5. Liniile 20–23. Scanarea găsește și controller-ul. Constructorul cere un Club, iar Spring îi dă bean-ul creat la pasul anterior.
  6. Linia 26. @GetMapping("/stare") leagă metoda de adresa /stare. Spring MVC își notează: o cerere GET pe /stare merge la stare().
  7. Linia 12, la final. Contextul e gata, Tomcat ascultă pe portul 8731, iar run se întoarce. Mesajul din terminal vine de la clasa Port din teorie.
  8. Liniile 28–29. Rulezi curl localhost:8731/stare. Tomcat primește cererea, Spring MVC cheamă stare(), iar textul întors ajunge în corpul răspunsului, cu codul 200.
  9. Gata. Aplicația nu se oprește: așteaptă următoarea cerere până o închizi cu Ctrl+C.

Prezice ieșirea

Schimbi în application.properties linia în club.mese=7 și repornești. Ce răspunde /stare?

Răspuns: Clubul Pion: 7 mese libere.

Codul Java nu conține numărul 12, doar câmpul mese. Valoarea vine din fișier la fiecare pornire, iar Spring convertește textul 7 în int.

Pasul 3 din 5

Ce face Boot și cum îl controlezi

Patru idei, fiecare cu un fișier real din proiect. La final, trei erori pe care le vei vedea sigur la început.

Un starter, un pachet întreg

pom.xml, dependența web
<dependency>    <groupId>org.springframework.boot</groupId>    <artifactId>spring-boot-starter-web</artifactId></dependency>

Un starter e o dependență care nu conține cod, ci aduce o listă verificată de biblioteci compatibile între ele. spring-boot-starter-web aduce Spring MVC, serverul Tomcat și Jackson, care transformă obiecte în JSON.

Nu scrii versiuni: le fixează părintele spring-boot-starter-parent. Pentru baze de date adaugi spring-boot-starter-data-jpa, pentru teste spring-boot-starter-test.

Auto-configurarea, la vedere

Boot are sute de clase de configurare, fiecare cu o condiție: „pornesc doar dacă găsesc clasa X”. Pornește aplicația cu --debug și primești raportul. Două fragmente reale din el:

raportul de condiții, fragment
DispatcherServletAutoConfiguration matched:
   - @ConditionalOnClass found required class 'org.springframework.web.servlet.DispatcherServlet' (OnClassCondition)

DataSourceAutoConfiguration:
   Did not match:
      - @ConditionalOnClass did not find required class 'org.springframework.jdbc.datasource.embedded.EmbeddedDatabaseType' (OnClassCondition)

Spring MVC e în proiect, deci se configurează. Nu există nicio bibliotecă de baze de date, deci Boot nu încearcă să se conecteze la vreuna. Adaugi un starter și comportamentul se schimbă, fără cod nou.

application.properties și @Value

application.properties
spring.main.banner-mode=offlogging.level.root=warnserver.port=8731club.nume=Clubul Pionclub.mese=12
Port.java
package ro.exemplu.club;import org.springframework.beans.factory.annotation.Value;import org.springframework.boot.CommandLineRunner;import org.springframework.stereotype.Component;@Componentclass Port implements CommandLineRunner {    @Value("${server.port}")    private int port;    public void run(String... args) {        System.out.println("Pornit pe portul " + port);    }}

Ce apare în terminal

Pornit pe portul 8731

Fișierul ține perechi cheie = valoare. Unele chei sunt ale lui Boot: server.port schimbă portul, logging.level.root=warn ascunde jurnalul obișnuit de pornire. Cheile club.* sunt inventate de noi.

@Value("${server.port}") citește o singură cheie. E bun pentru o valoare izolată; pentru un grup de valori, folosește cardul următor.

@ConfigurationProperties și profiluri

Recordul Club din programul rulat primește toate cheile club.* deodată, cu tipurile verificate la pornire. Pentru alt mediu, creezi un fișier cu numele profilului:

application-turneu.properties
club.mese=2
pornit cu --spring.profiles.active=turneu
$ curl localhost:8731/stare
Clubul Pion: 2 mese libere

Cu profilul turneu activ, Spring citește ambele fișiere, iar cheile din application-turneu.properties le acoperă pe cele comune. Numele rămâne cel din fișierul de bază.

Capcană: portul e deja ocupat

Pornești aplicația a doua oară, uitând că prima încă rulează:

***************************
APPLICATION FAILED TO START
***************************

Description:

Web server failed to start. Port 8731 was already in use.

Repară oprind prima instanță cu Ctrl+C sau pornind-o pe alt port: --server.port=8732.

Capcană: o cheie care nu există

Scrii @Value("${club.adresa}"), dar cheia lipsește din fișier. Aplicația nu pornește, iar cauza e la capătul lungului mesaj de eroare:

org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'adresa': Injection of autowired dependencies failed
…
Caused by: org.springframework.util.PlaceholderResolutionException: Could not resolve placeholder 'club.adresa' in value "${club.adresa}"

Repară adăugând cheia în fișier sau o valoare implicită după două puncte: @Value("${club.adresa:necunoscută}").

Capcană: diacriticele din .properties

Scrii club.nume=Clubul de șah Pion. Fișierele .properties sunt citite ca ISO-8859-1, nu ca UTF-8, așa că răspunsul devine Clubul de Èah Pion: în locul lui „ș” apare „È”, urmat de un caracter invizibil.

Repară mutând textele cu diacritice în application.yml, care e citit ca UTF-8: club:, apoi pe rândul următor, indentat, nume: Clubul de șah Pion.

Pasul 4 din 5

Verifică-te

Cinci întrebări noi. După fiecare răspuns vezi imediat de ce e așa.

1 din 5 · Prezice ieșirea

În application.properties ai club.mese=12, în application-turneu.properties ai club.mese=2. Pornești fără niciun profil activ. Ce răspunde /stare?

Răspuns: Clubul Pion: 12 mese libere.

Fișierul unui profil e citit doar când profilul e activ. Fără --spring.profiles.active=turneu, contează numai fișierul de bază.

2 din 5 · Alege varianta

De ce pornește Tomcat, deși n-ai scris nicăieri cod pentru el?

Răspuns: starterul l-a adus, auto-configurarea l-a pornit.

Condițiile auto-configurării se uită după clase din proiect. Fără starterul web, @RestController nici n-ar compila, iar Tomcat n-ar exista.

3 din 5 · Alege varianta

ClubApp e în pachetul ro.exemplu.club. Muți controller-ul în ro.exemplu.web. Ce primești la curl localhost:8731/stare?

Răspuns: 404.

Scanarea pornește din pachetul clasei cu @SpringBootApplication și coboară doar în subpachete. ro.exemplu.web e alături, nu dedesubt, deci controller-ul nu devine bean și nimeni nu ascultă pe /stare.

4 din 5 · Prezice ieșirea

Cheia club.oras nu există în niciun fișier. Ce valoare primește oras?

Oras.java, fragment
@Value("${club.oras:Cluj}")private String oras;

Răspuns: "Cluj".

Ce urmează după două puncte e valoarea implicită, folosită doar când cheia lipsește. Fără ea, aplicația s-ar fi oprit cu Could not resolve placeholder.

5 din 5 · Alege varianta

În fișier ai server.port=8731. Pornești cu --server.port=9000 în linia de comandă. Pe ce port ascultă aplicația?

Răspuns: 9000.

Argumentele din linia de comandă au prioritate față de fișierele din proiect. Așa schimbi o valoare la pornire, fără să reconstruiești aplicația.

Pasul 5 din 5

Ce ai învățat

Încearcă singur

Pornește de la proiectul generat pe start.spring.io cu dependența „Spring Web”, copiază ClubApp.java din pasul 2 și fișierele de configurare din teorie. Apoi adaugă o cheie club.oras în record și verifică răspunsul cu și fără profilul turneu.

pornirea, din folderul proiectului
$ ./mvnw spring-boot:run -Dspring-boot.run.profiles=turneu

Continuă cu