Файл application.properties

Большой список всевозможных свойств и описаний к ним

https://docs.spring.io/spring-boot/docs/current/reference/html/appendix-application-properties.html#data-properties

Получение значения параметра свойства

Надо пометить переменную наподобие такого

@Value("${app.rest.employee.count-on-page}") /* работает только на не статическом поле*/
public int countOnPage;

---

Spring инициализация

Запуск своего кода при загрузке Spring

@Component
private class Starter implements CommandLineRunner {
   @Override
   public void run(String... args) {
      //todo
   }
}

---

i18n Internalization

Поддержка языков при использовании Spring Boot.

Достаточно определить бин:

	@Bean
	public MessageSource messageSource() {
		ReloadableResourceBundleMessageSource messageSource = new ReloadableResourceBundleMessageSource();
		messageSource.setCacheSeconds(3600); //refresh cache once per hour
		messageSource.setDefaultEncoding("UTF-8");
		messageSource.setFallbackToSystemLocale(false);
		messageSource.setBasenames("classpath:locale/messages/app");
		return messageSource;
	}

И разместить бандлы в указанном месте (locale/messages/app). Т.е.:

src/main/resources/locale/messages/app.properties

и
src/main/resources/locale/messages/app_ru.properties

В этом случае если браузер желает русскую локаль, то ему будет отдан app_ru.properties, в противном случае — app.properties

Также можно переопределить логику определения текущей локали с помощют объявления бина :

@Bean
	public LocaleResolver localeResolver() {
		SessionLocaleResolver slr = new SessionLocaleResolver();
		slr.setDefaultLocale(Locale.forLanguageTag("ru"));
		return slr;
	}

Если этого не сделать SpringBoot будет использовать

org.springframework.web.servlet.i18n.AcceptHeaderLocaleResolver.class
в нём можно ставить брейкпоинты.

Таким образом, если не переопределять LocaleResolver, то локаль будет определяться их хэдеров запроса.

Более подробно написано тут https://knasys.ru/spring-boot-i18n-thymeleaf/

---

Аннотации

Как переиспользлвать настроенную аннотацию @Pattern

Если Вы много где используете настроенную аннотацию @Pattern, например,

, то Вы можете её сохранить как свою кастомную аннотацию так:

import javax.validation.Constraint;
import javax.validation.Payload;
import javax.validation.constraints.Pattern;
import java.lang.annotation.Documented;
import java.lang.annotation.Retention;
import java.lang.annotation.Target;

import static java.lang.annotation.ElementType.*;
import static java.lang.annotation.ElementType.TYPE_USE;
import static java.lang.annotation.RetentionPolicy.RUNTIME;


@Pattern(regexp = "^\\+[0-9]{11,16}$", message = "{constraints.phoneIncorrectFormat}")
@Target({ METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER, TYPE_USE })
@Retention(RUNTIME)
@Documented
@Constraint(validatedBy = { })
public @interface PhonePattern {

    /**
     * @return the error message template
     */
    String message() default "{constraints.phoneIncorrectFormat}";

    /**
     * @return the groups the constraint belongs to
     */
    Class<?>[] groups() default { };

    /**
     * @return the payload associated to the constraint
     */
    Class<? extends Payload>[] payload() default { };
}

Использование констант в @PreAuthorize и thymeleaf sec:authoriz

https://stackoverflow.com/questions/64795958/spring-security-rolesallowed-and-thymeleaf-secauthorize

@Controller
//@PreAuthorize("hasAnyRole(T(ru.knastnt.prj.web.admin.MenuEditorController).ALLOWED_ROLES)")
@PreAuthorize("hasAnyRole(@menuEditorController.ALLOWED_ROLES)")
public class MenuEditorController {
    public static final String[] ALLOWED_ROLES = {Role.ADMIN.toString(), Role.EDITOR.toString()};
    ...
}

<ul th:fragment = "nav-default">
    <li sec:authorize="hasAnyRole(@menuEditorController.ALLOWED_ROLES)"><a th:href="@{${@menuEditorController.MENU_EDITOR_URL}}">menu editor</a></li>
</ul>

Отличие @Valid от @Validated

@Valid это «стандартная» аннотация для валидации бина, не привязанная к Спрингу. Даже если вместо Спринга ты будешь использовать другой фреймворк, она будет работать. А вот @Validated относится уже конкретно к Спрингу, т.е. она не «переносимая». Цель та же, что и у @Valid, но со всякими плюшками, например — наличие возможности указать группы валидации.

