Presentation of talk "ASP.NET Web API 2" - Event "Visual Studio 2013 - A New kind In Town" organized by DomusDotNet, Microsoft Rome, Italy.

1. ASP.NET Web API 2
Pietro Libro
http://blogs.ugidotnet.org/PietroLibroBlog
pietro.libro@domusdotnet.org
http://www.linkedin.com/in/pietrolibro

2. Agenda
• Web API:
–
REST in pillole
• Web API 2, novità:
– Attribute Routing
– Batch Requests
– IHttpActionResult
– Cross-Origin Requests (CORS)
– External Authentication Services
– Nuove features per OData

3. REST in “Pillole”
– Architettura software per sistemi di ipertesto distribuiti come il WWW
– Principi che delineano come le risorse sono definite ed indirizzate
– Risorsa
•
Univocamente indirizzabile tramite URI
•
Stato dell’applicazione e funzionalità
– Protocollo:
•
Client-Server
•
Stateless
•
Cachable
•
A livelli
– HTTPHTTPS

4. Web API 2: Attribute Routing
• Routing: Match tra URI ed azioni
• (V1) Routing basato su convenzioni
– Difficile (non impossibile ) mappare URI del tipo Cliente/1/Ordini
• NEW! Routing basato su attributi
– URI User Friendly che descrivono risorse eo gerarchie di risorse
– Api Versioning
•
APIV1Clienti
•
APIV2Clienti

5. Web API 2: Attribute Routing
• NEW! Routing basato su attributi
– Overloaded URI segments
•
Ordini/1
•
Ordini/Pending
– Multiple Parameter Types
•
Ordini/1
•
Ordini/29/11/2013
– Routing Constraints

6. Web API 2: Attribute Routing
• «Attivare» Attribute Routing
– MapHttpAttributeRoutes() in WebApiConfig
– Uso dell’attributo Route
– Uso dell’attributo RoutePrefix

7. ASP.NET Web API 2
DEMO
Attribute Routing

8. Web API 2: Batch API
• Feature introdotta con Web Api 2
• Web Api «Batch Requests»
– Più richieste Web Api in singola Request HTTP
– Singola Response HTTP con risposta a tutte le richieste Web Api
• Numero di chiamate al Server ridotte (round-trip)
+ Performance
+ Scalabilità
• Requisito
– Registrare una «Rotta» per il Batch Handler

9. ASP.NET Web API 2
DEMO
Batch

10. Web API 2: IHttpActionResult
• Web Api Response
-
Void
-
Specifica istanza di un oggetto
-
Conversione «automatica» a HttpResponseMessage
-
Creazione «manuale» di un’istanza di HttpResponseMessage
-
NEW! IHttpActionResult
-
Singolo metodo da implementare
-
La sua implementazione fornisce le «istruzioni» di come la Response debba essere
creata, una sorta di HttpResponseMessage «Factory»

11. Web API 2: IHttpActionResult
• IHttpActionResult
– Minore duplicazione del codice
•
-
es: utilizzo stessa implementazione per Controller diversi
Supporto diretto all’HTML con Razor
-
Definizione di «azioni» il cui risultato può essere facilmente «parsato» dal View
Engine di Razor

12. ASP.NET Web API 2
DEMO
IHttpActionResult

13. Web API 2: Cross-Origin Requests
•
Browser Security (Same Origin Policy)
–
Evita che una pagina web possa effettuare richieste Ajax verso un altro dominio
WebService
Web API
http://www.domain1.it
WebClient
Cross-Origin Request
HTML
http://www.domain2.it

14. Web API 2: Cross-Origin Requests
•
CORS
–
Cross Origin Resource Sharing è uno standard W3C che permette di «rilassare» il
vincolo Same Origin Policy
•
–
Alcune Cross-Origin Request sono accettate, altre sono rifiutate
NEW! Supporto CORS in ASP.NET Web Api 2 (Package NuGet)
•
Abilitazione per Action
•
Abilitazione per Controller
•
Abilitazione a livello Globale
WebService
Web API
http://www.domain1.it
WebClient
Cross-Origin Request
HTML
http://www.domain2.it

15. ASP.NET Web API 2
DEMO
Cross-Origin Requests (CORS)

16. Web API 2: External Authentication
•
NEW! External Authentication Services (OAuthOpenIDSocial Media)
–
–
Twitter
–
Facebook
–
•
Microsoft (Windows Live ID Account)
Google
Riduzione tempi di sviluppo nuove applicazioni
–
Perché re-inventare la ruota ogni volta ?
–
Gli utenti non devono creare l’ennesimo account

17. Web API 2: External Authentication

18. Web API 2: External Authentication

19. Web API 2: External Authentication
•
Toolbox
–
Visual Studio 2013
–
Google User Account
–
Developer Account
•
Microsoft Live ID, http://go.microsoft.com/fwlink/?LinkID=144070
•
Twitter, https://dev.twitter.com/
•
Facebook, https://developers.facebook.com/

20. ASP.NET Web API 2
DEMO
External Authentication

21. Web API 2: OData
•
Aggiunte le opzioni $expand, $select e $value
–
$expand, permette di ottenere nella stessa Response i dati di entità collegate
–
$select, permette di includere in una Response un sottoinsieme di valori di una o piu’
proprietà di una specifica entità
–
$value, permette di ottenere il valore Raw di una specifica proprietà di un’entità

22. Web API 2: OData
•
Requirements dei controllers per supportare $select e $expand
– Per azioni che restituiscono collezioni
•
IQueryable
– Per azioni che restituiscono singole entità
•
SingleResult<T>, dove «T» è IQueryable (card. 0..1)
– Decorare il metodo con [Queryable]
Oppure
– EnableQuerySupport in HttpConfiguration

23. ASP.NET Web API 2
DEMO
OData

24. Riferimenti
• Visual Studio 2013
– http://www.asp.net/vnext
• ASP.NET Web API 2
– http://www.asp.net/vnext/overview/aspnet-web-api
• OWIN & Katana
– http://www.asp.net/vnext/overview/owin-and-katana

25. Grazie agli sponsor

26. Per voi sono solo 10 minuti persi,
per noi è utilissimo per poter
crescere e migliorare!