Domain Driven Design & Hypermedia

Slides of the talk on Domain Driven Design & Hypermedia I gave at API Strat, Berlin.

@springcentral

Transcript

1. © 2014 SpringOne 2GX. All rights reserved. Do not distribute without permission. DDD & HYPERMEDIA @olivergierke
2. THE FASTEST PATH TO NEW BUSINESS VALUE ?
3. Spring Framework
5. REST
6. Architectural style A certain set of system characteristics you get
 from adhering to a set of constraints
7. APIs evolve
8. "They released this 1.0 version recently and boy – it was perfect! – No one ever
12. payment expected preparing cancelled ready completed 1 2 3 4 5 6 RESTBucks
13. Hypermedia Documenting
 APIs?
15. "Code generation – so that you can do the wrong thing faster… Kevlin Henney
16. 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 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
17. Hypermedia
18. " 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
19. 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 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
20. 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
21. Domain Driven Design
22. https://www.google.com/?q=Domain+Driven+Design+Quickly
24. Order LineItem Product Invoice Customer Payment Address
25. Bounded Context
26. Shipping Accounting Catalog Orders User
 Registration
27. Shipping Accounting Catalog Orders User
 Registration Accounting Payment information Billing Address Shipping Shipping address Customer Product
28. Identity is key
29. Entities & Aggregate Roots
30. Repositories
31. DEMO
32. Test-Case-Driven
 Documentation
33. Asciidoctor + Spring MVC Test = <3
36. DEMO
37. Resources • Jean-Jacques Dubray – 
 Understanding the cost of versioning an API - Blog • Domain Driven Design Quickly - Ebook • Spring RESTBucks - Github repository • Spring RESTDocs - Github repository • Andy Wilkinson – Documenting RESTful APIs - Webinar recording