This webinar by Oleksandr Navka (GlobalLogic) was delivered at Java TechTalk on June 17, 2021.

1. 1
Confidential
Building a Hypermedia REST application
using Spring
Oleksandr Navka
17 June 2021

2. 2
Confidential
Agenda
1. OpenAPI + Swagger UI
2. HATEOAS
3. Spring Rest Docs

3. 3
3
Confidential
Intro

4. 4
Confidential

5. 5
Confidential

6. 6
Confidential
REST

7. 7
Confidential
REST
gRPC

8. 8
Confidential
REST
gRPC

9. 9
Confidential
REST
gRPC

10. 10
Confidential

11. 11
Confidential
1. Talk on meeting
2. Use messenger (Slack etc.)
3. E-mail
4. Documentation
5. Swagger
6. Spring REST Docs
7. Hypermedia API

12. 12
Confidential
1. Talk on meeting
2. Use messenger (Slack etc.)
3. E-mail
4. Documentation
5. Swagger
6. Spring REST Docs
7. Hypermedia API
Manual
Auto

13. 13
Confidential
13
Demo App

14. 14
Confidential
COVID-19 Vaccination demo app

15. 15
Confidential

16. 16
Confidential
Queue

17. 17
Confidential
17
Open API + Swagger UI

18. 18
Confidential
The OpenAPI Specification allows the description of a remote API
accessible through HTTP or HTTP-like protocols
https://www.openapis.org/
Open API

19. 19
Confidential
paths:
/users/{userId}:
get:
summary: Returns a user by ID.
parameters:
- in: path
name: userId
required: true
type: integer
minimum: 1
description: The ID of the user to return.
responses:
200:
description: A User object.
Open API example

20. 20
Confidential
Swagger UI

21. 21
Confidential

22. 22
Confidential

23. 23
Confidential
23
HATEOAS

24. 24
Confidential
Resources + link
What is Hypermedia?

25. 25
Confidential
What is Hypermedia?
{
"id": "0b210c2a-467c-4146-bc99-
38563cd66b5c",
"name": "Petro",
"vaccinations": [
{
"date": "2021-03-08",
"vaccine": "ASTRA_ZENECA",
"status": "PROVIDED"
}],
"fullyVaccinated": true
}

26. 26
Confidential
What is Hypermedia?
{
"id": "0b210c2a-467c",
"name": "Petro",
"vaccinations": [
{
"date": "2021-03-08",
"vaccine": "ASTRA_ZENECA",
"status": "PROVIDED"
}],
"fullyVaccinated": true,
"_links": {
"get certificate": {
"href":
"http://localhost:8080/person/...
}
}
}
{
"id": "0b210c2a-467c-4146-bc99-
38563cd66b5c",
"name": "Petro",
"vaccinations": [
{
"date": "2021-03-08",
"vaccine": "ASTRA_ZENECA",
"status": "PROVIDED"
}],
"fullyVaccinated": true
}

27. 27
Confidential
What is Hypermedia?
{
"id": "0b210c2a-467c",
"name": "Petro",
"vaccinations": [
{
"date": "2021-03-08",
"vaccine": "ASTRA_ZENECA",
"status": "PROVIDED"
}],
"fullyVaccinated": true,
"_links": {
"get certificate": {
"href":
"http://localhost:8080/person/...
}
}
}
{
"id": "0b210c2a-467c-4146-bc99-
38563cd66b5c",
"name": "Petro",
"vaccinations": [
{
"date": "2021-03-08",
"vaccine": "ASTRA_ZENECA",
"status": "PROVIDED"
}],
"fullyVaccinated": true
}

28. 28
Confidential
Vaccination logic
1. Schedule vaccination
2. Get vaccination certificate

29. 29
Confidential

30. 30
30
Confidential
Spring REST Docs

31. 31
Confidential
Doesn’t provide actions
(links)
Doesn’t show the
payload

32. 32
Confidential
What the idea?
Spring REST
Docs

33. 33
Confidential

34. 34
Confidential

35. 35
35
Confidential
Open API, Hypermedia API and Spring REST Docs
- complement each other rather than mutually
exclusive
Summary

36. 36
Confidential

37. 37
Confidential
Thank You