...
← Curs Spring Boot și REST API: toate lecțiile
Lecția 4 · Rute

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 /mese
Tomcat 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.
Numele metodei nu contează pentru URL

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 /produse
Tomcat 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.

Un controller pentru fiecare subiect

Î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.

În laborator

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țiaRute 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).
Exercițiul tău

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.
Trei metode separate, de forma @GetMapping("/magazin/nume") String nume() { return "..."; }.

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";
    }
}
Excelent! Continuă cu lecția următoare →
Application.javaSpring Boot
ConsolăSe încarcă...
Mediul de lucru se încarcă. Poți citi lecția între timp.
Rulează codul cu butonul de sus sau cu Ctrl + Enter / Cmd + Enter.
Parcursul tău Primul tău API cu Spring Boot Lecția 4 · Mai multe rute în același controller
Progres 0% 0 din 20
Lecția curentă 4 / 18 Rute