Mai multe rute GET
Un API real are zeci de adrese: produse, categorii, program, contact. Fiecare adresă la care răspunde serverul este o rută. În lecția aceasta înveți să organizezi rute cu mai multe segmente, afli cum tratează ASP.NET Core literele mari și slash-ul de la final și ce se întâmplă când definești aceeași rută de două ori.
Ce este o rută
O rută este combinația dintre o metodă HTTP și o cale. MapGet("/magazin/program", ...) creează ruta „GET la calea /magazin/program”. Când vine o cerere, ASP.NET Core caută ruta care se potrivește cu metoda și calea cererii și rulează funcția ei.
Calea este formată din segmente separate prin /. Calea /magazin/program are două segmente: magazin și program. Segmentele te ajută să grupezi adresele logic, ca dosarele dintr-un calculator:
| Ruta | Ce întoarce |
|---|---|
| GET /magazin/nume | numele magazinului |
| GET /magazin/program | programul de lucru |
| GET /magazin/contact | datele de contact |
| GET /produse | lista de produse |
Mai multe rute în același server
Fiecare MapGet adaugă o rută. Ordinea în care le scrii nu contează pentru potrivire: ASP.NET Core alege ruta după cale, nu după poziția în fișier.
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapGet("/magazin/nume", () => "Librăria Lumina");
app.MapGet("/magazin/program", () => "Luni-Vineri 9-18");
app.MapGet("/magazin/contact", () => "contact@librarie.ro");
app.Run();
// GET /magazin/program
// GET /magazin/contact
// GET /magazin
// GET /magazin/numeGET /magazin/program → 200 OK Luni-Vineri 9-18 GET /magazin/contact → 200 OK contact@librarie.ro GET /magazin → 404 Not Found GET /magazin/nume → 200 OK Librăria Lumina
Observă că GET /magazin dă 404: deși există rute care încep cu /magazin, nicio rută nu este exact /magazin. Potrivirea se face pe calea întreagă, segment cu segment.
Litere mari, litere mici și slash-ul final
Utilizatorii nu scriu mereu adresele perfect. ASP.NET Core este îngăduitor în două situații:
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapGet("/magazin/oras", () => "Cluj-Napoca");
app.Run();
// GET /magazin/oras
// GET /MAGAZIN/Oras
// GET /magazin/oras/GET /magazin/oras → 200 OK Cluj-Napoca GET /MAGAZIN/Oras → 200 OK Cluj-Napoca GET /magazin/oras/ → 200 OK Cluj-Napoca
- literele mari și mici nu contează în cale: /MAGAZIN/Oras se potrivește cu ruta /magazin/oras;
- slash-ul de la final este ignorat: /magazin/oras/ se potrivește și el.
Deși literele mari funcționează, scrie mereu rutele cu litere mici și cuvintele despărțite prin cratimă: /magazin/program-sarbatori, nu /Magazin/ProgramSarbatori. Așa arată adresele în majoritatea API-urilor publice.
Texte calculate cu interpolare
Funcția unui endpoint nu trebuie să întoarcă un text scris de mână. Poate calcula textul la fiecare cerere, cu tot ce știi din C#. Aici folosim interpolarea de stringuri ($"...") și variabile declarate înainte de rute:
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var numeMagazin = "Librăria Ana";
var oraDeschidere = 9;
var oraInchidere = 18;
app.MapGet("/magazin/program", () => $"{numeMagazin} este deschisă între {oraDeschidere} și {oraInchidere}");
app.MapGet("/magazin/ore", () => $"Program zilnic: {oraInchidere - oraDeschidere} ore");
app.Run();
// GET /magazin/program
// GET /magazin/oreGET /magazin/program → 200 OK Librăria Ana este deschisă între 9 și 18 GET /magazin/ore → 200 OK Program zilnic: 9 ore
Lambda-ul () => ... nu are parametri, dar „vede” variabilele declarate mai sus în fișier (le capturează, ca în cursul de C#). Calculul oraInchidere - oraDeschidere se face de fiecare dată când vine o cerere.
Aceeași rută de două ori: AmbiguousMatchException
Ce se întâmplă dacă, din greșeală, înregistrezi aceeași rută de două ori? Programul pornește fără eroare, dar la prima cerere ASP.NET Core nu știe pe care să o aleagă:
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapGet("/magazin/nume", () => "Librăria Ana");
app.MapGet("/magazin/nume", () => "Librăria Ioana");
app.Run();
// GET /magazin/numeGET /magazin/nume → 500 Internal Server Error Microsoft.AspNetCore.Routing.Matching.AmbiguousMatchException: The request matched multiple endpoints. Matches: HTTP: GET /magazin/nume HTTP: GET /magazin/nume
Răspunsul este 500 Internal Server Error, cu excepția AmbiguousMatchException. Mesajul în engleză înseamnă: „cererea s-a potrivit cu mai multe endpoint-uri”, iar dedesubt sunt listate endpoint-urile în conflict. În Development vezi textul excepției în corp; în producție utilizatorul ar vedea doar 500.
Fiind 5xx, este o greșeală a serverului, adică a ta. Când vezi AmbiguousMatchException, caută în Program.cs două MapGet cu aceeași cale.
Greșeli frecvente
- Spații în cale: "/magazin/ program" este altă cale decât /magazin/program. Calea nu conține spații.
- Aceeași rută de două ori: duce la 500 AmbiguousMatchException la prima cerere, nu la pornire.
- **Crezi că /magazin include /magazin/nume**: rutele se potrivesc exact; fiecare adresă are nevoie de propriul MapGet.
- Cratime vs. underscore: /program-sarbatori și /program_sarbatori sunt rute diferite; alege o convenție (cratima) și folosește-o peste tot.
Construiește cele trei rute de informații ale magazinului: GET /magazin/nume întoarce Librăria Ana, GET /magazin/oras întoarce Brașov, iar GET /magazin/program întoarce Luni-Sâmbătă 10-20. Laboratorul trimite cererile către cele trei rute și apoi GET /MAGAZIN/ORAS, care trebuie să funcționeze și ea.
- Adaugă ruta GET /magazin/nume cu textul Librăria Ana.
- Adaugă ruta GET /magazin/oras cu textul Brașov.
- Adaugă ruta GET /magazin/program cu textul Luni-Sâmbătă 10-20.
- Scrie rutele cu litere mici; cererea GET /MAGAZIN/ORAS merge fără o rută separată.
Soluția exercițiului
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapGet("/magazin/nume", () => "Librăria Ana");
app.MapGet("/magazin/oras", () => "Brașov");
app.MapGet("/magazin/program", () => "Luni-Sâmbătă 10-20");
app.Run(); 