Открытый вебинар
Создание систем на основе микросервисной архитектуры Spring Boot

Приложение, позволяющее вести каталог книг в библиотеке. -------------------------Описание домашнего задания-------------------------
### Задание:

Разработать однопользовательское, консольное приложение позволяющее вести каталог книг в библиотеке. Каждая книга имеет автора и как минимум один жанр (в зависимости от выбранной сложности работы). Задание выполняется на базе заготовки, содержащей каркас приложения. Необходимо "дописать" классы и служебные файлы заготовки, ориентируясь на оставленные в ней подсказки так, чтобы выполнялись условия задания. Также решение должно удовлетворять нижеуказанным требованиям.




### Требования к использованию заготовки:
- То, что уже было в заготовке, должно остаться неизменным (количество, имена и текущее содержимое классов и файлов, сигнатуры методов и т.д.)
- Можно добавлять код/текст в существующие методы классов и файлы, писать свои приватные методы, а также создавать новые классы
- Вышеуказанные требования не относятся к комментариям, их после реализации нужно удалить




### Требования к реализации:
- Использовать Spring JDBC и реляционную базу H2
- Для параметризованных запросов использовать NamedParametersJdbcTemplate
- Каждая сущность должна храниться в своей таблице
- Отношение между книгой и автором - многие-к-одному (у книги один автор, но у автора может быть несколько книг)
- Отношение между книгой и жанром зависит от выбранной сложности работы. Многие-к-одному (у книги один жанр, но у жанра может быть несколько книг) или многие-ко-многим (у книги много жанров, и у жанра может быть несколько книг)
- Интерфейс выполняется на Spring Shell. Для сущности книги, предусмотреть операции создания, обновления, удаления, вывода всех книг, а также вывода книги по id
- Предусмотреть операции вывода полного списка сущностей авторов и жанров
- Создание и инициализация схемы БД должно происходить через schema.sql + data.sql
- Не делать абстрактных или обобщенных сущностей
- Не делать абстрактных или обобщенных Dao
- Не делать двунаправленных связей (в книге автор, в авторе книги)
- Проблема N+1 должна быть решена
- С помощью @JdbcTest сделать интеграционные тесты всех методов дао жанров (со встроенной БД)
- Без фанатизма)




### Опционально:
- Создание и инициализация схемы БД сделать через систему миграций (Liquibase/Flyway)
- Отношение книга-жанр, многие-ко-многим (должен использоваться соответствующий вариант заготовки)





