Apresentação de Sebastian Daschner para o 27º encontro PT.JUG.

1. Putting Hypermedia Back in REST
with JAX-RS
sebastian daschner

2. @DaschnerS
sebastian daschner
● Java developer / architect / consultant
● JAX-RS Expert Group member
● Java Champion
● conference speaker

3. @DaschnerS
workshops / training
● workshops in Munich
● workshops in Oslo / Norway (TBA)
● virtually on demand

4. @DaschnerS
“REST” APIs in real-world projects

5. @DaschnerS
“REST” APIs in real-world projects
POST /doSomeAction
request
<someActionRequest>
<param>12345</param>
</someActionRequest>
response
<someActionResponse>
<foo>bar</foo>
...
</someActionResponse>

6. @DaschnerS
“REST” APIs in real-world projects
POST /getFoobarInformation
request
<foobar>
<id>12345</id>
</foobar>
response
<information>
<foo>bar</foo>
...
</information>

7. @DaschnerS
Resources

8. @DaschnerS
“REST” APIs in real-world projects
GET /users
response
<users>
<user>
<id>12345</id>
<name>Duke</name>
<motto>JAX-RS rocks!</motto>
</user>
...
</users>

9. @DaschnerS
Semantic HTTP

10. @DaschnerS
“REST” APIs in real-world projects
POST /users
request
<user>
<name>Duke</name>
<motto>JAX-RS rocks!</motto>
</user>
response
201 Created
Location: /users/12345

11. @DaschnerS
Enter Hypermedia

12. @DaschnerS
Enter Hypermedia
GET /users
response
<users>
<user>
<name>Duke</name>
<motto>JAX-RS rocks!</motto>
<link rel="self" href="/users/1234"/>
</user>
</users

13. @DaschnerS
Enter Hypermedia
GET /books/12345
response
{
"name": "Java",
// + author, availability, price
"_links": {
"self": "/books/12345",
"add-to-cart": "/shopping_cart"
}
}

14. @DaschnerS
Enter Hypermedia
...
"actions": [
{
"name": "add-to-cart",
"method": "POST",
"href": "/shopping_cart",
"type": "application/json",
"fields": [
{ "name": "id", "type": "text" },
{ "name": "quantity", "type": "number" }
]
}
]

15. @DaschnerS
Hypermedia formats
● HAL
● Collections+JSON
● Siren
● JSON Schema
● JSON-LD & Hydra
● ...

16. Thanks for your attention!
sebastian-daschner.com
twitter.com/DaschnerS
github.com/sdaschner