C# / ASP.NET Core

Convenzioni, pattern e riferimenti tecnici per lo sviluppo con C# e ASP.NET Core.

Contenuto

1. Switch expression e pattern matching — switch expression, pattern matching, when guard
2. Rate limiting — Microsoft.AspNetCore.RateLimiting, policy, sliding window
3. Feature flag — Microsoft.FeatureManagement, flag condizionali, targeting
4. Logging — ILogger<T>, Serilog, sink, log strutturati
5. Osservabilità — OpenTelemetry, trace, metriche, health checks
6. Configurazione tipizzata — IOptions<T>, IOptionsMonitor<T>, validazione
7. Code native .NET — Queue<T>, ConcurrentQueue<T>, Channel<T>
8. Librerie per code e job — Hangfire, Quartz.NET
9. Middleware custom — pipeline, RequestDelegate, gestione errori globale
10. Action filter — IActionFilter, IAsyncActionFilter
11. Authorization filter — IAuthorizationFilter, API key, tenant
12. Exception filter — IExceptionFilter, IAsyncExceptionFilter
13. Problem Details (RFC 9457) — errori strutturati, ProblemDetails, ValidationProblemDetails
14. Async / Await — throughput nelle Web API, CancellationToken, anti-pattern
15. Dependency Injection — lifetimes, captive dependency, keyed services
16. HttpClient / IHttpClientFactory — typed client, DelegatingHandler, socket exhaustion
17. Validazione — DataAnnotations, FluentValidation, ValidationProblemDetails
18. Background services — BackgroundService, worker pattern, graceful shutdown
19. Caching — IMemoryCache, IDistributedCache, output caching
20. Resilienza — retry, circuit breaker, timeout con Microsoft.Extensions.Http.Resilience
21. Records e immutabilità — record, with expression, DTO e value object

Struttura della Solution

• Struttura fisica — filesystem, .sln, .csproj, naming assembly e namespace
• Dipendenze tra progetti — Core, Db, Api, Tests e direzione delle dipendenze
• Organizzazione di Core — Screaming Architecture, dominio vs tipo tecnico
• UseCases — livello intermedio, comandi completi, SaveChanges, Result pattern
• Convenzioni — naming esplicito, un file per classe, record, interfacce, Program.cs
• Progetti di integrazione — client HTTP/SOAP, librerie esterne, confinamento delle dipendenze
• Models — DTO, enum di dominio, Result<T>, tipi condivisi tra progetti

Entity Framework

• Code First — Setup e migration — DbContext, registrazione, Fluent API, migration CLI
• IQueryable vs List — esecuzione differita, N+1, AsNoTracking
• LINQ con Entity Framework — proiezioni, paginazione, Include, SQL grezzo

Test unitari

• A cosa servono — logica pura, monitoraggio librerie di terze parti, verifica di comportamenti puntuali

Test di integrazione

• Pattern: template e scope — classe base NUnit, clone da template, scope DI per test
• Scrivere un test — Get<T>(), SeedAsync, FluentAssertions, parallelismo
• Testcontainers — PostgreSQL in Docker, nessuna dipendenza locale