Заготовка для выполнения работы:
- Базовый вариант: [https://github.com/OtusTeam/Spring/tree/master/templates/hw05-jdbc-simple](https://github.com/OtusTeam/Spring/tree/master/templates/hw05-jdbc-simple)
- Вариант с опциональным усложнением: [https://github.com/OtusTeam/Spring/tree/master/templates/hw05-jdbc-hard](https://github.com/OtusTeam/Spring/tree/master/templates/hw05-jdbc-hard)



Задание сдаётся в виде ссылки на pull-request в чат с преподавателем в личном кабинете ОТУС, а не в Telegram


В pull-request должно присутствовать только то что касается текущей работы. Временные файлы и файлы IDE не должны попадать в PR.


Инструкция по работе с pull-request-ами находится в документе "Настройка окружения.pdf" в материалах занятия.


Вопросы можно задавать в чате ДЗ, но для оперативности рекомендуем делать это в группе Telegram.


Код, написанный в данном ДЗ будет использоваться в дальнейших домашних заданиях всех оставшихся блоков курса

Использовать ORM в качестве способа доступа к данным в приложении для хранения книг в библиотеке. -------------------------Описание домашнего задания-------------------------
### Задание:

Перевести приложение каталог книг в библиотеке на репозитории, использующие в качестве технологии доступа к данным, Spring ORM, JPA и Hibernate. Дополнить доменную модель сущностью комментария к книге. Задание выполняется на базе предыдущей работы, но также имеет заготовку содержащую тесты, проверяющие некоторые из требований к заданию. Решение должно удовлетворять нижеуказанным требованиям.




### Требования к использованию заготовки:
- Тесты из заготовки должны остаться неизменными (за исключением, возможно, имени пакета)




### Требования к реализации:
- Использовать Spring ORM, JPA и Hibernate (EntityManager) в качестве технологии доступа к данным
- Spring Data пока использовать нельзя
- Добавить сущность "комментария к книге" (много комментариев к одной книге)
- Реализовать CRUD операции для новой сущности. Получение всех комментариев делать не нужно. Только конкретного комментария по id и всех комментариев по конкретной книге по ее id
- Загрузка связей сущностей не должна приводить к большому количеству запросов к БД или избыточному по объему набору данных (проблема N+1 и проблема произведения таблиц)
- DDL через Hibernate должно быть отключено
- LAZY-связи не должны присутствовать в equals/hashCode/toString. В т.ч. за счет @Data
- Проблема N+1 должна быть решена теми же способами, что и в прошлой работе, но уже через инструменты, предоставляемыми ORM
- Аннотация @Transactional должна присутствовать только на методах сервиса
- Покрыть все репозитории тестами, используя H2 базу данных и @DataJpaTest
- В тестах репозиториев, для проверки или подготовки данных использовать TestEntityManager (только методы не требующие написания запросов). Сами репозитории для этого использовать нельзя
- Написать интеграционные тесты сервисов книг и комментариев, где проверить, что доступ к связям, которые используются снаружи серивсов не вызывают LazyInitialzationException
- Не забыть учесть в тестах, что тестовый контекст кэшируется, т.е. должны проходить как все тесты разом, так и по отдельности
- Для приема работы тесты из заготовки должны проходить
- Без фанатизма)





Заготовка для выполнения работы: [https://github.com/OtusTeam/Spring/tree/master/templates/hw06-jpa](https://github.com/OtusTeam/Spring/tree/master/templates/hw06-jpa)



Задание сдаётся в виде ссылки на pull-request в чат с преподавателем в личном кабинете ОТУС, а не в Telegram


В pull-request должно присутствовать только то что касается текущей работы. Временные файлы и файлы IDE не должны попадать в PR.


Инструкция по работе с pull-request-ами находится в документе "Настройка окружения.pdf" в материалах занятия.


Вопросы можно задавать в чате ДЗ, но для оперативности рекомендуем делать это в группе Telegram.


Код, написанный в данном ДЗ будет использоваться в дальнейших домашних заданиях всех оставшихся блоков курса

Использовать Spring Data JPA в качестве способа доступа к данным в приложении для хранения книг в библиотеке. -------------------------Описание домашнего задания-------------------------
### Задание:

Перевести приложение каталог книг в библиотеке на использование Spring Data JPA репозиториев в качестве технологии доступа к данным. Задание выполняется на базе предыдущей работы. Решение должно удовлетворять нижеуказанным требованиям.




### Требования к реализации:
- Подключить spring-boot-starter-data-jpa
- Переписать все репозитории на Spring Data JPA репозитории
- Все тесты с прошлой работы должны проходить
- Все требования к прошлой работе, касающиеся работы со связями и транзакциями, должны быть также соблюдены (N+1, Lazy поля + equals/hashCode/toString и т.д.)
- Без фанатизма :)






Задание сдаётся в виде ссылки на pull-request в чат с преподавателем в личном кабинете ОТУС, а не в Telegram


В pull-request должно присутствовать только то что касается текущей работы. Временные файлы и файлы IDE не должны попадать в PR.


Инструкция по работе с pull-request-ами находится в документе "Настройка окружения.pdf" в материалах занятия.


Вопросы можно задавать в чате ДЗ, но для оперативности рекомендуем делать это в группе Telegram.


Код, написанный в данном ДЗ будет использоваться в дальнейших домашних заданиях всех оставшихся блоков курса

В приложении для хранения книг в библиотеке, использовать MongoDB как источник хранения данных и Spring Data MongoDB в качестве способа доступа к ним . -------------------------Описание домашнего задания-------------------------
### Задание:

Перевести приложение каталог книг в библиотеке на использование Spring Data MongoDB репозиториев в качестве технологии доступа к данным и MongoDB для их хранения. Задание выполняется на базе предыдущей работы. Решение должно удовлетворять нижеуказанным требованиям.




### Требования к реализации:
- Подключить spring-boot-starter-data-mongodb
- Переписать все репозитории на Spring Data MongoDB репозитории
- Можно реализовать Flapdoodle Embedded MongoDB
- Покрыть интеграционными тестами (со встроенной БД) все сервисы, остальные тесты можно убрать
- В решении не должно остаться никаких следов других технологий доступа к данным (Jdbc/Jpa)
- Работа приложения не должна приводить к наличию данных, находящихся в неконсистентном виде
- Учесть отсутствие каскадных операций (в т.ч. при использовании @DBRef) и то, что MongoEventListener-ы по разному работают для разных методов, а в некоторых случаях и вовсе не сработают
- Без крайней необходимости из БД не должны тянуться лишние данные (пример - загрузка всех книг автора при его удалении или изменении). При необходимости, можно применить подход с расшриением Spring Data репозиториев кастомным функционалом использующим MongoOperations
- Без фанатизма)






