"From CRUD to Hypermedia APIs with Spring" Владимир Цукур
1 like1,060 views
The document discusses transitioning from CRUD-style APIs to hypermedia APIs using Spring, emphasizing the importance of integrating business processes with API functionality. It outlines specific tasks and methods for publishing, updating, and expiring ads and highlights tools like Spring Data REST and Spring HATEOAS. The presentation also touches on testing, documentation, and security considerations for APIs.
![28
Siren Actions
"actions": [
{
"name": "create-ad",
"method": "POST",
"href": "/ads",
"type": "application/json",
"fields": [
{ "name": "type", "type": "radio" },
{ "name": "quantity", "type": "number" },
{ "name": "currency", "type": "radio" },
…
]
}
]](https://image.slidesharecdn.com/2-tsukur-160227220524/85/From-CRUD-to-Hypermedia-APIs-with-Spring-28-320.jpg)
"From CRUD to Hypermedia APIs with Spring" Владимир Цукур
- 1. From CRUD to Hypermedia APIs with Spring Volodymyr Tsukur, GlobalLogic
- 2. REST 2 Vladimir Tsukur partner @ engineer @ engineer / architect @ flushdia vtsukur
- 3. 3 Web API? Why Should I Care?
- 6. 6 finance.i.ua - Ad Creation
- 7. 7
- 8. 8 Spring Boot Tools Spring Data Spring Data REST
- 10. 10 CRUD Style API Method URL Task POST /ads Create ad GET /ads View ads GET /ads/{id} Get ad PATCH /ads/{id} Update ad DELETE /ads/{id} Delete ad
- 12. 12 if (status == Status.NEW) { publishedAt = LocalDateTime.now(); status = Status.PUBLISHED; } … CRUD is NOT enough if (status == Status.NEW) { publishedAt = LocalDateTime.now(); status = Status.PUBLISHED; } …
- 13. 13 API Changes Method URL Task POST /ads/{id}/publishing Publish ad POST /ads/{id}/expiration Expire ad GET /ads/search/published Get published ads
- 14. CODING TIME !
- 16. 16
- 17. 17 URI Binding & Construction Task Method URL Update ad PATCH /ads/{id} Delete ad DELETE /ads/{id} Publish ad POST /ads/{id}/ publishing Expire ad POST /ads/{id}/ expiration
- 18. 18 "Figuring" Out the Flow Task Method URL Update ad (only if NEW) PATCH /ads/{id} Delete ad (only if NEW) DELETE /ads/{id} Publish ad (only if NEW) POST /ads/{id}/ publishing Expire ad (only if PUBLISHED) POST /ads/{id}/ expiration
- 19. Должно работать на моем iPhone 6s!
- 20. 20
- 21. 21 Hypermedia = { "amount": 3000, "currency": "USD", … } data { … "_links": { "publishing": { "href": "/ads/1/publishing" }, "update": { "href": "/ads/1" }, "deletion": { "href": "/ads/1" }, … } } links +
- 22. 22 Hypermedia API Link Relation Task Method update Update ad PATCH deletion Delete ad DELETE publishing Publish ad POST expiration Expire ad POST
- 24. CODING TIME !
- 25. 25 HAL = Hypertext Application Language
- 27. 27
- 28. 28 Siren Actions "actions": [ { "name": "create-ad", "method": "POST", "href": "/ads", "type": "application/json", "fields": [ { "name": "type", "type": "radio" }, { "name": "quantity", "type": "number" }, { "name": "currency", "type": "radio" }, … ] } ]
- 29. Хочу какой-нить удобный браузер для HAL … и быстро!!
- 30. SHOW TIME !
- 32. 32
- 34. 34 Outcomes - 1. Spring Data REST - simple, CRUD- y and HATEOAS-y; extensible PRO TIP: won't solve everything 2. Spring MVC - always there to help 3. Link stuff with Spring HATEOAS 4. Spring Security to the rescue when you need to protect API 5. Document with Spring REST Docs