MyCodeSchool

Pasul 1 din 5

ASP.NET Core

Pasul 1 din 5 · Ce construiești

  • ASP.NET Core
  • Mediu
  • 12 minute

ASP.NET Core: controllere, DTO-uri și validare

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:

al doilea terminal
curl -i -X POST http://localhost:5207/api/evenimente \  -H "Content-Type: application/json" \  -d '{"titlu":"AB","locuri":0}'
răspunsul
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.

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]public async 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);    return CreatedAtAction(nameof(Unul),        new { id = e.Id }, dto);}

Stare

Răspunsuri


      

  1. Linia 1. Sosește POST /api/evenimente. Ruta controllerului plus [HttpPost] se potrivesc, deci a fost aleasă metoda Creeaza.
  2. 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.
  3. Linia 1. A doua cerere, cu titlu, dată și 15 locuri.
  4. Linia 3. Toate regulile sunt respectate, deci metoda primește obiectul nou.
  5. 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.
  6. Linia 11. Entitatea e marcată Added.
  7. Linia 12. INSERT în MySQL. Atelierul primește Id 4.
  8. Linia 13. Răspunsul e tot un DTO, nu entitatea. Un atelier nou are 0 înscriși.
  9. Linia 15. CreatedAtAction dă 201 și construiește adresa din ruta metodei Unul, cu id = 4.
  10. 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.

Controllerul: rutele unei resurse, la un loc

Controllers/EvenimenteController.cs
using Microsoft.AspNetCore.Mvc;using Microsoft.EntityFrameworkCore;[ApiController][Route("api/evenimente")]public class EvenimenteController(AppDbContext db)    : ControllerBase{    [HttpGet]    public async 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}")]    public async 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 is null ? NotFound() : dto;    }    [HttpPost]    public async 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);        return CreatedAtAction(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,        new MySqlServerVersion(            new Version(8, 4))));builder.Services.AddControllers();var app = builder.Build();app.MapControllers();app.Run();

DTO-uri: ce intră și ce iese

Dto.cs
using System.ComponentModel.DataAnnotations;public record EvenimentDto(int Id, string Titlu,    DateTime Data, int Locuri, int Inscrisi);public class EvenimentNou{    [Required]    [StringLength(120, MinimumLength = 3)]    public string Titlu { get; set; } = "";    [Required]    public DateTime? Data { get; set; }    [Range(1, 500)]    public int 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`

Validarea prin atribute

Atribute de validare folosite des
AtributCere
[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

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}

Continuă cu