...
← Curs ASP.NET Core: toate lecțiile
Lecția 4 · Rute

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:

RutaCe întoarce
GET /magazin/numenumele magazinului
GET /magazin/programprogramul de lucru
GET /magazin/contactdatele de contact
GET /produselista 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/nume
GET /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.
Convenția din industrie

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/ore
GET /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/nume
GET /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.

Atenție

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

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ă.
Trei apeluri app.MapGet("/magazin/...", () => "...");. Nu ai nevoie de nimic special pentru literele mari.

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();
Excelent! Continuă cu lecția următoare →
Program.csASP.NET Core
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 ASP.NET Core Lecția 4 · Mai multe rute GET
Progres 0% 0 din 22
Lecția curentă 4 / 20 Rute