Continui proiectul de ateliere din prima parte. Mutăm rutele într-un controller, trimitem clientului obiecte făcute pentru el și lăsăm ASP.NET Core să respingă singur datele greșite. O cerere cu trei greșeli primește trei explicații:
HTTP/1.1 400 Bad Request
Content-Type: application/problem+json; charset=utf-8
{"type":"https://tools.ietf.org/html/rfc9110#section-15.5.1","title":"One or more validation errors occurred.","status":400,"errors":{"Data":["The Data field is required."],"Titlu":["The field Titlu must be a string with a minimum length of 3 and a maximum length of 120."],"Locuri":["The field Locuri must be between 1 and 500."]},"traceId":"00-ed78bbf3f0fe788bdf9c9fe6da92ef94-5a0ed2057e926834-00"}
N-ai scris niciun if pentru aceste verificări. Ai pus doar atribute pe o clasă, iar traceId te ajută să găsești cererea în loguri.
să grupezi rutele unei resurse într-un controller
să separi ce primești și ce trimiți de entități, cu DTO-uri
să validezi cu atribute ca [Required] și [Range]
să răspunzi cu 201, 400 și 404, cu corpul potrivit fiecăruia
Pasul 2 din 5
Două cereri spre aceeași metodă
Mai jos e metoda care creează un atelier. Trimiți întâi cererea greșită de mai sus, apoi una corectă. Urmărește ce se întâmplă înainte ca metoda să ruleze.
EvenimenteController.cs, POST
[HttpPost]publicasync Task<ActionResult<EvenimentDto>> Creeaza(EvenimentNou nou){var e = new Eveniment { Titlu = nou.Titlu, Data = nou.Data!.Value, Locuri = nou.Locuri }; db.Evenimente.Add(e);await db.SaveChangesAsync();var dto = new EvenimentDto( e.Id, e.Titlu, e.Data, e.Locuri, 0);returnCreatedAtAction(nameof(Unul),new { id = e.Id }, dto);}
Stare
Răspunsuri
Linia 1. Sosește POST /api/evenimente. Ruta controllerului plus [HttpPost] se potrivesc, deci a fost aleasă metoda Creeaza.
Linia 3. JSON-ul e citit într-un EvenimentNou, apoi atributele sunt verificate. Trei reguli sunt încălcate. Pentru că controllerul are [ApiController], răspunsul 400 pleacă imediat, iar corpul metodei nu rulează deloc.
Linia 1. A doua cerere, cu titlu, dată și 15 locuri.
Linia 3. Toate regulile sunt respectate, deci metoda primește obiectul nou.
Linia 5. Din DTO construim entitatea. nou.Data!.Value: ! îi spune compilatorului că știm că nu e null. Știm, pentru că [Required] a verificat deja.
Linia 11. Entitatea e marcată Added.
Linia 12. INSERT în MySQL. Atelierul primește Id 4.
Linia 13. Răspunsul e tot un DTO, nu entitatea. Un atelier nou are 0 înscriși.
Linia 15.CreatedAtAction dă 201 și construiește adresa din ruta metodei Unul, cu id = 4.
Gata. O singură metodă, dar două drumuri: validarea a oprit cererea greșită înaintea codului tău.
Prezice răspunsul
Trimiți {"titlu":"Atelier de șah","data":"2026-12-20T10:00:00","locuri":600}. Ce primești?
Răspuns: 400, cu o singură eroare, la Locuri.
[Range(1, 500)] nu corectează valoarea, doar o respinge: „The field Locuri must be between 1 and 500.” Celelalte câmpuri sunt valide, deci nu apar în errors.
Pasul 3 din 5
Controller, DTO, validare
Trei piese care apar în orice API ASP.NET Core de producție. La final, o eroare de pornire și o greșeală care trece de validare.
1
Controllerul: rutele unei resurse, la un loc
Controllers/EvenimenteController.cs
using Microsoft.AspNetCore.Mvc;using Microsoft.EntityFrameworkCore;[ApiController][Route("api/evenimente")]publicclassEvenimenteController(AppDbContext db) : ControllerBase{ [HttpGet]publicasync Task<List<EvenimentDto>> Toate() => await db.Evenimente .OrderBy(e => e.Data) .Select(e => new EvenimentDto( e.Id, e.Titlu, e.Data, e.Locuri, e.Inscrieri.Count)) .ToListAsync(); [HttpGet("{id:int}")]publicasync Task<ActionResult<EvenimentDto>> Unul(int id) {var dto = await db.Evenimente .Where(e => e.Id == id) .Select(e => new EvenimentDto( e.Id, e.Titlu, e.Data, e.Locuri, e.Inscrieri.Count)) .FirstOrDefaultAsync();return dto isnull ? NotFound() : dto; } [HttpPost]publicasync Task<ActionResult<EvenimentDto>> Creeaza(EvenimentNou nou) {var e = new Eveniment { Titlu = nou.Titlu, Data = nou.Data!.Value, Locuri = nou.Locuri }; db.Evenimente.Add(e);await db.SaveChangesAsync();var dto = new EvenimentDto( e.Id, e.Titlu, e.Data, e.Locuri, 0);returnCreatedAtAction(nameof(Unul),new { id = e.Id }, dto); }}
[Route] pe clasă dă prefixul, iar [HttpGet("{id:int}")] pe metodă completează adresa. Contextul vine prin constructor: ASP.NET Core îl creează și îl dă controllerului la fiecare cerere.
ActionResult<EvenimentDto> îți permite să întorci fie un DTO, cu 200, fie un rezultat ca NotFound(). Cu [ApiController], chiar și 404 primește un corp standard, application/problem+json.
În Program.cs, rutele minimale din prima parte sunt înlocuite de două linii:
Program.cs
using Microsoft.EntityFrameworkCore;var builder = WebApplication.CreateBuilder(args);var cs = builder.Configuration .GetConnectionString("Mysql");builder.Services.AddDbContext<AppDbContext>( o => o.UseMySql(cs,newMySqlServerVersion(newVersion(8, 4))));builder.Services.AddControllers();var app = builder.Build();app.MapControllers();app.Run();
2
DTO-uri: ce intră și ce iese
Dto.cs
using System.ComponentModel.DataAnnotations;publicrecordEvenimentDto(int Id, string Titlu, DateTime Data, int Locuri, int Inscrisi);publicclassEvenimentNou{ [Required] [StringLength(120, MinimumLength = 3)]publicstring Titlu { get; set; } = ""; [Required]public DateTime? Data { get; set; } [Range(1, 500)]publicint Locuri { get; set; }}
Entitatea descrie tabela. DTO-ul (data transfer object) descrie mesajul. EvenimentNou nu are Id, deci clientul nu poate alege singur cheia. EvenimentDto are Inscrisi, un număr care nu există ca o coloană.
Select direct în DTO face ca EF Core să ceară doar coloanele necesare și să numere înscrierile chiar în MySQL. Din log:
SQL-ul pentru GET /api/evenimente
SELECT `e`.`Id`, `e`.`Titlu`, `e`.`Data`, `e`.`Locuri`, (
SELECT COUNT(*)
FROM `Inscrieri` AS `i`
WHERE `e`.`Id` = `i`.`EvenimentId`)
FROM `Evenimente` AS `e`
ORDER BY `e`.`Data`
3
Validarea prin atribute
Atribute de validare folosite des
Atribut
Cere
[Required]
valoarea să existe
[StringLength]
lungime minimă și maximă
[Range]
număr între două limite
[EmailAddress]
format de email
Regulile stau pe DTO, lângă date, nu împrăștiate prin metode. [ApiController] le verifică înainte de apel și răspunde cu toate erorile odată, ca utilizatorul să le poată corecta dintr-o singură încercare.
Validarea prin atribute verifică forma datelor. Regulile care cer baza de date, ca „atelierul mai are locuri?”, vin în partea a treia.
Capcană: MapControllers fără AddControllers
Aplicația nici nu pornește. dotnet run se oprește imediat:
Program.cs
var builder = WebApplication.CreateBuilder(args);var app = builder.Build();app.MapControllers();app.Run();
Unhandled exception. System.InvalidOperationException: Unable to find the required services. Please add all the required services by calling 'IServiceCollection.AddControllers' inside the call to 'ConfigureServices(...)' in the application startup code.
Repară adăugând builder.Services.AddControllers(); înainte de Build. Invers, AddControllers fără MapControllers pornește, dar toate rutele dau 404.
Capcană: [Required] pe un DateTime
Pare suficient. Dar un DateTime are mereu o valoare: dacă lipsește din JSON, primește valoarea implicită, iar [Required] o consideră prezentă.
Dto.cs, varianta greșită
[Required]public DateTime Data { get; set; }
-d '{"titlu":"Atelier de pictură","locuri":10}'HTTP/1.1 201 Created
{"id":5,"titlu":"Atelier de pictură","data":"0001-01-01T00:00:00","locuri":10,"inscrisi":0}
Repară cu DateTime?, ca în Dto.cs. Lipsa devine null, iar [Required] o prinde. La fel pentru int, bool și orice alt tip valoare.
Pasul 4 din 5
Verifică-te
Cinci întrebări despre controllerul de ateliere. După fiecare răspuns vezi imediat de ce e așa.
1 din 5 · Prezice răspunsul
Ce primești la GET /api/evenimente/999, dacă atelierul nu există?
Răspuns: 404, cu un JSON cu „title”:„Not Found”.
Cu [ApiController], NotFound() primește un corp ProblemDetails: type, title, status și traceId. În Minimal API, din prima lecție, 404 venea fără corp.
2 din 5 · Alege varianta
De ce Creeaza primește un EvenimentNou, nu direct un Eveniment?
Răspuns: ca clientul să nu poată trimite câmpuri nepermise.
Cu entitatea ca parametru, un client ar putea trimite un Id sau o listă de înscrieri. DTO-ul acceptă doar ce ai decis tu.
3 din 5 · Prezice răspunsul
Trimiți un titlu de 2 litere și 15 locuri, dar fără dată. Câte intrări are errors?
Răspuns: 2, Data și Titlu.
Validarea verifică toate câmpurile și raportează toate erorile, nu se oprește la prima. Cele 15 locuri respectă [Range(1, 500)].
4 din 5 · Alege varianta
Ce adaugă CreatedAtAction(nameof(Unul), new { id = e.Id }, dto) față de un simplu Ok(dto)?
Răspuns: codul 201 și antetul Location.
Adresa nu e scrisă de mână: dacă schimbi ruta lui Unul, Location se schimbă odată cu ea. Salvarea o face SaveChangesAsync, înainte.
5 din 5 · Prezice răspunsul
Ce adresă are antetul Location după crearea atelierului cu Id 7?
Răspuns: http://localhost:5207/api/evenimente/7.
CreatedAtAction construiește o adresă completă, cu prefixul controllerului și șablonul {id:int} al metodei Unul. Numele metodei nu apare în adresă.
Pasul 5 din 5
Ce ai învățat
Un controller grupează rutele unei resurse. [Route] și [HttpGet], [HttpPost] compun adresele.
DTO-urile despart mesajele de tabele. Select în DTO cere din MySQL doar ce trimiți.
Atributele de validare plus [ApiController] dau 400 cu toate erorile, înainte de codul tău.
Pentru tipurile valoare, [Required] merge doar cu varianta nullable, ca DateTime?.
Ce ai acum în proiect
Trei fișiere noi sau schimbate, toate în pasul 3: Dto.cs, Controllers/EvenimenteController.cs și Program.cs. Modele.cs, AppDbContext.cs și migrația rămân din prima parte: modelul nu s-a schimbat, deci nu e nevoie de o migrație nouă. Lista de ateliere arată acum așa:
curl http://localhost:5207/api/evenimente/4
{"id":4,"titlu":"Atelier de fotografie","data":"2026-12-12T10:00:00","locuri":15,"inscrisi":0}