...
← Curs ASP.NET Core: toate lecțiile
Lecția 3 · Introducere

Structura fișierului Program.cs

Orice aplicație ASP.NET Core pornește din Program.cs. Fișierul are o structură fixă, în două etape: întâi configurezi aplicația cu builder, apoi definești ce face ea cu app. Dacă înțelegi ordinea asta, vei ști mereu unde să pui fiecare linie de cod pe care o vei învăța în curs.

Cele două etape: builder și app

Privește din nou cel mai mic server și observă linia goală dintre etape:

var builder = WebApplication.CreateBuilder(args);
// etapa 1: configurezi serviciile (mai târziu: baza de date, autentificarea, logurile)

var app = builder.Build();
// etapa 2: definești pipeline-ul și rutele
app.MapGet("/", () => "Salut!");

app.Run();
EtapaObiectulCe faci aiciExemple din curs
1. înainte de Build()builderspui de ce are nevoie aplicația (servicii, configurare)builder.Services.AddScoped<...>(), builder.Configuration
2. după Build()appspui cum răspunde aplicația la cereriapp.MapGet(...), app.Use(...)
3. la finalapp.Run()pornești serverulo singură linie

O comparație utilă: builder este faza în care construiești restaurantul (cumperi ustensile, angajezi bucătari), iar app este faza în care scrii meniul (ce preparate servești la fiecare comandă). Build() este momentul în care restaurantul e gata, iar Run() deschide ușa pentru clienți.

De ce contează ordinea

După builder.Build(), lista de servicii este „înghețată”: nu mai poți adăuga servicii noi. De aceea toate liniile builder.Services... vin înainte de Build(). Vei folosi intens regula asta în modulul despre dependency injection.

Ce face app.Run()

app.Run() pornește serverul web și blochează programul: linia nu se termină cât timp serverul rulează. Pe calculatorul tău, serverul stă pornit până apeși Ctrl+C în terminal.

De aici două consecințe practice:

  • tot ce scrii înainte de app.Run() se execută o singură dată, la pornire;
  • codul din funcțiile endpoint-urilor (lambda-urile din MapGet) se execută la fiecare cerere, nu la pornire;
  • dacă uiți app.Run(), programul ajunge la final și se oprește: serverul nu pornește deloc și nicio cerere nu primește răspuns.

Mesaje la pornire cu Console.WriteLine

Poți scrie în consolă înainte de app.Run(), ca să știi că aplicația a ajuns în acel punct. Atenție la ordinea în care apar mesajele:

var builder = WebApplication.CreateBuilder(args);
Console.WriteLine("1. Configurez aplicația");

var app = builder.Build();
Console.WriteLine("2. Aplicația este construită");

app.MapGet("/", () =>
{
    Console.WriteLine("Am primit o cerere");
    return "Salut!";
});

Console.WriteLine("3. Pornesc serverul");
app.Run();

// GET /
// GET /
1. Configurez aplicația
2. Aplicația este construită
3. Pornesc serverul
Am primit o cerere
GET / → 200 OK
Salut!
Am primit o cerere
GET / → 200 OK
Salut!
1
Cele trei mesaje numerotate apar o singură dată, la pornire, în ordinea din fișier.
2
Apoi vin cererile: pentru fiecare GET / rulează lambda-ul endpoint-ului, care scrie „Am primit o cerere” și apoi întoarce textul.
3
Mesajul din lambda apare de două ori, pentru că laboratorul a trimis două cereri.

În aplicațiile reale nu vei folosi Console.WriteLine pentru asta, ci loguri (ILogger), pe care le înveți mai târziu. Pentru început, Console.WriteLine este suficient ca să vezi ce se întâmplă.

Top-level statements și usings implicite

Dacă vii din cursul de C#, poate te întrebi unde sunt class Program și static void Main. Program.cs folosește top-level statements: compilatorul pune singur codul tău într-o metodă Main generată automat. Cele două variante de mai jos fac același lucru:

// varianta veche, cu Main scris de mână
public class Program
{
    public static void Main(string[] args)
    {
        var builder = WebApplication.CreateBuilder(args);
        var app = builder.Build();
        app.MapGet("/", () => "Salut!");
        app.Run();
    }
}

De unde vine args? Este parametrul metodei Main generate: argumentele din linia de comandă. De aceea îl poți folosi direct în CreateBuilder(args).

Și de ce nu scrii using Microsoft.AspNetCore.Builder;? Un proiect creat cu dotnet new web are usings implicite (implicit usings): System, System.Linq, System.Collections.Generic, Microsoft.AspNetCore.Builder, Microsoft.AspNetCore.Http, Microsoft.Extensions.DependencyInjection și altele sunt adăugate automat de SDK. Laboratorul face la fel. Pentru alte namespace-uri (de exemplu Microsoft.AspNetCore.Mvc) vei scrie using la începutul fișierului.

Regula de aur a fișierului

Instrucțiunile de sus (top-level statements) trebuie să fie primele în fișier. Clasele și record-urile tale vin după app.Run();. Vei vedea asta în lecția despre record-uri.

Greșeli frecvente

  • **Uiți app.Run()**: programul se termină fără eroare, dar serverul nu pornește. În laborator nu vei vedea niciun răspuns la cereri.
  • **Adaugi servicii după Build()**: builder.Services.Add... după var app = builder.Build(); aruncă o excepție, pentru că lista de servicii nu mai poate fi modificată.
  • **Pui rute după app.Run()**: Run blochează, deci liniile de după el nu se execută înainte ca serverul să pornească.
  • Crezi că lambda-ul rulează la pornire: funcția din MapGet doar se înregistrează la pornire; rulează abia când vine o cerere.

Pe scurt

LinieRol
var builder = WebApplication.CreateBuilder(args);pregătește configurarea și serviciile
builder.Services...înregistrezi servicii (mai târziu în curs)
var app = builder.Build();construiește aplicația
app.MapGet(...)definești rutele (endpoint-urile)
app.Run();pornește serverul, la final
clase, record-uridupă app.Run();
Exercițiul tău

Pregătește serverul magazinului Ana. La pornire, înainte de app.Run(), scrie în consolă exact Serverul pornește.... Apoi adaugă endpoint-ul GET /despre, care răspunde cu textul Magazinul Ana, din 2020. Laboratorul trimite cererea GET /despre.

  • Scrie Serverul pornește... cu Console.WriteLine, înainte de app.Run();.
  • Adaugă endpoint-ul GET /despre care întoarce Magazinul Ana, din 2020.
  • Păstrează app.Run(); ca ultimă instrucțiune.
Mesajul de pornire se scrie o singură dată, deci nu îl pune în lambda-ul endpoint-ului, ci direct înainte de app.Run();.

Soluția exercițiului

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/despre", () => "Magazinul Ana, din 2020");

Console.WriteLine("Serverul pornește...");
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 3 · Structura fișierului Program.cs
Progres 0% 0 din 22
Lecția curentă 3 / 20 Introducere