Задание сдаётся в виде ссылки на pull-request в чат с преподавателем в личном кабинете ОТУС, а не в Telegram


В pull-request должно присутствовать только то что касается текущей работы. Временные файлы и файлы IDE не должны попадать в PR.


Инструкция по работе с pull-request-ами находится в документе "Настройка окружения.pdf" в материалах занятия.


Вопросы можно задавать в чате ДЗ, но для оперативности рекомендуем делать это в группе Telegram.


Код, написанный в данном ДЗ будет использоваться в дальнейших домашних заданиях всех оставшихся блоков курса

CRUD приложение с Web UI и хранением данных в БД.
Необходимо:

1. Создать приложение с хранением сущностей в БД (можно взять библиотеку и DAO/репозитории из прошлых занятий);

2. Использовать классический View на Thymeleaf, classic Controllers;

3. Для книг (главной сущности) на UI должны быть доступные все CRUD операции. CRUD остальных сущностей - по желанию/необходимости;

4. Протестировать контроллер(ы) для CRUD операций над книгами с помощью @WebMvcTest и моков сервисов;

5. Локализацию делать НЕ нужно - она строго опциональна;

6. Без фанатизма)


Данное задание НЕ засчитывает предыдущие!


Это домашнее задание частично будет использоваться в дальнейшем

Переписать приложение с использованием AJAX и REST-контроллеров.
Домашнее задание выполняется на основе предыдущего.


1. Переписать приложение с классических View на AJAX архитектуру и REST-контроллеры;

2. Минимум: получение одной сущности и отображение её на странице с помощью XmlHttpRequest, fetch api или jQuery;

3. Опционально максимум: полноценное SPA приложение на React/Vue/Angular, только REST-контроллеры;

4. Протестировать все эндпойнты REST-контроллеров с моками зависимостей;

5. Без фанатизма)


В случае разработки SPA - рекомендуется вынести репозиторий с front-end. Используйте proxy при разработке (настройки CORS не должно быть).


Данное задание, выполненное в виде SPA засчитывает пердыдущее ДЗ

Если Вы хотите засчитать, то обязательно пришлите ссылку в чат соответствующего предыдущего занятия.


Данное ДЗ будет использоваться в дальнейшем

Использовать WebFlux.
1. За основу для выполнения работы можно взять ДЗ с Ajax + REST (классическое веб-приложение для этого луче не использовать).

2. Но можно выбрать другую доменную модель (не библиотеку).

3. Необходимо использовать Reactive Spring Data Repositories.

4. В качестве БД лучше использовать MongoDB или Redis. Использовать PostgreSQL и экспериментальную R2DBC не рекомендуется.

5. RxJava vs Project Reactor - на Ваш вкус.

6. Вместо классического Spring MVC и embedded Web-сервера использовать WebFlux.

7. Опционально: реализовать на Functional Endpoints


Данное задание НЕ засчитывает предыдущие!


Рекомендации:

Старайтесь избавиться от лишних архитектурных слоёв. Самый простой вариант - весь flow в контроллере.

В CRUD Web-приложение добавить механизм аутентификации.
Внимание! Задание выполняется на основе нереактивного приложения Spring MVC!


1. Добавить в приложение новую сущность - пользователь. Не обязательно реализовывать методы по созданию пользователей - допустимо добавить пользователей только через БД-скрипты.

2. В существующее CRUD-приложение добавить механизм Form-based аутентификации.

3. UserDetailsService реализовать самостоятельно.

4. Авторизация на всех страницах - для всех аутентифицированных. Форма логина - доступна для всех.

5. Написать тесты контроллеров, которые проверяют, что все необходимые ресурсы действительно защищены.


Данное задание НЕ засчитывает предыдущие!


Данное ДЗ будет использоваться в дальнейшем.

Ввести авторизацию на основе URL и/или доменных сущностей.
Внимание! Задание выполняется на основе нереактивного приложения Sping MVC!


