Ce este Spring Boot și primul tău endpoint
Aplicațiile pe care le folosești zilnic (banca de pe telefon, magazinul online, aplicația de livrări) vorbesc în spate cu un server. În acest curs înveți să construiești chiar acel server, în Java, cu Spring Boot. În prima lecție afli ce este un API, ce face Spring Boot și pornești primul tău server, care răspunde la o cerere HTTP.
Ce este un server web și ce este un API
Când deschizi aplicația unei bănci și vezi soldul, telefonul nu are soldul salvat în el. Aplicația trimite o cerere prin internet către un calculator al băncii (serverul), iar serverul trimite înapoi un răspuns cu datele cerute.
Un API (Application Programming Interface) este setul de adrese la care serverul răspunde și regulile prin care îi ceri ceva. De exemplu, aplicația de livrări poate cere GET /restaurante ca să primească lista restaurantelor și GET /comenzi/15 ca să afle unde e comanda ta.
- clientul (aplicația mobilă, site-ul, alt server) trimite o cerere;
- serverul (programul scris de tine) o primește, face ce trebuie (caută în baza de date, calculează) și trimite un răspuns;
- răspunsul conține de obicei date în format JSON, pe care clientul le afișează frumos.
Front-end-ul este ce vede utilizatorul. Back-end-ul este serverul care ține datele și regulile. În acest curs scrii back-end în Java: API-uri web.
Ce este Spring Boot
Spring este cel mai folosit framework Java pentru aplicații de server. Un framework este o bibliotecă mare care îți dă scheletul aplicației: tu scrii doar partea ta (ce răspunde serverul), iar framework-ul se ocupă de rest (rețea, conversia în JSON, erori, configurare).
Spring Boot este varianta „gata de pornit” a lui Spring: alegi ce îți trebuie, iar Spring Boot configurează singur serverul web și pornește aplicația cu o singură linie de cod. În România îl găsești la bănci, companii de telecom, magazine online mari și în aproape toate firmele de outsourcing. Când vezi un anunț pentru Java Developer sau Java Backend Developer, aproape mereu se cere Spring Boot.
| Termen | Ce înseamnă |
|---|---|
| Java | limbajul în care scrii codul (l-ai învățat în cursul de Java) |
| Spring | framework-ul care ține aplicația împreună |
| Spring Boot | Spring configurat automat, cu server web inclus |
| endpoint | o adresă la care răspunde serverul, de exemplu GET /salut |
Cursul acesta presupune că știi bazele Java: variabile, metode, clase, interfețe, record, List, Map și excepții. Nu le mai explicăm aici. Dacă ceva ți se pare nou, întoarce-te la lecția din cursul de Java.
Primul tău server, linie cu linie
O aplicație Spring Boot are o clasă principală cu metoda main și cel puțin un controller, adică o clasă care răspunde la cereri. Iată cel mai mic server posibil:
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@RestController
class SalutController {
@GetMapping("/")
String salut() {
return "Salut, lume!";
}
}
// > GET /Tomcat started on port 8080 (http) Started Application GET / → 200 Salut, lume!
Rezultatul se citește așa: primele două linii spun că serverul a pornit pe portul 8080. Apoi vine cererea (GET /), după săgeată codul de status (200 înseamnă „totul a mers bine”), iar pe linia următoare corpul răspunsului, adică textul întors de metodă.
Cum rulează în realitate și cum rulează aici
La serviciu, un programator creează proiectul pe start.spring.io (alege Java, Maven și dependența Spring Web), îl deschide în IntelliJ IDEA și îl pornește din terminal:
./mvnw spring-boot:run
În jurnal apar linii ca Tomcat started on port 8080 (http) și Started Application in 1.8 seconds. Serverul ascultă la http://localhost:8080, iar cererile se trimit din browser, din Postman sau cu curl. Nu trebuie să instalezi nimic din toate acestea acum.
În dreapta ai un laborator care face totul pentru tine: compilează fișierul Application.java, pornește aplicația și îi trimite cererile HTTP. Pentru fiecare cerere vezi linia de status și corpul răspunsului.
Ca să încerci singur o adresă, scrie la finalul fișierului un comentariu de forma // > GET /cale. Laboratorul trimite câte o cerere pentru fiecare astfel de comentariu, în ordine. La verificarea exercițiului, laboratorul trimite propriile cereri.
Mai multe endpoint-uri și o adresă care nu există
Un controller poate avea oricâte metode. Fiecare @GetMapping adaugă o adresă nouă. Ce se întâmplă dacă cineva cere o adresă pe care n-ai definit-o?
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@RestController
class MagazinController {
@GetMapping("/")
String acasa() {
return "Pagina principală";
}
@GetMapping("/contact")
String contact() {
return "Ne găsești în București";
}
}
// > GET /
// > GET /contact
// > GET /despreTomcat started on port 8080 (http)
Started Application
GET / → 200
Pagina principală
GET /contact → 200
Ne găsești în București
GET /despre → 404
{"status":404,"error":"Not Found","path":"/despre"}Pentru /despre nu există nicio metodă, așa că Spring Boot răspunde singur cu 404 Not Found și un mic JSON care descrie eroarea: codul (status), numele erorii (error) și adresa cerută (path). Este exact ce vezi pe un site când intri pe o pagină care nu există.
Într-un proiect real fiecare clasă stă în fișierul ei (Application.java, MagazinController.java), în pachete ca ro.magazin. În laborator scrii totul în Application.java, fără linia package: Spring găsește clasele la fel.
Greșeli frecvente la început
- **Uiți @RestController**: clasa există, dar Spring nu o folosește pentru cereri, iar adresa ta răspunde cu 404.
- Uiți ghilimelele din jurul adresei: @GetMapping(/salut) nu compilează. Adresa este un String: "/salut".
- Uiți slash-ul de la început: scrie "/salut", nu "salut", ca să fie clar că este o cale de la rădăcina serverului.
- Uiți un import: laboratorul îți spune exact ce linie import lipsește.
- Confunzi 404 cu o eroare a programului: 404 înseamnă doar că adresa cerută nu există, serverul funcționează normal.
În lecțiile următoare înveți ce este HTTP mai exact (metode, coduri de status, antete) și cum să trimiți și să primești date JSON. Deocamdată este suficient să știi să adaugi un endpoint care întoarce un text.
Pe scurt
- Un API este setul de adrese la care răspunde un server; clientul trimite cereri, serverul trimite răspunsuri (de obicei JSON).
- Spring Boot este framework-ul Java cel mai folosit pentru servere: pornește aplicația și serverul web cu SpringApplication.run.
- @SpringBootApplication marchează clasa principală, @RestController clasa care răspunde la cereri, @GetMapping("/cale") metoda unui endpoint.
- 200 înseamnă succes, 404 înseamnă că adresa nu există.
- Comentariile // > GET /cale de la finalul fișierului îți trimit propriile cereri de test în laborator.
Construiește primul endpoint al Academiei: la adresa /salut, serverul trebuie să răspundă cu textul Bun venit la Academia Programatorilor!. Laboratorul trimite două cereri: GET /salut și GET / (pentru / nu definești nimic, deci răspunsul corect este 404).
- În clasa AcademieController adaugă o metodă adnotată cu @GetMapping("/salut").
- Metoda întoarce exact textul Bun venit la Academia Programatorilor!.
- Nu adăuga o metodă pentru /: cererea GET / trebuie să primească 404.
- Lasă neschimbate clasa Application și adnotarea @RestController.
Soluția exercițiului
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@RestController
class AcademieController {
@GetMapping("/salut")
String salut() {
return "Bun venit la Academia Programatorilor!";
}
} 