@Valid еще нужна, если нужно валидировать поля сложного объекта, объектов коллекций и массивов, иначе валидатор пройдется только по верхам.

@NotEmpty List<@NotEmpty String> list; — сработает только на объект списка, что список непустой, внутрянку не проверит.
@Valid @NotEmpty List<@NotEmpty String> list; — проверит и строки внутри коллекции.

Аннотацию @Validated можно проверить если ее установить над классом контроллера, когда аргументом метода является коллекция и ее нужно отвалидировать, без нее валидатор не работает.

 

Спасибо за ответы Evgeny Nagorny, Sergey Zhukov.

---

Тестирование

Подмена бина при тестировании

Просто объявляем этот бин в конфигурации, используя другое имя. А затем автовайрим с использованием аннотации Qualifier. Класс теста:

@SpringBootTest
@ContextConfiguration(classes = {SmsDeliveryServiceImplTestConfig.class})
class SmsDeliveryServiceTest {

    @Autowired
    @Qualifier("SmsDeliveryServiceForTesting")
    SmsDeliveryService smsDeliveryService;

    @Test
    void testmethod() {
    .........

Класс конфигурации:

@TestConfiguration
class SmsDeliveryServiceImplTestConfig {
    @Bean(name = "SmsDeliveryServiceForTesting")
    public SmsDeliveryService smsDeliveryService(SmsSender smsSender) {
        Duration[] smsPauseTime = new Duration[]{
                Duration.ofMillis(200),
                Duration.ofMillis(600),
                Duration.ofMillis(1400)
        };
        Duration timeForResetPauseTime = Duration.ofMillis(2500);
        TemporalUnit temporalUnit = ChronoUnit.MILLIS;
        return new SmsDeliveryService(smsSender, smsPauseTime, timeForResetPauseTime, temporalUnit);
    }
}

Изменение авторизованного пользователя в тесте

Вот тут я задавал вопрос и описывал свою проблему. Там же сам себе ответил. https://stackoverflow.com/questions/64812736/change-authorized-user-in-tests

@Test
    void allMenusAuthorizePermissions() throws Exception {

        for (User user : ALL_ROLES_USERS) {
            log.debug("User role: " + user.getAuthorities());

            if (user == ADMIN || user == EDITOR) {
//              perform(get(MenuEditorController.MENU_EDITOR_URL).with(SecurityMockMvcRequestPostProcessors.user(user.getUsername()).authorities(user.getAuthorities())))
                perform(get(MenuEditorController.MENU_EDITOR_URL).with(SecurityMockMvcRequestPostProcessors.user(user)))
                        .andExpect(status().isOk());
            }else{
                perform(get(MenuEditorController.MENU_EDITOR_URL).with(SecurityMockMvcRequestPostProcessors.user(user)))
                        .andExpect(status().isForbidden());
            }

        }
    }

---

Thymeleaf

Синтаксис

Учебник Thymeleaf: Глава 4. Standard Expression Syntax

th:href со ссылкой на контроллер

Во-первых, зачем писать th:href=»@{/path}» когда можно написать просто href=»/path»? Вот зачем.

Во-вторых чтобы сослаться на какой-то бин в контексте из thymeleaf, можно использовать конструкцию ${@menuEditorController.MENU_EDITOR_URL}, где menuEditorController — имя бина (по-умолчанию это имя класса с маленькой буквы), MENU_EDITOR_URL — какая-то статическая константа (можно также ссылаться и на методы).

Ну и к делу:

<ul th:fragment = "nav-default">
    ...
    <li sec:authorize="hasAnyRole(@menuEditorController.ALLOWED_ROLES)">
        <a th:href="@{${@menuEditorController.MENU_EDITOR_URL}}">Редактор меню</a>
    </li>
    ...
</ul>

@Controller
@RequestMapping(MENU_EDITOR_URL)
@PreAuthorize("hasAnyRole(@menuEditorController.ALLOWED_ROLES)")
public class MenuEditorController {
    public static final String MENU_EDITOR_URL = ADMIN_URL + "/menu";
    public static final String[] ALLOWED_ROLES = {Role.ADMIN.toString(), Role.EDITOR.toString()};
    ...
}