1. Минимум: настроить в приложении авторизацию на уровне URL.

2. Максимум: настроить в приложении авторизацию на основе доменных сущностей и методов сервиса.


Рекомендации по выполнению:

1. Не рекомендуется выделять пользователей с разными правами в разные классы - т.е. просто один класс пользователя.

2. В случае авторизации на основе доменных сущностей и PostgreSQL не используйте GUID для сущностей.

3. Написать тесты контроллеров, которые проверяют, что все необходимые ресурсы действительно защищены


Данное задание НЕ засчитывает предыдущие!

На основе Spring Batch разработать процедуру миграции данных из реляционного хранилища в NoSQL или наоборот.
1. Задание может быть выполнено в отдельном приложении, с сущностями из ДЗ JPA и MongoDB.

2. Вы можете выбрать другую доменную модель

3. Не обязательно добавлять процесс миграции в веб-приложение. Приложение может быть оформлено в виде отдельной утилиты.

4. Используя Spring Batch, следите, чтобы связи сущностей сохранились.

5. Опционально: Сделать restart задачи с помощью Spring Shell.


Данное задание НЕ засчитывает предыдущие!

Реализовать обработку доменной сущности через каналы Spring Integration.
1. Выберите другую доменную область и сущности. Пример: превращение гусеницы в бабочку.

2. Опишите/сконфигурируйте процесс (IntegrationFlow) с помощью инструментария предоставляемого Spring Integration.

3. Желательно использование MessagingGateway и subfolw (при необходимости).


Задание выполняется в другом репозитории/в другой папке.


Данное задание НЕ засчитывает предыдущие!

Использовать метрики, healthchecks и logfile.
Данное задание выполняется на основе одного из реализованных Web-приложений



1. Подключить Spring Boot Actuator в приложение.

2. Включить метрики, healthchecks и logfile.

3. Реализовать свой собственный HealthCheck индикатор

4. UI для данных от Spring Boot Actuator реализовывать не нужно.

5. Опционально: переписать приложение на HATEOAS принципах с помощью Spring Data REST Repository


Данное задание НЕ засчитывает предыдущие!

Обернуть приложение в docker-контейнер.
Внимание! Задание выполняется на основе любого сделанного Web-приложения


1. Обернуть приложение в docker-контейнер. Dockerfile принято располагать в корне репозитория. В image должна попадать JAR-приложения. Сборка в контейнере рекомендуется, но не обязательна.

2. БД в собственный контейнер оборачивать не нужно (если только Вы не используете кастомные плагины)

3. Настроить связь между контейнерами, с помощью docker-compose

4. Опционально: сделать это в локальном кубе.

5. Приложение желательно реализовать с помощью всех Best Practices Docker (логгирование в stdout и т.д.)


Данное задание НЕ засчитывает предыдущие!

Обернуть внешние вызовы в Hystrix.
1. Обернуть все внешние вызовы в Hystrix, Hystrix Javanica.

2. Возможно использование Resilent4j

3. Возможно использование Feign Client

Опционально: Поднять Turbine Dashboard для мониторинга.


Данное задание НЕ засчитывает предыдущие!

Проектная работа. Требования к проекту и его технологическому стеку

0. Объем, как 3-4 ДЗ (за меру можно взять ДЗ по веб-библиотеке)
1. Spring Core
2. Spring Security (желательно через JWT, желательно вынести в отдельный сервис)
3. Spring MVC/WebFlux
4. Bean Validation
5. Spring Data Jdbc/Jpa/MongoDB/...
6. Коммуникация между микросервисами по REST/очередям (если есть микросервисы)
7. Соблюдение всех практик и рекомендаций, которые давались на курсе. В том числе должна быть работа с исключениями
8. Юнит и интеграционные тесты приветствуются
9. Использование паттернов отказоустойчивости приветствуется (CircuitBreaker/Retry/Cache/ServiceRegistry/ConfigServer/ApiGateway/...)
10. Docker приветствуется



Для допуска к выполнению проектной работы, нужно чтобы были сданы ДЗ к следующим лекциям:
1. Чёрная магия" Spring Boot
2. DAO на Spring JDBC
3. JPQL, Spring ORM, DAO на основе Spring ORM + JPA и/или "Белая магия" Spring Data: Spring Data JPA
4. Spring MVC View и/или Современные приложения на Spring MVC
5. Spring Security: ACL