# TopJava Release Notes ### TopJava 26 - починили шаблоны запросов на создание в Swagger через [ApiModelProperty](https://www.baeldung.com/spring-swagger-hide-field) - в новой версии Data JPA `getById`->`getReferenceById` - мелкие правки ### TopJava 25 - поправил `NoHtmlValidator`: `Jsoup.clean().equals` -> `Jsoup.isValid` - починил `role VARCHAR NOT NULL` - добавил нового тестового пользователя `guest` ### TopJava 24 - migrate to LTS JDK 17 - add `AbstractBaseEntity.id()` - fix for `User.registered`: `@Column(..., updatable = false)` - add `@QueryHints` in `CrudUserRepository` - add loggin in `RootController` - fix `@Sql(.., , executionPhase = Sql.ExecutionPhase.AFTER_TEST_METHOD)` for controller tests after service tests - rename `MATCHER` to `USER_MATCHER/MEAL_MATCHER` - treat in `ActiveDbProfileResolver` attribute `profiles` ### TopJava 23 - migrate to JDK 16 - в новой spring-data-jpa `getOne` заменили на `getById` - в UserUtil#prepareToSave убрал проверку пароля на `hasText`. На UI поле проверяется на `@NotBlank` - `ProfileRestController#register` делаю по правилам REST (POST без "/register") - css стили `data-...` сделал [low-case через дефисы](https://stackoverflow.com/questions/36176474/548473) - `TestMatcher` переименовал в `MatcherFactory` - Для Swagger UI пометил `AuthorizedUser` аннотацией `@ApiIgnore` ### TopJava 22 - очистка пароля `AuthorizedUser#userTo` - заменил `@SafeHtml`, который удалили из `hibernate.validator` на [Jsoup.clean](https://stackoverflow.com/a/68888601/548473) - перенес запрет на обновление admin/user в `UserService` - проверку email на уникальность для update с `id=null` в теле запроса сделал на основе анализа `HttpServletRequest.getRequestURI()` - проверку класса в `classpath` в `Profiles#getActiveDbProfile` делаю на `org.springframework.util.ClassUtils#isPresent` - удалил `type="text/javascript"` ### TopJava 21 - **добавили документирование REST API: Swagger** - мигрировали на JDK 15 и используем текстовые блоки - Вынес `produces = MediaType.APPLICATION_JSON_VALUE` на уровень контроллеров - Правильно используем [глабальные переменные в js](https://stackoverflow.com/a/5064235/548473) - Зарефакторил `inputField.tag` - Тестовые переменные переименовал из UPPERCASE в camelCase - Из тестов сервисов убрал `throws Exception` (в IDEA больше не генерятся по умолчанию) - **Мигрировали на Spring Boot 2.4.1** ### TopJava 20 - мигрировали на JDK 14 - в `@SafeHtml` запрещаем весь html (`whitelistType = NONE`) - в `topjava.common.js` в `makeEditable()` вместо объекта контекст передаю 3 параметра - в UI контроллерах убрал префикс `ajax` - из тестов сервисов убрал `repository`. При проверке через `assertThrows` он не требуется - в `TestMatcher` сценарии сравнения сделал параметризируемыми (паттерн стратегия) - в API добавили `/users/{id}/with-meals` (см. [двунаправленные отношения](https://www.codeflow.site/ru/article/jackson-bidirectional-relationships-and-infinite-recursion)) - добавил `UserTestData.USER_WITH_MEALS_MATCHER` (проверки пользователя сразу с едой) и константу id `NOT_FOUND` ### TopJava 19 - Изменилась логика для интервалов времени (исключаем `endTime`) - Заменил собственный `MessageUtil` велосипед на спринговый `MessageSourceAccessor` - В ролях убрал префиксы `ROLE_` ([Role and GrantedAuthority](https://stackoverflow.com/a/19542316/548473)) - Добавился удобный метод `int AbstractBaseEntity.id()` - Фикс `Location` в `ProfileRestController.register` - Фикс валидации `UniqueMailValidator` для REST update без `user.id` - Заменил `jdbc.initLocation` на полный путь - IDEA не ругается - В конфигурации `cargo-maven2-plugin` сделал [индивидуальный контекст приложения](https://stackoverflow.com/a/60797999/548473) - Тесты - Обновил даты еды на 2020г. - Зарефакторил тесты сервисов на удаление - `NotFoundException` может бросаться при `delete()` - В тестах контроллеров вернулся к реализации без обертки над `MockMvcRequestBuilders` - Для `InMemory` тестов подключаю только `inmemory.xml` (добавил туда необходимую конфигурацию из `spring-app.xml`) ### TopJava 18 - В `ErrorType` добавил `HttpStatus status` - В PostgreSQL обнаружилась бага: граничное значение `0:00` из-за ошибок округления попадает в предыдущий интервал. Мораль: всегда в тестах проверяйте граничные значения. Добавил этот случай в тестовые данные. - Изменил `MealRepository.getBetween` (принимаю `@Nullable LocalDate`). Изменились реализации. - Выделил метод `UserService.prepareAndSave` - В TO поля сделал `final`, используем `@ConstructorProperties` - Наконец локализировал описание приложения на страничке входа - Для полей ввода дат добавил `autocomplete="off"` - При закрытии модального окна закрываю окно ошибок - Тесты: - **Вместо очистки кэшей перед каждым тестом отключаем кэши для всех тестов** - **Вынес общий код тестирования контроллеров в `AbstractControllerTest`. Код тестов значительно сократился** - **Сделал типизированный `TestMatchers` для проверки результатов тестов. В классах `UserTestData` и `MealTestData` создаю его инстансы с заданным типом и методикой сравнения.** - В тестах `delete` и `create` проверяю результат напрямую (не через `getAll`) ### TopJava 17 - Удалил `Impl` из названий репозиториев - Удалил интерфейсы к сервисам, использую классы - Добавил `AdminRestController.enable`, вызов через PATCH метод - Добавил валидацию для jdbc через Bean Validation API - Перенес работу в UI с профилем из `RootController` в `ProfileUIController` - `SLF4JBridgeHandler` инициализирую только в профиле `postgres` ### TopJava 16 - Выделил общий код реализации хранения в памяти в `InMemoryBaseRepositoryImpl` - Сделал подтверждение для удаления записей - Обновились видео 7-го занятия. [Выложил его как пример занятия, некоторые видео открыты](https://github.com/JavaOPs/topjava/blob/master/doc/lesson07.md) - Сделали валидации дублирования email через `WebDataBinder` и `Validator` ### TopJava 15 - Миграция на Servlet API 4.0 / Tomcat 9.x - [Миграция на JDK11](http://javaops.ru/view/resources/jdk8_11) - JUnit5 fix: junit-platform-surefire-provider не нужен - Рефакторинг тестов: - в `RootControllerTest.testUsers` для проверки используем `AssertionMatcher` адаптер - вместо `content().json()` от `jsonassert` десериализуем json и используем сравнения через `AssertJ` - В javascript место глабальных переменных и одинаковой функции обновления таблицы задаю их в объекте контекст, который передаю в `makeEditable()` как параметр - Починил `back` в браузере после логина. Кнопки входа и регистрации отображаю только для `isAnonymous()` ### TopJava 14 - [Миграция на JUnit 5](http://javaops.ru/view/resources/junit5) - Для измерения времени в тестах использую [Spring StopWatch](https://www.logicbig.com/how-to/code-snippets/jcode-spring-framework-stopwatch.html) - `SimpleJdbcInsert` и `NamedParameterJdbcTemplate` конструируются (и берут настройки) из `jdbcTemplate` - `AuthorizedUser` зарефакторился в `SecurityUtil` - В javascript [заменил `var` на `let/const`](https://learn.javascript.ru/let-const). [Поддержка 95% браузеров](https://caniuse.com/#feat=const) - Подправил UI фильтрации и заголовка страниц, добавилась кнопка `Cancel` в профиль - Починил [баг в FireFox](https://bugzilla.mozilla.org/show_bug.cgi?id=884693): пустой ответ по ajax - Сделал вход в приложение при нажании кнопок `Зайти как ...` - Добавил регистрацию пользователя по REST - Преименовал js файлы согласно [javascript filename naming convention](https://stackoverflow.com/questions/7273316/what-is-the-javascript-filename-naming-convention) - Сделал проверку startTime/endTime на фильтре времени (после обновления datetimepicker до 2.5.20) ### TopJava 13 - [Миграция на Botstrap 4](https://getbootstrap.com/docs/4.1/migration/) - Добавил [Responsive behaviors](https://getbootstrap.com/docs/4.1/components/navbar/#responsive-behaviors) - при уменшении ширины экрана навигация сворачивается в кнопку - Для отображения цвета еды и выключенного юзера использую [data-* атрибуты](https://developer.mozilla.org/ru/docs/Web/Guide/HTML/Using_data_attributes) - В `inputField.tag` передаю как параметр код для локализации label, а в `i18n.jsp` передаю как параметр `page`. См. [JSP include action with parameter example](https://beginnersbook.com/2013/12/jsp-include-with-parameter-example) ### TopJava 12 - [Миграция на Spring 5](http://javaops.ru/view/resources/spring5) - обновил версии: Ehcache 3.x, datatables, datetimepicker - добавил видео решений HW0 с одним проходом - поправил видео [Обзор Spring Framework. Spring Context](https://drive.google.com/file/d/1fBSLGEbc7YXBbmr_EwEHltCWNW_pUmIH). Дописал про Constructor injection. - заменил видео про тетсирование сервисов. Вместо самодельных матчеров стали использовать [AssertJ](http://joel-costigliola.github.io/assertj/index.html). Видео [Тестирование UserService через AssertJ](https://drive.google.com/open?id=1SPMkWMYPvpk9i0TA7ioa-9Sn1EGBtClD), время 1:53 - сделал [видео с jQuery конвертерами и дефолтными группами валидации при сохранении в базу](https://drive.google.com/open?id=1tOMOdmaP5OQ7iynwC77bdXSs-13Ommax) - сделал [видео с новым `DelegatingPasswordEncoder` и Json READ/WRITE access](https://drive.google.com/file/d/1XZXvOThinzPw4EhigAUdo8-MWT_g8wOt/view?usp=sharing) - убрал `AccessType.PROPERTY` для `AbstractBaseEntity.id` (см. [fixed HHH-3718](https://hibernate.atlassian.net/browse/HHH-3718)) - удалил `PasswordUtil`, возвращаю статус `NO_CONTENT` для REST delete, убрал группы валидации в `UserTo` - заменил в jQuery [success на done](https://stackoverflow.com/a/22213543/548473) - вместо `lang.jsp` сделал общий `bodyHeader.jsp` ### TopJava 11 - добавил - доп. решение HW1 через одним return и O(N) - раскрасил лог ([Logback layouts coloring](https://logback.qos.ch/manual/layouts.html#coloring)) - рефакторинг - починил коммит формы по cancel (`history.back()`) в FireFox - заменил неработающий DependencyCi на [VersionEye](https://www.versioneye.com/) c проверкой зависимостей на uptodate - починил `CrudUserRepository.getWithMeals()` через `@EntityGraph`. С неколькими ролями (у админа) еда дублируется - починил тесты контроллеров с профилем JDBC (`JpaUtil` отсутствует в контексте JDBC) - переименовал `meal.jsp/user.jsp` в `mealForm.jsp/userForm.jsp` - в `InMemoryMealRepositoryImpl.save()` сделал update атомарным - переименовал методы сервисов `save` в `create` - переименовал и cделал классы `BaseEntity` и `NamedEntity` абстрактными - обновил Noty и API с ним до 3.1.0. Добавил glyphicon в сообщения Noty - заменил `MATCHER_WITH_EXCEED` на валидацию через [JSONassert](https://github.com/skyscreamer/JSONassert). - поменял Deprecated валидаторы `org.hibernate.validator.constraints` на `javax.validation.constraints` - убрал пароль из результатов REST через [@JsonProperty READ_ONLY / WRITE_ONLY](https://stackoverflow.com/questions/12505141/only-using-jsonignore-during-serialization-but-not-deserialization/12505165#12505165). Тесты на REST пришлось починить добавлением добавлением в JSON пароля как дополнительного параметра (`JsonUtil.writeWithExtraProps`) - **убрал JSON View и сделал преобразование времени на UI с помощью [jQuery converters](http://api.jquery.com/jQuery.ajax/#using-converters)** - **поменял [группу валидации по умолчанию при сохранении через JPA](https://stackoverflow.com/questions/16930623/16930663#16930663).** Теперь все валидаторы в модели работаю по умолчанию (`groups` не требуется). - Добавил в `ErrorInfo` тип ошибки `ErrorType` + i18n. - правки - переименовал `ModelMatcher` в `BeanMatcher` и починил: можно сравнивать только упорядоченные коллекции (List) - поменял зависимость `org.hibernate:hibernate-validator` на `org.hibernate.validator:hibernate-validator` (warning при сборке) ### TopJava 10 - добавил - доступ к AuthorizedUser через [`@AuthenticationPrincipal`](http://docs.spring.io/spring-security/site/docs/current/reference/htmlsingle/#mvc-authentication-principal) и [authentication Tag](http://docs.spring.io/spring-security/site/docs/current/reference/html/taglibs.html#the-authentication-tag) - [Обработку 404 NotFound](https://stackoverflow.com/questions/18322279/spring-mvc-spring-security-and-error-handling) - локализацию ошибок валидации - проверки json в тестах через [JSONassert](https://github.com/skyscreamer/JSONassert) и [через jsonPath](https://www.petrikainulainen.net/programming/spring-framework/integration-testing-of-spring-mvc-applications-write-clean-assertions-with-jsonpath/) - [логирование от Postgres Driver](http://stackoverflow.com/a/43242620/548473) - в `.travis.yml` [сборку только ветки master](https://docs.travis-ci.com/user/customizing-the-build#Building-Specific-Branches) - [защиту от кэширование ajax запросов в IE](https://stackoverflow.com/a/4303862/548473) - обработку запрета модификации системный юзеров через универсальный `ApplicationException` - рефакторинг - сделал `@EntityGraph` через `attributePaths` - реализаовал обработку дублирования `user.email` и `meal.dateTime` через [Controller Based Exception Handling](https://spring.io/blog/2013/11/01/exception-handling-in-spring-mvc#controller-based-exception-handling) - поменял отключение транзакционности в тестах через `@Transactional(propagation = Propagation.NEVER)` - сделал выбор в сервлете через switch - [все логгирование сделал через {} форматирование](http://stackoverflow.com/questions/10555409/logger-slf4j-advantages-of-formatting-with-instead-of-string-concatenation) и поправил его в контроллерах (поле проверки id) - [перешел на конструктор DI](http://stackoverflow.com/questions/39890849/what-exactly-is-field-injection-and-how-to-avoid-it) - в `ModelMatcher` переименовал `Comparator` -> `Equality` - [заинлайнил все лямбды](http://stackoverflow.com/questions/19718353/is-repeatedly-instantiating-an-anonymous-class-wasteful) (компараторы, ModelMatcher.equality) - поменялась реализация `JdbcUserRepositoryImpl.getAll()` - на UI кнопки в таблице заменились на линки, поправил сообщения локализации - [сделал кастомизацию JSON (@JsonView) и валидацию (groups)](https://drive.google.com/file/d/0B9Ye2auQ_NsFRTFsTjVHR2dXczA) для данных еды, отдаваемых на UI - в `JdbcUserRepositoryImpl` поменял `MapSqlParameterSource` на `BeanPropertySqlParameterSource` - удалил - зависимость `javax.transaction.jta` (уже не нужна) - `${spring.version}` в `pom.xml` зависимостях (уже есть в `spring-framework-bom`) - distinct из запроса Hibernate на пользователей с ролями. [Оптимизация запроса distinct: 15.16.2](https://docs.jboss.org/hibernate/orm/5.2/userguide/html_single/Hibernate_User_Guide.html#hql-distinct) - лишние `