Developing Hypermedia APIs With Spring

Slides of the talk I gave at DevDay Dresden.

@springcentral

Transcript

1. © 2014 SpringOne 2GX. All rights reserved. Do not distribute without permission. HYPERMEDIA APIS WITH SPRING DEVELOPING @OLIVERGIERKE / #DEVDAYDD ƻ OGIERKE@PIVOTAL.IO
2. THE FASTEST PATH TO NEW BUSINESS VALUE ?
3. Spring Framework
6. REST
7. JAX-RS + JSON?
8. No.
9. Spring MVC + JSON?
10. Sorry, no.
11. HTTP + JSON?
12. Well, no.
13. HTTP + XML?
14. No.
15. Aaaargh!
16. Architectural style
17. Architectural style A certain set of system characteristics you get
 from adhering to a set of constraints
18. Architectural style A certain set of system characteristics you get
 from adhering to a set of constraints
19. Architectural style A certain set of system characteristics you get
 from adhering to a set of constraints
20. Hypermedia
21. "HATEOAS – 
 the word, there's no pronunciation for. – Ben Hale @ SpringOne2GX 2012
22. " What needs to be done to make the REST architectural style clear on the notion that hypertext is a constraint? In other words, if the engine of application state (and hence the API) is not being driven by hypertext, then it cannot be RESTful and cannot be a REST API. Period. Is there some broken manual somewhere that needs to be fixed? – Roy Fielding
23. Hypermedia HYPERMEDIA?
24. Hypermedia Presentation of data and navigation controls at the same time
26. DEMO Spring HATEOAS Resource, Link & LinkBuilder
28. payment expected preparing cancelled ready completed 1 2 3 4 5 6 RESTBucks
29. Method URI Action Step POST /orders Create new order 1 POST/PATCH /orders/{id} Update the order (only if "payment expected") 2 DELETE /orders/{id} Cancel order (only if "payment expected") 3 PUT /orders/{id}/payment Pay order (only if "payment expected") 4 Barista preparing the order GET /orders/{id} Poll order state 5 GET /orders/{id}/receipt Access receipt DELETE /orders/{id}/receipt Conclude the order process 6
30. Method Resource type Action Step POST orders Create new order 1 POST/PATCH update Update the order 2 DELETE cancel Cancel order 3 PUT payment Pay order 4 Barista preparing the order GET order Poll order state 5 GET receipt Access receipt DELETE receipt Conclude the order process 6
31. Spring RESTBucks Sample implementation Using Spring technologies http://bit.ly/spring-restbucks
32. Web Service Repository - Orders Spring Data Spring Data
 REST Payment Spring Data Manual
 implementation Manual
 implementation
33. DEMO Spring RESTBucks Hypermedia in action
34. Resources
35. Resources • Mike Amundsen – 
 REST, Hypermedia and the Semantic Gap - Talk recording • Spring RESTBucks - Github repository • Spring RESTDocs - Github repository • Andy Wilkinson – Documenting RESTful APIs - Webinar recording
36. / OLIVERGIERKE ƻ OGIERKE@PIVOTAL.IO WWW.OLIVERGIERKE.DE Thanks!