Il paradigma REST suggerisce di impostare le route dell'applicazione secondo le regole di resource discovery, dando alla forma dell'URL assegnato a una determinata risorsa un preciso significato semantico.
Una forma basilare di questo concetto si trova proprio nel pattern standard {controller}/{action}/{id} utilizzato nelle route di ASP.NET MVC fin dalle primissime versioni. Esso infatti, nella sua accezione di default, associa:
- all'URL mysite/Customers l'elenco dei customer presente in archivio;
- all'URL mysite/Customers/3 il dettaglio del customer di ID=3.
Immaginiamo però che al customer sia associato anche un elenco di ordini. Qual è l'indirizzo corretto a cui dovremmo associare questa risorsa? Con la sola route di default, l'URL che è più facilmente utilizzabile è qualcosa di simile a mySite/Orders/ByCustomer/5; tuttavia, esso viola il concetto di resource discovery, perchè, a meno del significato letterale delle parole utilizzate, non c'è alcun legame tra la nuova risorsa (gli order) e l'entità a cui appartengono (il customer).
Una soluzione sicuramente più corretta è invece costituita dall'indirizzo mySite/Customers/3/Orders, che esprime chiaramente la gerarchia di appartenenza della lista di ordini. Il problema, però, è che questo URL non è direttamente mappabile sulla route standard. Una soluzione può essere quella di definire una route personalizzata, ma il metodo più comodo è quello di sfruttare AttributeRouting e, in particolare, la funzionalità RoutePrefix.
Tramite essa, possiamo assegnare un prefisso a tutte le route associate a un determinato controller. Nel nostro caso, possiamo scrivere qualcosa di questo tipo:
[RoutePrefix("Customers/{customerId}")] public class OrdersController : Controller { [Route("Orders")] public ActionResult Orders(int customerId) { .. } }
Questa configurazione creerà una route che corrisponde esattamente alla forma che abbiamo ipotizzato. L'aspetto interessante è che possiamo definire delle componenti variabili nel prefisso, a livello di controller, e referenziarle in seguito nelle varie action. Nel nostro caso, abbiamo definito la variabile customerId, che posizionalmente precederà il token Orders, ma che comunque potremo utilizzare nella action relativa.
La stessa tecnica funziona in maniera analoga nel caso di ASP.NET Web API:
[RoutePrefix("Api/Customers/{customerId}")] public class OrdersApiController : ApiController { [Route("Orders")] public string GetOrdersByCustomer(int customerId) { return string.Format("orders for customer {0}", customerId); } }
Affinché tutto funzioni correttamente, è necessario verificare che, nei file RouteConfig.cs e WebApiConfig.cs siano invocati gli extension method necessari per attivare l'attribute routing:
public class RouteConfig { public static void RegisterRoutes(RouteCollection routes) { // ... routes.MapMvcAttributeRoutes(); } } public static class WebApiConfig { public static void Register(HttpConfiguration config) { // ... config.MapHttpAttributeRoutes(); } }
Commenti
Per inserire un commento, devi avere un account.
Fai il login e torna a questa pagina, oppure registrati alla nostra community.
Approfondimenti
Anonimizzare i dati sensibili nei log di Azure Front Door
Gestione CSS in Blazor con .NET 9
Referenziare un @layer più alto in CSS
Migliorare i tempi di risposta di GPT tramite lo streaming endpoint in ASP.NET Core
Sfruttare gli embedding e la ricerca vettoriale con Azure SQL Database
Gestire la cancellazione di una richiesta in streaming da Blazor
Creare una custom property in GitHub
Combinare Container Queries e Media Queries
Configurare e gestire sidecar container in Azure App Service
Utilizzare Container Queries nominali
Utilizzare Azure Cosmos DB con i vettori
Gestione degli eventi nei Web component HTML
I più letti di oggi
- .NET Conference Italia 2024 - Milano
- Develop and distribute Azure Functions using K8s and CI/CD
- Disponibile la versione finale di Hyper-V: la virtualizzazione per Windows Server 2008
- Speciale Mastering Entity Framework
- Velocity arriva alla CTP3
- Silverlight Summer: un'estate speciale piena di Style per i controlli Silverlight!
- Disponibile la versione beta di Silverlight 4.0
- Mono 0.13: ora anche web services
- .NET Alerts Software Development Kit