Роман Просин «REST of the best»

Вспомним основные концепции архитектурного стиля REST, рассмотрим лучшие практики применения на примерах ASP.NET Web API-сервисов.

Transcript

1. REST of the best
2. REST of the Best 2 ▪ Меня зовут Просин Роман. ▪ Мой путь разработчика начался более 7 лет назад ▪ 2 года я работаю разработчиком в ICDB Team Райффайзенбанка. ▪ Мы строим фронт для отделений, сервисы для других систем банка, меняем архитектуру старых сервисов. ▪ Помимо работы я люблю активный отдых, водить автомобиль, Айкидо и многое другое… Всем привет
3. REST of the Best 3 ▪ Representational State Transfer ▪ It is architecture style ▪ Свойства: – Производительность – Масштабируемость ▪ Ограничения: – Клиент-сервер – Отсутствие состояния – Кэширование – Единообразие интерфейса – Слои – Код по требованию REST - что это? Всем привет! Я Рой Филдинг.
4. Цель REST of the Best 4 SOAP WCF HTTP Web API Кажется ничего не изменилось!..
5. Модель зрелости RESTful API HATEOAS Операции определяются методами HTTP На каждый ресурс свой URI Один URI. Все операции - метод POST к этому URI. Hypermedia as the Engine of Application State
6. По порядку REST of the Best 6 1 Архитектура Хм… А как построить RESTful Api?.
7. REST of the Best 7 3 Checklist 2 Лучшие практики КОД 404 Объект не найден, операция провалена! Повторяю КОД 404
8. REST of the Best 8 4 Open API В вашей спецификации сам чёрт ногу сломит!
9. REST of the Best 9 5 Минуточку, у меня есть вопрос! Подведём итог
10. Архитектура
11. Клиент-Протокол-Сервер Клиент/Сервер Клиент Клиент/Сервер Сервер запрос ответ протокол HTTP SOAP REST of the Best 11 MQ HTTP PIPE
12. сессия Отсутствие состояния Клиент/Сервер Клиент Клиент/Сервер Сервер протокол запрос ответ состояние состояние состояние REST of the Best 12
13. Кэширование Клиент/Сервер Клиент Клиент/Сервер Сервер запрос ответ протокол HTTP SOAP Redis Store REST of the Best 13
14. Единообразие интерфейса Клиент/Сервер Клиент Клиент/Сервер Сервер запрос ответ протокол HTTP SOAP REST of the Best 14 DELETE POST PUT PATCH GET MQ HTTP PIPE
15. Слои Клиент/Сервер Клиент Клиент/Прокси/Шлюз Сервер запрос ответ протокол REST of the Best 15 Клиент/Сервер 1 Сервер Клиент/Сервер N Сервер
16. Лучшие практики
17. REST of the Best 17 Что такое «Ресурс»?
18. REST of the Best 18 Идентификатор ресурса (URI) Отлично! Теперь я всегда смогу найти нужную локацию по её названию.
19. REST of the Best 19 Избегайте глаголов в URI Сержант Курочкин Создать на связи!
20. REST of the Best 20 Физическое хранение БД Locations (Part 1) Locations (Part 2)
21. Коллекции – это ресурсы
22. Избегайте сложных URI ресурсов Кажется этот URI слишком длинный. ▪ api/employees/{name}/games
23. Избегайте «болтливых» API REST of the Best 23
24. Избегайте «болтливых» API REST of the Best 24
25. Определяйте операции в терминах методов HTTP
26. Схема использования HTTP методов Ресурс POST GET PUT DELETE locations Создаёт новый Возвращает все Обновляет все Удаляет все Locations/{name} Вернёт ошибку Вернёт экземпляр Обновит экземпляр если он есть Удалит экземпляр locations/{name}/games Создаст новую игру в локации Вернёт все игры в локации Обновит все игры в локации Удалит все игры в локации
27. PUT vs PATCH REST of the Best 27 HTTP Method Идемпотентность POST GET PUT PATCH DELETE Объект v1 Объект v2 Объект v1 Объект v1
28. PUT vs PATCH REST of the Best 28
29. PUT vs PATCH REST of the Best 29 412 HTTP Precondition Failed
30. REST of the Best 30 Фильтрация
31. Фильтрация по старинке REST of the Best 31
32. REST of the Best 32 Постраничный вывод
33. REST of the Best 33 Cache
34. REST of the Best 34 Hypermedia Привет! Я Тед Нельсон
35. Open API
36. Open API Initiative REST of the Best 36
37. Checklist
38. REST of the Best 38 ✓ Проверьте все маршруты ✓ Убедитесь, что все маршруты защищены ✓ Убедитесь, что сообщения запроса и ответа хорошо сформированы ✓ Убедитесь, что каждая операция возвращает правильные коды состояния ✓ Проверьте обработку исключений Checklist
39. Подведём итог
40. REST of the Best 40 ✓ Масштабируемость: ✓ Ресурсы ✓ HTTP Methods ✓ Open API Specification ✓ Фильтры ✓ HATEOAS ✓ Производительность: ✓ Постраничный вывод ✓ Кэш Итог
41. Спасибо за внимание! prosin-roma@ya.ru Вопросы?