День открытых дверей
Всё о курсе «Разработчик на Spring Framework»

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

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




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




### Требования к реализации:
- Использовать 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 и хранением данных в БД. -------------------------Описание домашнего задания-------------------------
### Задание:
Преобразовать консольное приложение каталога книг в библиотеке в веб-приложение с сохранением функциональности. Задание выполняется на базе предыдущей работы (Spring Data JPA или Spring Data Mongo DB).




### Требования к реализации:
- Реализовать CRUD операции для сущности книги, а так же отображения авторов, жанров и комментариев. Остальные операции с сущностями - по желанию/необходимости;
- Предусмотреть страницу со списком книг, списком авторов, списком жанров, страницу создания/редактирования книги, страницу просмотра книги со списком комментариев к ней;
- Удаление сущностей можно сделать на отдельной странице подтверждения удаления, странице редактирования или по кнопке из списка;
- Для удаления НЕ должен использоваться HTTP-метод GET;
- Из любого места приложения должна быть возможность вернуться на главную страницу (список книг);
- Выбор авторов и жанров при редактировании должен осуществляться из списков (`<select>`), ручного ввода id быть не должно;
- Использовать View на Thymeleaf и классические контроллеры (@Controller). Использование REST/Ajax данным заданием не предусматривается;
- Протестировать все эндпойнты контроллеров для CRUD операций над книгами с помощью @WebMvcTest и моков сервисов;
- Локализация интерфейса данным заданием не предусматривается, она строго опциональна;
- Без фанатизма)






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


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


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


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


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

Переписать приложение с использованием AJAX и REST-контроллеров. -------------------------Описание домашнего задания-------------------------
### Задание:
Пределать веб-приложение каталога книг в библиотеке на использование архитектуроного стиля REST. Задание выполняется на базе предыдущей работы.




### Требования к реализации:
- Для получения данных на страницах приложения использовать JavaScript, fetch api и REST-контроллеры;
- Минимум: переделать CRUD операции над книгами;
- URL эндпойнтов должны соответствовать ресурсному стилю REST (см. пример типового api на соответствующем слайде презентации к лекции);
- Действия над сущностями должны быть выражены исключительно через HTTP-методы. Глаголов в URL быть не должно;
- Протестировать все эндпойнты REST-контроллеров с помощью @WebMvcTest и моков сервисов;
- Без фанатизма)






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


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


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


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


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

Использовать WebFlux. -------------------------Описание домашнего задания-------------------------
### Задание:
Пределать веб-приложение каталога книг в библиотеке на использование реактивного подхода. Задание выполняется на базе предыдущей работы по AJAX/REST




### Требования к реализации:

- Переписать REST эндпойнты на WebFlux. Опционально: вместо контроллеров использовать Functional Endpoints;
- Использовать Spring Data Reactive MongoDb;
- Опциональное усложнение: Использовать Spring Data R2DBC и H2. Проблема N+1 должна быть решена (например, через кастомные репозитории и R2dbcEntityOperations)
- Использование block() и subscribe() условно допустимо только в миграциях и тестах;
- Протестировать все эндпойнты с помощью @WebFluxTest и моков сервисов;
- Без фанатизма)






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


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


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


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


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

В 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