Mai multe rute în același controller
Un API real are zeci de adrese. În lecția aceasta pui mai multe metode @GetMapping în același controller, construiești răspunsul din calcule, folosești căi cu mai multe segmente și afli ce se întâmplă când două metode cer aceeași adresă.
O rută = o metodă
O rută este perechea „metodă HTTP + cale” (de exemplu GET /meniu). Fiecare metodă Java adnotată cu @GetMapping adaugă o rută. Un controller poate avea oricâte, iar metoda nu trebuie doar să întoarcă un text fix: poate calcula răspunsul.
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 CafeneaController {
@GetMapping("/meniu")
String meniu() {
return "Espresso, Cappuccino, Latte";
}
@GetMapping("/oferta")
String oferta() {
int pretVechi = 15;
int reducere = 3;
return "Cappuccino la " + (pretVechi - reducere) + " lei în loc de " + pretVechi;
}
@GetMapping("/mese")
String mese() {
int libere = 4;
int total = 12;
return String.format("%d mese libere din %d", libere, total);
}
}
// > GET /meniu
// > GET /oferta
// > GET /meseTomcat started on port 8080 (http) Started Application GET /meniu → 200 Espresso, Cappuccino, Latte GET /oferta → 200 Cappuccino la 12 lei în loc de 15 GET /mese → 200 4 mese libere din 12
- /meniu întoarce un text fix.
- /oferta calculează prețul și lipește textele cu +, ca în orice program Java.
- /mese folosește String.format cu %d (număr întreg); %s merge pentru texte.
Spring alege metoda după adnotare, nu după nume. Metoda meniu() putea să se numească x() și ruta ar fi fost tot /meniu. Totuși, dă-i un nume clar: îl citesc colegii tăi.
Căi cu mai multe segmente
O cale poate avea mai multe segmente, separate prin /: /produse/noi, /produse/reduceri/azi. Așa grupezi adresele care țin de același subiect. Iar adresele nu trebuie să stea toate în aceeași clasă: poți avea mai multe controllere.
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 ProduseController {
@GetMapping("/produse/noi")
String noi() {
return "Laptop Nova 14, Mouse Silent";
}
@GetMapping("/produse/reduceri/azi")
String reduceriAzi() {
return "Tastatură Pro -20%";
}
}
@RestController
class ContController {
@GetMapping("/cont/comenzi")
String comenzi() {
return "Ai 3 comenzi";
}
}
// > GET /produse/noi
// > GET /produse/reduceri/azi
// > GET /cont/comenzi
// > GET /produseTomcat started on port 8080 (http)
Started Application
GET /produse/noi → 200
Laptop Nova 14, Mouse Silent
GET /produse/reduceri/azi → 200
Tastatură Pro -20%
GET /cont/comenzi → 200
Ai 3 comenzi
GET /produse → 404
{"status":404,"error":"Not Found","path":"/produse"}/produse dă 404 chiar dacă există /produse/noi: Spring compară calea întreagă, segment cu segment. O cale nu este un director care „conține” automat ceva.
În proiectele reale, fiecare controller se ocupă de un singur subiect: ProdusController pentru produse, ComandaController pentru comenzi, ContController pentru contul utilizatorului. Așa găsești ușor codul unei rute.
Două metode pe aceeași rută
Ce se întâmplă dacă, din greșeală, scrii două metode cu @GetMapping("/magazin/program")? Spring nu poate alege una dintre ele, așa că aplicația nu pornește. Mesajul real din jurnal arată așa:
java.lang.IllegalStateException: Ambiguous mapping. Cannot map 'magazinController' method
MagazinController#orar()
to {GET [/magazin/program]}: There is already 'magazinController' bean method
MagazinController#program() mapped.Se citește: „nu pot lega metoda orar() de GET /magazin/program, pentru că acolo este deja legată program()”. Soluția: schimbi calea uneia dintre metode sau o ștergi pe cea în plus. Greșeala apare des după un copy-paste.
Simulatorul din dreapta nu verifică rutele duplicate: dacă încerci, pornește și folosește prima metodă. Într-un proiect real, aplicația se oprește cu mesajul de mai sus, așa că păstrează fiecare rută unică.
Exemple reale
| Aplicația | Rute GET tipice |
|---|---|
| magazin online | /produse/noi, /produse/reduceri, /categorii |
| aplicația unei bănci | /conturi, /conturi/sold, /carduri |
| platformă de cursuri | /cursuri, /cursuri/populare, /profil/certificate |
Observă că rutele sunt substantive (/produse, /conturi), nu verbe (/arataProduse). Verbul este deja metoda HTTP: GET înseamnă „arată-mi”.
Greșeli frecvente
- Aceeași cale pe două metode: aplicația nu pornește (Ambiguous mapping).
- Spații sau majuscule în cale: /Magazin/Nume și /magazin/nume sunt căi diferite. Folosește litere mici și cratimă pentru mai multe cuvinte (/produse-noi).
- Slash la final: cererea /magazin/nume/ (cu slash în plus) nu se potrivește cu /magazin/nume în Spring Boot 3; nu adăuga slash la final.
- **Aștepți ca /produse să meargă pentru că există /produse/noi**: fiecare cale se definește separat.
Pe scurt
- Fiecare @GetMapping("/cale") adaugă o rută; un controller poate avea oricâte.
- Metoda poate calcula răspunsul (concatenare, String.format cu %s și %d).
- Căile pot avea mai multe segmente și se compară întregi.
- Poți avea mai multe controllere în aceeași aplicație.
- Două metode pe aceeași rută: aplicația nu pornește (Ambiguous mapping).
Librăria Ana vrea trei adrese cu informații despre magazin: GET /magazin/nume întoarce Librăria Ana, GET /magazin/oras întoarce Cluj-Napoca, iar GET /magazin/program întoarce Luni-Sâmbătă, 10-20. Laboratorul trimite și GET /magazin, care trebuie să primească 404.
- Adaugă în MagazinController trei metode, fiecare cu @GetMapping și calea ei.
- Fiecare metodă întoarce exact textul cerut (cu diacritice).
- Nu adăuga o rută pentru /magazin.
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 MagazinController {
@GetMapping("/magazin/nume")
String nume() {
return "Librăria Ana";
}
@GetMapping("/magazin/oras")
String oras() {
return "Cluj-Napoca";
}
@GetMapping("/magazin/program")
String program() {
String zile = "Luni-Sâmbătă";
return zile + ", 10-20";
}
} 