Negli script precedenti abbiamo introdotto alcune novità di ASP.NET Core 2.1 relative a Web API e, in particolare, abbiamo accennato all'esistenza di una nuova classe ActionResult<T>.
Grazie a quest'ultima, possiamo finalmente realizzare action Web API fortemente tipizzate, senza rinunciare alla flessibilità di controllare l'effettivo contenuto della risposta.
Sin dalla sua introduzione, infatti, Web API supporta la restituzione di tipi nativi:
public Person GetById(int id) { return new Person>(); }
Tuttavia, il metodo precedente non consente di restituire risposte differenti da un'istanza di Person; nel caso in cui la Person richiesta non esiste, per esempio, vorremo poter restituire un errore 404.
Fino alla precedente versione di ASP.NET Core, l'unica alternativa era usare IActionResult come tipo della risposta:
public IActionResult GetById(int id) { Person result = personService.GetById(id); if (result == null) { return this.NotFound(); } return this.Ok(result); }
Questo approccio ovviamente soffre di un problema di tipizzazione: il metodo Ok, infatti, accetta un qualsiasi tipo in input, e pertanto perdiamo il controllo a compile time sulla correttezza del risultato.
Con ASP.NET Core 2.1, abbiamo a disposizione il nuovo tipo ActionResult<T>, che ci permette di riscrivere il metodo precedente in questo modo, forzando una validazione del tipo del risultato:
public ActionResult<Person> GetById(int id) { Person result = personService.GetById(id); if (result == null) { return this.NotFound(); } // ogni tipo diverso da Person genera un errore di compilazione return result; }
Come è possibile che il metodo in alto compili, visto che stiamo restituendo un oggetto di tipo Person invece che ActionResult
public sealed class ActionResult<TValue> : IConvertToActionResult { // ... altro codice qui ... public static implicit operator ActionResult<TValue>(TValue value); public static implicit operator ActionResult<TValue>(ActionResult result); }
Come possiamo notare, essa ridefinisce due implicit conversion operator:
- il primo, è proprio quello che ci consente di restituire un oggetto di tipo Person anche se la action si aspetta un ActionResult
- Il secondo, invece, ci permette di ritornare anche un qualsiasi altro ActionResult, se necessario, come NotFoundResult o BadRequestResult.
Commenti
Per inserire un commento, devi avere un account.
Fai il login e torna a questa pagina, oppure registrati alla nostra community.
Approfondimenti
.NET 7 Live Q&A
Applicare il versioning ai nostri endpoint ASP.NET Core Minimal API
Utilizzare l'API del browser fetch
Personalizzare le richieste con i rule set di Azure Front Door
Specificare il versioning nel path degli URL in ASP.NET Web API
Utilizzare HiLo per ottimizzare le insert in un database con Entity Framework
Collegare servizi a Azure Container App con i service connector
Usare Azure Application Gateway come reverse proxy per ASP.NET Core
Migrare un progetto ASP.NET Core da .NET 6 a .NET 7
Creare automaticamente una issue di GitHub
Effettuare il pull di git LFS in un workflow di GitHub
Monitorare e prevenire problemi in produzione
I più letti di oggi
- Action tipizzate in un controller Web API di ASP.NET Core 2.1
- ASP.NET 4.0 in C# e VB - Espresso
- Orchard CMS: dove cresce ASP.NET MVC - Prima parte
- Windows 8 Consumer Preview: segui con noi la diretta
- Le differenze di VS 2005 Express, Professional e Team System
- Real Code Conference 4: ASP.NET 4.0: dal runtime alle WebForm