diff --git a/README.md b/README.md index c2ab201a624d..72ec4c70d6ec 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ -Java Enterprise Online Project +[Java Enterprise Online Project](https://javaops.ru/view/topjava) =============================== -Разработка полнофункционального Spring/JPA Enterprise приложения c авторизацией и правами доступа на основе ролей с использованием наиболее популярных инструментов и технологий Java: Maven, Spring MVC, Security, JPA(Hibernate), REST(Jackson), Bootstrap (css,js), DataTables, jQuery + plugins, Java 8 Stream and Time API и хранением в базах данных Postgresql и HSQLDB. +Разработка полнофункционального Spring/JPA Enterprise приложения c авторизацией и правами доступа на основе ролей с использованием наиболее популярных инструментов и технологий Java: Maven, Spring MVC, Security, JPA(Hibernate), REST(Jackson), Bootstrap (css,js), DataTables, jQuery + plugins, Stream and Time API и хранением в базах данных Postgresql и HSQLDB. ![topjava_structure](https://javaops.ru/static/images/projects/top-scheme.jpg) @@ -14,7 +14,7 @@ Java Enterprise Online Project ## Описание и план проекта ### Демо разрабатываемого приложения ### [Изменения проекта (Release Notes)](ReleaseNotes.md) -### Требования к участникам, Wiki +### Требования к участникам, Wiki ### Составление резюме, подготовка к интервью, поиск работы Обновленное вводное занятие (обязательно смотреть все видео) @@ -37,9 +37,12 @@ Java Enterprise Online Project ## ![video](https://cloud.githubusercontent.com/assets/13649199/13672715/06dbc6ce-e6e7-11e5-81a9-04fbddb9e488.png) 5. [Системы управления версиями. Git](doc/video5-vcs-git.md) -## ![video](https://cloud.githubusercontent.com/assets/13649199/13672715/06dbc6ce-e6e7-11e5-81a9-04fbddb9e488.png) 6. Работа с проектом (выполнять инструкции) -- **ВНИМАНИЕ: выбирайте для проекта простой пусть без пробелов и русских букв, например, `c:\projects\topjava\` (Windows). Иначе впоследствии будут проблемы** +## ![video](https://cloud.githubusercontent.com/assets/13649199/13672715/06dbc6ce-e6e7-11e5-81a9-04fbddb9e488.png) 6. Работа с проектом (выполнять инструкции) +- **ВНИМАНИЕ: выбирайте для проекта простой путь без пробелов и русских букв, например, `c:\projects\topjava\` (Windows). Иначе впоследствии будут проблемы** - **Плагин Git Intergation уже не требуется, а вкладку `Version control` в IDEA переименовали в `Git`** +- **Установка IDEA** + - Скачать IDEA и установливать плагины [можно по инструкции](https://github.com/JavaOPs/topjava/wiki/IDEA#download) + - После Trial 30 дней [способы продлить использование](https://github.com/JavaOPs/topjava/wiki/IDEA#licence) Для переключения режима отображения изменений из вкладки `Commit` в `Git: Local Changes` нужно переключить `Settings/Preferences | Version Control | Commit | Use non-modal commit interface` или в контекстном меню вкладки `Commit`: @@ -64,11 +67,11 @@ Java Enterprise Online Project - Сделать локальный репозиторий проекта: 
git clone https://github.com/[Ваш аккаунт]/topjava.git
-> Вместо Fork можно сделать [клонирование проекта](https://github.com/JavaOPs/topjava/wiki/Git#user-content-Клонирование-проекта): он не будет привязан к исходному https://github.com/JavaOPs/topjava и у него не будет истории. +> Вместо Fork можно сделать [клонирование проекта](https://github.com/JavaOPs/topjava//Git#user-content-Клонирование-проекта): он не будет привязан к исходному https://github.com/JavaOPs/topjava и у него не будет истории. - Открыть и настроить проект в IDEA - Выставить кодировку UTF-8 в консоли - - Поставить кодировку UTF-8 + - Поставить кодировку UTF-8 - Опционально: поменять шрифт по умолчанию на DejaVu или на **новый [JetBrains Mono](https://habr.com/ru/company/jugru/news/t/484134/)** - По ходу видео сделать `Apply Patch...` скачанного патча `Prepare_to_HW0.patch` - Закоммитить и запушить изменения (`commit` + `push`) @@ -77,6 +80,7 @@ Java Enterprise Online Project - Переключиться в основную ветку проекта `master`. ## ![video](https://cloud.githubusercontent.com/assets/13649199/13672715/06dbc6ce-e6e7-11e5-81a9-04fbddb9e488.png) 7. [Maven](https://drive.google.com/file/d/1qEJTwv9FNUQjx-y9MSydH01xaAne0-hu) +- [Как установить Maven 3 на Ubuntu или Windows](https://devcolibri.com/как-установить-maven-3-на-ubuntu-или-windows/) - [Руководство по Maven](https://topjava.ru/blog/apache-maven-osnovy-1) - Wiki: [Apache Maven](https://ru.wikipedia.org/wiki/Apache_Maven) - [The Central Repository](http://search.maven.org) @@ -117,9 +121,9 @@ Java Enterprise Online Project #### ВНИМАНИЕ: варианты Optional делайте в одной ветке в разных методах `UserMealsUtil`. Проще делать, проще проверять -### Optional (Java 8 Stream API) +### Optional (Stream API) ``` -Реализовать метод `UserMealsUtil.filteredByStreams` через Java 8 Stream API. +Реализовать метод `UserMealsUtil.filteredByStreams` через Stream API. ``` - Видео: Доступно о Java 8 Lambda - Java 8: Lambda выражения @@ -143,7 +147,7 @@ Java Enterprise Online Project - без циклов по другим коллекциям/массивам (к ним также относим методы коллекций `addAll()/removeAll()`) - через Stream API за 1 проход по исходному списку `meals.stream()` - нельзя использовать внешние коллекции, не являющиеся частью коллектора - - возможно дополнительные проходы по частям списка, при этом превышение должно считаться один раз для всего подсписка. Те например нельзя разбить список на на 2 подсписка с четными и нечетными датами и затем их объединить, с подсчетом превышения для каждого элемента. + - возможно дополнительные проходы по частям списка, при этом превышение должно считаться один раз для всего подсписка. Те например нельзя разбить список на 2 подсписка с четными и нечетными датами и затем их объединить, с подсчетом превышения для каждого элемента. Временная сложность реализации должна быть O(N) (обратите внимание на п. 13 замечаний) Решение должно быть рабочим в общем случае (должно работать в приложении с многими пользователями, не только при запуске `main`) @@ -222,6 +226,12 @@ Java Enterprise Online Project - Как создать Servlet? Полное руководство. - [Сервлеты](https://metanit.com/java/javaee/4.1.php) +#### Туториалы по Spring +- [Юрий Ткач: Spring Framework - The Basics](https://www.youtube.com/playlist?list=PL6jg6AGdCNaWF-sUH2QDudBRXo54zuN1t) +- [Java Brains: Spring Framework](https://www.youtube.com/playlist?list=PLC97BDEFDCDD169D7) +- [Тимур Батыршинов: Spring Core - основы фреймворка, ядро](https://www.youtube.com/watch?v=CfHDr-19WWY&list=PL8X2nqRlWfaYYP1-qXjdPKE7bXYkl6aL4) +- [alishev: Spring Framework](https://www.youtube.com/playlist?list=PLAma_mKffTOR5o0WNHnY0mTjKxnCgSXrZ) + #### JDBC, SQL - Основы SQL на примере задачи - Уроки по JDBC diff --git a/ReleaseNotes.md b/ReleaseNotes.md index f7d46f6540a2..40fef33ddfb3 100644 --- a/ReleaseNotes.md +++ b/ReleaseNotes.md @@ -1,12 +1,12 @@ # TopJava Release Notes ### TopJava 26 -- починили шаблоны запросов на создание в Swagger хчз [ApiModelProperty](https://www.baeldung.com/spring-swagger-hide-field) +- починили шаблоны запросов на создание в Swagger через [ApiModelProperty](https://www.baeldung.com/spring-swagger-hide-field) - в новой версии Data JPA `getById`->`getReferenceById` - мелкие правки ### TopJava 25 -- поправил `NoHtmlValidator`: `Jsoup.clean().equals -> `Jsoup.isValid` +- поправил `NoHtmlValidator`: `Jsoup.clean().equals` -> `Jsoup.isValid` - починил `role VARCHAR NOT NULL` - добавил нового тестового пользователя `guest` diff --git a/cv.md b/cv.md index 805af727a784..2f01659fea12 100644 --- a/cv.md +++ b/cv.md @@ -5,6 +5,7 @@ - Научиться программировать сложнее, чем кажется - [Собеседование. Разработка ПО. Вопросы.](https://drive.google.com/file/d/0B9Ye2auQ_NsFQVc2WUdCR0xvLWM/view?usp=sharing&resourcekey=0-HaWoRxoyboMSKjg5P2I1cQ) - [Набор ссылок для тренировки и прохождения интервью](https://github.com/andreis/interview) +- [Полезные советы Jun-ам](https://github.com/JavaOPs) ### Составление резюме: - [VisualCV: create resume in minutes](https://www.visualcv.com/) @@ -34,6 +35,7 @@ ## [Тестовое собеседование, самые спрашиваемые темы](http://javaops.ru/interview/test.html) ### Интервью: +- [Собеседования для бэкендеров: как готовиться, тренироваться и не облажаться](https://habr.com/ru/companies/getmatch/articles/744760/) - [10 неочевидных фактов об ИТ-собеседованиях](https://proglib.io/p/molchanie-intervyuera-ili-10-neochevidnyh-faktov-ob-it-sobesedovaniyah-2022-06-14) - Михаил Портнов. Собеседование на работу: как продать себя грамотно - Михаил Портнов. Какие вопросы мы задаем на собеседовании? @@ -89,6 +91,7 @@ ### После прохождения испытательного срока жду твою [историю успеха](http://javaops.ru/view/story) ### Основные сайты поиска работы: +- [Актуальная подборка Junior вакансий от CodeReview](https://jobs.yourcodereview.com?utm_source=partner&utm_medium=javaops&utm_campaign=landing) - Яндекс агрегатор - HH - LinkedIn @@ -106,14 +109,17 @@ - Грамотно уделяй время каждой проблеме. Две крайности: сразу бросаться за помощью и биться над проблемой часами. Пробуй решить ее сам и, в зависимости от проблемы, выделяй на это разумное время. -- Если тебе что-то объясняют по проекту - обязательно записывай. -- Когда получаешь задачу - уточни все очень подробно. -- Получай в процессе решения обратную связь - в том ли направлении ты идешь. -- Не игнорируй совместные ланчи (курилки) -- Готовься к стендапам/летучкам. Задавай на них вменяемые вопросы. Выказывай заинтересованность +- Не бросайся сразу писать код, поищи в проекте схожий функционал! И далее - минимум своих подходов, если хотите внести что-то свое - обязательно спросите! +Проект должен быть однотипным по максимуму во всех мелочах: - описание, пакеты, имена классов и методов и даже переменных, реализация, хелп. +Обычно можно найти сходный функционал, взять его себе и делать в нем изменения под свою реализацию. +- Если тебе что-то объясняют по проекту - обязательно записывай. +- Когда получаешь задачу - уточни все очень подробно. Если задач несколько - обязательно выясни приоритеты! +- Получай в процессе решения обратную связь - в том ли направлении ты идешь +- Не игнорируй совместные ланчи (курилки) +- Готовься к стендапам/летучкам. Задавай на них вменяемые вопросы. Выказывай заинтересованность - Выдели самое главное путем опроса босса и важных коллег. Не распыляйся на мелочи. - [**5 вещей, которые разработчик должен сделать прежде чем попросить о помощи**](https://techrocks.ru/2018/07/16/5-things-a-developer-should-do-before-asking-for-help/) -- [**Советы новичкам**](http://blog.csssr.ru/2016/09/19/how-to-be-a-beginner-developer) +- [**Советы новичкам**](https://blog.csssr.com/ru/article/how-to-be-a-beginner-developer) - [ТОП-13 ошибок начинающего программиста](https://proglib.io/p/beginners-fails/) - [25 ошибок начинающего программиста](https://habr.com/ru/post/413129/) - [Путеводитель по синдрому самозванца](https://vc.ru/hr/167443-eshche-odin-putevoditel-po-sindromu-samozvanca-korni-prichiny-simptomy-i-posledstviya-chast-1) diff --git a/doc/video1.md b/doc/video1.md index 3c62fc31b3f6..d1d9b16482e5 100644 --- a/doc/video1.md +++ b/doc/video1.md @@ -65,7 +65,7 @@ Помимо известного всем Hibernate, можно столкнуться с использованием JOOQ или чистого JDBC. Зачастую на проектах используются готовые решения -для хеширования данных (Redis), поисковые движки (ElasticSearch), +для кэширования данных (Redis), поисковые движки (ElasticSearch), различные брокеры сообщений (RabbitMQ, ActiveMQ, Kafka). Инфраструктура проектов также может быть довольно сложной. diff --git a/graduation.md b/graduation.md index d31115e0e461..a2192f1845c8 100644 --- a/graduation.md +++ b/graduation.md @@ -31,7 +31,8 @@ P.P.S.: Assume that your API will be used by a frontend developer to build front - **Не изобретай велосипедов!** Грубая ошибка - пытаться сделать стандартные вещи по-своему, чаще всего криво. На проекте все должно быть единообразно! Ваш проект TopJava - сделай все МАКСИМАЛЬНО в этом стиле. Если тебе кажется, что есть лучшее решение, чем в TopJava - пишите мне в личку, я всегда открыт для улучшений. -- **Рекомендую писать проект на востребованном на рынке стеке**: Spring Boot + Spring Data JPA (работа с БД) + Swagger/OpenAPI 3.0 (REST документация). **Оптимально подойдет код миграции TopJava на Spring Boot в конце стажировки**. +- **Рекомендую писать проект на востребованном на рынке стеке**: Spring Boot + Spring Data JPA (работа с БД) + Swagger/OpenAPI 3.0 (REST документация). +- **Оптимально подойдет код миграции TopJava на Spring Boot в конце стажировки или [курса BootJava](https://javaops.ru/view/bootjava)** *Представьте себе, что ПМ (лид, архитектор) дал вам ТЗ и некоторое время недоступен. У вас, конечно, есть много мыслей, для чего нужно приложение, как исправить ТЗ, дополнить его и сделать правильно. НО НЕ НАДО ИХ РЕАЛИЗОВЫВАТЬ В КОДЕ. Нужно сделать все строго по ТЗ, максимально просто, удобно для доработок и для использования со стороны клиента.* @@ -51,19 +52,19 @@ _Антуан де Сент-Экзюпери_ - 2.1: API продумывай с точки зрения не программиста и объектов, а с точки зрения того, кто им будет пользоваться (клиента, UI) - 2.1: Тщательно считайте количество запросов в вашем API для отображения нужной информации - 2.3: Из потребностей приложения (клиента) реализуй только очевидные сценарии. Необходимо и достаточно: ВСЕ НЕОБХОДИМОЕ для клиента и НИЧЕГО ЛИШНЕГО. Процесс творческий, приходит с опытом. -- 2.4: Делаем REST API в соответствии с концепцией REST (url в общем имеют вид`{ресурс}/{id_ресурсa}[/{подресурс}/{id_подресурсa}][параметры]`). Имена ресурсов во множественном числе! +- 2.4: Делаем REST API в соответствии с концепцией REST (url в общем имеют вид`{ресурс}/{id_ресурсa}[/{подресурс}/{id_подресурсa}][параметры]`, см. ниже ссылки про REST и иерархию). Имена ресурсов во множественном числе! Самая распространенная и грубая ошибка - не придерживаться этих простых правил. - **[15 тривиальных фактов о правильной работе с протоколом HTTP](https://habrahabr.ru/company/yandex/blog/265569/)** - **[10 Best Practices for Better RESTful API](https://medium.com/@mwaysolutions/10-best-practices-for-better-restful-api-cbe81b06f291)** - - [REST resource hierarchy](https://stackoverflow.com/questions/20951419/what-are-best-practices-for-rest-nested-resources) + - **[REST resource hierarchy](https://stackoverflow.com/questions/20951419/what-are-best-practices-for-rest-nested-resources)** - [Лучшие практики разработки REST API: правила 1-7,15-17](https://tproger.ru/translations/luchshie-praktiki-razrabotki-rest-api-20-sovetov/) - 2.5: Разделение на роли я предпочитаю на уровне URL. Сразу и однозначно видно, какой API у админа, какое у пользователя (API админа начинается, например, с */admin/...*). -- 2.6: На управление (CRUD) ресторанами и едой должны быть ОТДЕЛЬНЫЕ контроллеры. Не надо все, что может админ, сваливать в одну кучу! -- 2.7: Проверьте в Swagger, что в POST и PUT нет ничего лишнего, а в GET есть все необходимые данные. Например, при запросе голоса должен быть `id` ресторана, а при -создании-редактировании ресторана не должно быть меню и еды. +- 2.6: На управление (CRUD) ресторанами и едой должны быть ОТДЕЛЬНЫЕ контроллеры. Не надо все, что может админ, сваливать в одну кучу! Смотрите на результат операции - помещаете в этот контроллер! +- 2.7: Проверьте в Swagger, что в POST и PUT нет ничего лишнего, а в GET есть все необходимые данные. Например, при запросе голоса должен в ответе отображаться `id` ресторана, а не весь объект, при создании-редактировании ресторана в примерах swagger не должно быть меню и еды. - 2.8: `Profile` означает, что данные принадлежат профилю пользователя. Все остальное называйте по-другому. -- 2.9: Отсутствие данных часто бывает "бизнес кейсом", те НЕ ошибкой в запросе или приложении. В этом случае не надо исключений, просто возвращайте пустой ответ. - +- 2.9: Отсутствие данных часто бывает "бизнес кейсом", те НЕ ошибкой в запросе или приложении. Исключение - это ошибка, например неверный `id`. Запрос на данные, которые могут быть, могут нет, не должен приводить к исключениям. Посмотрите в сторону `ResponseEntity.of()` +- 2.10: По REST URL должно быть однозначно понятно, какие будут параметры на входе и что ждать на выходе. Без сюрпризов! + ### 3: Код: - 3.1: Строго соблюдайте соглашения Java по именованию: пакеты ТОЛЬКО маленькими буквами, методы начинаются с маленькой буквы, классы с большой. Незнания Java Core - тестовое задание сразу в корзину. - 3.2 В проекте (и тестовом задании на работу), в отличие от нашего учебного topjava, оставляйте только необходимый для работы по ТЗ приложения код, ничего лишнего @@ -78,7 +79,7 @@ _Антуан де Сент-Экзюпери_ ### 4: Модель -- 4.1: В БД обычно хранятся все введенные пользователем и админом данные (история). Они не удаляются и не переписываются заново. Есть базовые вещи, которые закладываются в архитектуру приложения, и есть неочевидные доработки к ТЗ, делать не надо. +- 4.1: В БД обычно хранятся все введенные пользователем и админом данные c возможность их редактирования. Это означает, что мы не удаляем прошлые меню, а храним их в базе, как и историю голосования. Есть базовые вещи, которые закладываются в архитектуру приложения, и есть неочевидные доработки к ТЗ, делать не надо. - 4.2: Не делайте в модели объектов, которые не будут использоваться в коде (например, не надо двунаправленных связей, если достаточно однонаправленных) - 4.3: еще раз про [hashCode/equals в Entity](https://stackoverflow.com/questions/5031614/the-jpa-hashcode-equals-dilemma): не делайте в модели сравнение по полям! - 4.4: ORM работает с объектами. [Иногда, для упрощения логики, fk_id как поля допустимы](https://stackoverflow.com/questions/6311776/hibernate-foreign-keys-instead-of-entities) @@ -86,7 +87,7 @@ _Антуан де Сент-Экзюпери_ ### 5: Архитектура / pom - 5.1: Можно: - или подключить DATA-REST (см.курс [Spring Boot 2.x + HATEOAS](https://javaops.ru/view/bootjava)). Контроллеры генерируются автоматически по репозиториям, требуется настройка ресурсов в кастомных контроллерах - - или делать на основе миграции TopJava / кода [TopJava-2](https://github.com/JavaOPs/topjava2) + - **РЕКОМЕНДУЕТСЯ** делать на основе миграции TopJava / кода [курса BootJava](https://javaops.ru/view/bootjava) Нельзя смешивать эти подходы вместе! Я рекомендую 2-й вариант, без data-rest. Обязательно посмотрите в Swagger, какие контроллеры получились в результате. - 5.2: Не размещайте бизнес-логику приложения и преобразования в TO в слое доступа к DB @@ -98,9 +99,8 @@ _Антуан де Сент-Экзюпери_ ### 6: Доступ к БД - 6.1: Используйте Spring Data JPA (без лишней делегации). Методы Repository можно вызывать напрямую из сервиса или из контроллера. -- 6.2: Если приложению в объекте требуется только его id, используйте reference (`getById`) -- 6.3: В DATA-JPA 2.x используются `Optional`. Попробуйте работать с ними, это безопасный способ работать с null-значениями (используйте `orElseThrow`) -- 6.4: Не делайте при обновлении записи ради экономии пары строчек кода так: +- 6.2: В DATA-JPA 2.x используются `Optional`. Попробуйте работать с ними, это безопасный способ работать с null-значениями (используйте `orElseThrow`) +- 6.3: Не делайте при обновлении записи ради экономии пары строчек кода так: ``` if(updateCondition) repository.delete(entity) @@ -115,14 +115,14 @@ repository.save(entity) - 7.2: Тщательно считайте количество обращений в базу на каждый запрос. Особенно при запросах от юзеров, которых очень много! Также на сложность запросов от них, чтобы не положить базу - 7.3: Сделайте [индексы к таблицам](https://ru.wikipedia.org/wiki/Индекс_(базы_данных)). Попробуйте обеспечить UNIQUE (один голос пользователя в день, один уникальный пункт меню в день). Следите за **порядком полей в индексе**, от этого зависит индексирование запросов. -- 7.4: При популировании добавь записи за сегодняшний день - `now()`, чтобы всегда были актуальные исходные данные +- 7.4: При популировании добавь записи за сегодняшний день - `now()`, чтобы всегда были актуальные исходные данные - 7.5: Поля базы case insensitive, не пишите camelStyle (для которых нужны кавычки) - 7.6: Таблицы обычно именуются в единственном числе. Исключение - `users`, `orders` и другие зарезервированные слова - 7.7: `date`/`timestamp` - зарезервированное слово, лучше избегать их при именовании полей ### 8: Security -- 8.1: Проверьте, станет ли код проще с `@AuthenticationPrincipal` (урок 11, Доступ к AuthorizedUser). +- 8.1: Проверьте, станет ли код проще с `@AuthenticationPrincipal` (урок 11, доступ к AuthorizedUser). - 8.2: Я предпочитаю четкое разделение ролей на основе URL. Для админа URL содержит `/admin` - 8.3: Еще раз - призываю не менять код TopJava @@ -134,8 +134,8 @@ repository.save(entity) ### 10: Валидация -- 10.1: Одних аннотаций валидации недостаточно. Должны быть `@Valid/@Validation` -- 10.2: Проверяйте входные данные при `create/update` в контроллерах! В TopJava это `ValidationUtil.checkNew()/assureIdConsistent()` +- 10.1: Одних аннотаций валидации на полях недостаточно. Должны быть `@Valid/@Validation` в контроллере +- 10.2: Прячте `id` при `create/update` в примерах Swagger. Если их передали - проверяйте на соответствие (в TopJava это `ValidationUtil.checkNew()/assureIdConsistent()`) ### 11: Дополнительно @@ -146,12 +146,13 @@ repository.save(entity) - 12.1: Поместите вначале `readme` ТЗ или **ссылку на него** - будет понятно о чем твой проект - 12.2: Если задание на English, описание пиши также на English (то же самое относится к языку резюме: вакансия на English предполагает резюме на English) -- 12.3: Требуемые примеры `curl` не прячьте, а пишите здесь! Оптимально здесь должна быть ссылка на `Swagger UI` с креденшелами для выполнения запросов +- 12.3: Требуемые примеры `curl` не прячьте, а пишите здесь! Оптимально сделать **ссылку на `Swagger UI` с креденшелами для выполнения запросов** - 12.4: Проверяют люди с опытом в Java: не надо писать инструкций, как устанавливать Java и Maven ### 13: Git - 13.1: Должна быть история ваших комитов с внятными комментариями. Это смотрят. +> Эйчар обращает внимание на дату создания аккаунта и то, как в него заливались коммиты (элементы проекта), постепенно или в один день, насколько технологии в аккаунте коррелируют с технологиями в резюме - 13.2: Не комить служенбые файлы: логи, DB, настройки IDEA и пр., это сразу - уровень Junior. - 13.3: Все служебные файлы должны быть в `.gitignore` @@ -165,3 +166,7 @@ repository.save(entity) - 13.2: API ДОЛЖЕН соответствовать принципам REST (см. ссылки выше) - 13.3: ОБЯЗАТЕЛЬНО: запустите `mvn test` - ошибок быть не должно - 13.4: ОБЯЗАТЕЛЬНО: запустите приложение без всяких предварительных настроек (базы, переменных окружения, ..), лучше на другом компьютере. Приложение должно запускаться и работать! + +## Оценка +ТЗ очень скромное, не дает понимания, что хочет получить заказчик, именно поэтому моих комментариев к этому ТЗ больше на 2 порядка. Это реальное тестовое задание на работу. При оценке учитывается отсутствие грубых ляпов, простота и красота решения + его расширяемость, если понадобится дорабатывать приложение. Если практический опыт небольшой, еще раз очень рекомендую держаться как можно ближе к нашему коду на Spring Boot. +Тестовое задание дается для того, чтобы оценить вас, как программиста. Нужны ли вы компании или нет. Это умение спроектировать грамотную модель и API, придерживаясь принципов REST и без своих велосипедов, и ваш чистый красивый код. diff --git a/pom.xml b/pom.xml index 0b1c2896da5b..cf231320e25d 100644 --- a/pom.xml +++ b/pom.xml @@ -9,7 +9,7 @@ 1.0-SNAPSHOT Calories Management - http://topjava.herokuapp.com/ + https://javaops-demo.ru/topjava 1.8 @@ -24,7 +24,7 @@ org.apache.maven.plugins maven-compiler-plugin - 3.8.1 + 3.14.0 ${java.version} ${java.version} diff --git a/src/main/java/ru/javawebinar/topjava/Main.java b/src/main/java/ru/javawebinar/topjava/Main.java index c2f9cc618f7c..723742bacade 100644 --- a/src/main/java/ru/javawebinar/topjava/Main.java +++ b/src/main/java/ru/javawebinar/topjava/Main.java @@ -1,7 +1,7 @@ package ru.javawebinar.topjava; /** - * @see Demo application + * @see Demo application * @see Initial project */ public class Main {