RESTful Services ‘a la carte ’

2. RESTfulServices ‘a la carte’ Gustavo Javier Machado Arquitecto Tellago Inc. gustavo.machado@tellago.com http://thegsharp.wordpress.com

3. Agenda • REST • REST & Microsoft • WCF WebHttp • WCF DataServices • MVC 2 • Cuandousarque?

4. REST

5. ¿Porque REST? • Representational StateTransfer. • Estilo de arquitectura. • Mejor usode HTTP. • Menor complejidad. • Mayor interoperabilidad. ¿Que significa? ¿Que es? ¿Por qué rest?

6. REST - Principios • Identificar recursos con Uris • Utilizar verbos de http • Conectar recursos utilizando links • Presentar en multiples formatos (XML,json,etc) • Comunicación stateless

7. REST – Principio 1 “Los recursos son identificadosmediante Uris” Ejemplos: http://miservicio/Salas Podria ser la Uri paraacceder a la lista de salas de un edificio. http://miservicio/Salas/3 Podria ser la Uri paraacceder a la representacion de la Salanumero 3. http://miservicio/Colores/rojo Podria ser la Uri paraacceder al color rojo. http://miservicio/Transaccion/1145001 En un serviciounatransaccionpuede ser considerada un recurso. En este caso estamos referenciando a la transaccion 1145001.

8. REST – Principio 2 “Utilizar verbos de HTTP” • GET: Retorna la representacion del recurso. • PUT: Actualiza el estado de un recurso. • POST: Crea un nuevorecurso. • DELETE: Borra un recurso.

9. REST – Principio 3 “Conectar recursos utilizando links” <order self=’http://example.com/orders/1234’> <amount>23</amount> <product ref=’http://example.com/products/4554’ /> <customer ref=’http://example.com/customers/1234’ /> </order>

10. REST – Principio 4 “Presentar en multiples formatos” GET /accounts('UBS') Host: restsamples.com Accept: application/atom+xml … GET /accounts('UBS') Host: restsamples.com Accept: application/json …

11. REST – Principio 5 “Comunicacion stateless” GET /accounts('ubs') Host: restsamples.com Accept: application/account+xml <account><contact ref="/contacts('ubs-12345')">...</contact></account> … GET /contacts('ubs-12345') Host: restsamples.com Accept: application/contact+xml <contact id="ubs-12345">...</contact>

12. RESTfulness SOAPers vs RESTafaris RESTafaris

13. Microsoft & REST

14. Microsoft y REST

15. Microsoft y REST WCF WebHttp Public class Service: IContract { [WebGet] Type Operation1(parameters….); . . . [WebInvoke] Type Operationn(parameters….); } XML JSON Atom

16. Microsoft y REST WCF DataServicesnosdioOData Public class MyContext : IUpdatable { IQueryable<T1> field1; . . . IQueryable<Tn> fieldn; } ODATA AtomP JSON

17. Microsoft y REST Y no nosolvidemos de ASP .NET MVC Public class Service : Controller { ActionResult Action1(parameters…); . . . ActionResultActionn(parameters…); XML JSON Atom

18. WCF WebHttp

19. WCF Webhttp • Programming Model de WCF quenosbrinda mayor control sobre Uri, formatos y protocolos a la hora de desarrollarservicios HTTP quepueden ser REST o no.

20. WCF Webhttp En .NET 3.5 • Podemosencontrarlasclases en System.ServiceModel.Web. • Para desarrollarclientes de servicios REST podemosrecurrir al WCF REST Starter Kit. • Debemosbajar el WCF REST Starter kit (CODEPLEX). • UtilizamosMicrosoft.Http y Microsoft.Http.Extensions. En .NET 4.0

21. Hello world! El request… (GET) http://miservicio/Greetings/Gustavo El response <string xmlns="http://schemas.microsoft.com/2003/10/Serialization/">Hello Gustavo</string>

22. Codigo… • Uri template • Http Verb • Help page • Format • Links • Error codes

23. Preguntas…

24. WCF DataServices

25. WCF Dataservices Si pudiesemosir de nuestrainterfaz a unainterfazmasgenerica… • …Estariamosdefiniendo un protocolo REST propiopara ABMs…

26. WCF Dataservices … y Si pudiesemosexponer un iqueryable<T> … • …Estariamosdefiniendo un protocolo REST propioconsultas...

27. WCF Dataservices Public class MyContext : IUpdatable { IQueryable<T1> field1; . . . IQueryable<Tn> fieldn; } ODATA AtomP JSON

28. WCF Dataservices Public class MyContext : IUpdatable { . }

29. WCF Dataservices Public class MyContext : IUpdatable { IQueryable<T1> field1; . . . IQueryable<Tn> fieldn; } ODATA AtomP JSON

30. Codigo… • Custom Container • EF client/servidor • AccessRules • Service Operations

31. ASP .NET MVC

32. ASP .NET MVC Public class Service : Controller { ActionResult Action1(parameters…); . . . ActionResultActionn(parameters…); XML JSON Atom

33. ASP .NET MVC • Web • Uris • Format

34. Cuando usar cada uno?

35. Participá del DEMOFEST Los mejores proyectos de las células Microsoft, los grupos de investigación de estudiantes, son seleccionados para participar en el espacio del DEMOFEST. ¡Conocélos!

36. Necesitamos tu Feedback! • Completá los FORM de avaluación que estarán en nuestra WEB: www.codecamp.com.ar • Necesitamos de tu feedback para mejorar.

37. © 2008 Microsoft Corporation. Todos los derechosreservados. Microsoft, Windows, Windows Vista y otrosnombres de producto son y pueden ser marcasregistradas y registros en EstadosUnidos y en otrospaíses. La informacióncontenida en el presenteessólopara fines informativos y representa la visión actual de Microsoft Corporation a la fecha de estapresentación. Debido a que Microsoft debe responder a lascambiantescondiciones del mercado, no se debeinterpretarcomo un compromisopor parte de Microsoft, y Microsoft no puedegarantizar la precisión de ningunainformaciónprovistadespués de la fecha de estapresentación. MICROSOFT NO OFRECE GARANTÍA ALGUNA, EXPRESA, IMPLÍCITA O DE LEY, RESPECTO A LA INFORMACIÓN EN ESTA PRESENTACIÓN.