Torniamo a parlare di Attribute Routing, la nuova opportunità per definire regole di routing con applicazioni ASP.NET MVC 5 e WebAPI 2. In un nostro precedente script (https://www.aspitalia.com/script/1145/Scrivere-Route-REST-Attribute-Routing-ASP.NET-MVC-ASP.NET-Web.aspx) abbiamo introdotto l'uso puntuale degli attributi RoutePrefix e Route sulle nostre action, come strumento per progettare URL che seguano un preciso ordine gerarchico.
Ma è importante valutare l'Attribute Routing anche dal punto di vista prestazionale e della sensibilità al contesto. Vediamo subito l'esempio di una ipotetica action che consenta la ricerca di clienti per partita IVA.
[RoutePrefix("api/clienti/")] public class ClientiController : ApiController { [HttpGet, Route("{partitaIva}")] public Cliente TrovaClientePerPartitaIva(string partitaIva) { ... } }
Con la regola di routing che abbiamo appena definito, ogni richiesta rivolta a /api/clienti/{partitaIva} verrà affidata all'action TrovaClientePerPartitaIva. Questo non è sempre desiderabile per una questione di efficienza: infatti la nostra action andrebbe in esecuzione anche se l'utente fornisse valori non numerici, o comunque sintatticamente non validi per una partita IVA.
Come rimedio, l'Attribute Routing ci consente di definire dei route constraints per ciascun parametro, ovvero dei vincoli di conformità del dato che vengono valutati prima ancora che l'action venga scelta ed eseguita.
Un route constraint va posto immediatamente dopo il nome del parametro a cui si riferisce, con un carattere ":" di separazione. Nel nostro caso, possiamo aggiungere una combinazione di due route constraint al parametro {partitaIva}.
[RoutePrefix("api/clienti/")] public class ClientiController : ApiController { [HttpGet, Route("{partitaIva:length(11):long}")] public Cliente TrovaClientePerPartitaIva(string partitaIva) { ... } }
In questo modo imponiamo che la partita iva sia una stringa di 11 caratteri di lunghezza e che sia anche interpretabile come numero intero poiché composta da sole cifre.
ASP.NET Web API 2 asseconda le esigenze più comuni offrendo un nutrito insieme di vincoli:
- Sul tipo, che impongono la convertibilità del valore verso determinati tipi CLR come: int, long, decimal, float, bool, datetime e guid;
- Sui caratteri consentiti, come alpha, che impone la presenza delle sole lettere dalla A alla Z o regex per sfruttare le regular expression;
- Sulla dimensione, come min, max e range per indicare gli estremi di valori numerici o minlength, maxlength e length che invece riguardano le stringhe e la loro lunghezza.
Tuttavia, ciò potrebbe non essere sufficiente ad operare un controllo formale completo sul valore inviato dall'utente. In un prossimo script vedremo come creare un nostro validatore personalizzato.
Commenti
Per inserire un commento, devi avere un account.
Fai il login e torna a questa pagina, oppure registrati alla nostra community.
Approfondimenti
Implementare il throttling in ASP.NET Core
Creare un'applicazione React e configurare Tailwind CSS
Usare le collection expression per inizializzare una lista di oggetti in C#
Creazione di plugin per Tailwind CSS: espandere le funzionalità del framework dinamicamente
Applicare il versioning ai nostri endpoint ASP.NET Core Minimal API
Copiare automaticamente le secret tra più repository di GitHub
Usare il versioning con i controller di ASP.NET Core Web API
Recuperare un elemento inserito nella cache del browser tramite API JavaScript
Installare le Web App site extension tramite una pipeline di Azure DevOps
Utilizzare la libreria Benchmark.NET per misurare le performance
Accesso sicuro ai secrets attraverso i file in Azure Container Apps
Definire stili a livello di libreria in Angular