REST & .NET

1. REST & .NET James Crisp .NET Practice Lead ThoughtWorks Australia

2. James Crisp

4. The Web

5. *-ilities

6. Scalability

7. Recoverability & Reliability

8. Security

9. Discoverability

11. How to bring to Web services?

12. Tunneling RPC URLs POX SOAP & WS-*

13. REpresentational State Transfer

15. “REST contributes ... the rationale behind the modern Web's software architecture...” -- Roy Fielding

16. Resources e.g. Person, Car, Post

17. Representations <person> <name>Bill Gates</name> <gender>m</gender> </person>

19. Addressability http://mysite.com/people/joe_citizen http://mysite.com/people/joe_citizen/friends

20. Uniform Interface

21. GET POST HEAD PUT DELETE OPTIONS Support

22. GET GET /people/joe_citizen HTTP/1.1 Host: mysite.com Accept: application/xml

23. Response 200 OK Content-Type: application/xml Last-Modified: 2008-1-1 15:00.. <person> <name>Joe Citizen</name> <age>42</age> <gender>m</gender> </person>

24. HEAD HEAD /people/joe_citizen HTTP/1.1 Host: mysite.com 200 OK Content-Type: application/xml Last-Modified: 2008-1-1 15:00.. ETag: a32daf15-b33da2a4d Response

25. POST POST /people HTTP/1.1 Content-Type: text/xml Host: mysite.com .... <person> <name>Tina Jones</name> <age>25</age> <gender>F</gender> </person>

26. Response 201 CREATED Location: /people/tina_jones (optionally with body)

27. PUT PUT /people/tina_jones HTTP/1.1 Content-Type: text/xml Host: mysite.com .... <person> <name>Tina Jones</name> <age>24</age> <gender>F</gender> </person>

28. Response 200 OK Location: /people/tina_jones (optionally with body)

29. DELETE DELETE /people/joe_citizen HTTP/1.1 Host: mysite.com 200 OK Content-Type: application/xml <admin:personDeleted> joe_citizen </admin:personDeleted> Response

30. OPTIONS OPTIONS /people HTTP/1.1 Host: mysite.com Response 200 OK Allowed: GET,HEAD,POST

31. Status Codes

32. 2xx = All good 200 – OK 201 – Created

33. 3xx = Redirect 301 – Moved permanently 307 – Temporary redirect304 – Not modified (ie, see cache)

34. 4xx = Client error 400 – Bad request 401 – Unauthorized 403 – Forbidden 405 – Method not allowed 409 – Conflict

35. 5xx = Server error 500 – Internal server error

36. Headers

37. Content-Type: text/html application/xml image/jpeg ....

38. WWW-Authenticate: Authorization:

39. Last-Modified: If-Modified-Since: ETag: If-None-Match:

40. Location:

41. Describe your services?

42. URI Templates http://s3.amazon.com/{bucket-name}/{object-name} http://mysite.com/users/{user-name}/photos http://google.com/search?q={search-query}

43. Start URL + Links https://bank.com/accounts/345095 <account> <name>Tina Jones</name> <link rel="history" href="/tjones/account_history"> <link rel="close" verb="delete" href="/tjones"> </account>

44. Microformats <account> <name>Tina Jones</name> <link rel="transaction-search" href="account_history? from={date-from}& to={date-to}"> </account>

45. State Management http://google.com Searching Search google.com/search?q=rest Searched Next Page google.com/search?q=rest&start=10 More Results

46. Data Format?

47. XHTML <h1>Accounts</h1> <ul> <li> <a rel="account_details" href="/tjones">Tina Jones</a> </li> <li> .....

48. JSON { "account_name": "Tina Jones", "links": {"history": "/tjones/history"} }

49. <XML></XML>

50. Framework