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();| Etapa | Obiectul | Ce faci aici | Exemple din curs |
|---|---|---|---|
| 1. înainte de Build() | builder | spui de ce are nevoie aplicația (servicii, configurare) | builder.Services.AddScoped<...>(), builder.Configuration |
| 2. după Build() | app | spui cum răspunde aplicația la cereri | app.MapGet(...), app.Use(...) |
| 3. la final | app.Run() | pornești serverul | o 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.
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!
Î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.
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
| Linie | Rol |
|---|---|
| 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-uri | după app.Run(); |
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.
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(); 