В Spring MVC аннотация @Valid ставится перед параметром метода-контроллера (объектом формы или DTO) и указывает фреймворку автоматически провести валидацию этого объекта при выполнении метода.
Если объект не проходит проверку Bean Validation-аннотаций, поведение зависит от типа контроллера и сигнатуры метода:
В обычном MVC-контроллере (возвращающем представление) ошибки не вызывают сразу исключение – они накапливаются в объекте BindingResult (если он указан параметром сразу после валидируемого объекта). Контроллер может проверить bindingResult.hasErrors() и вернуть пользовательскую форму обратно с сообщениями об ошибках.
В REST-контроллере (методы с @ResponseBody или @RestController) при отсутствии BindingResult Spring выбрасывает исключение MethodArgumentNotValidException автоматически при обнаружении невалидных данных. Это приводит к ответу с HTTP 400 (Bad Request) по умолчанию. Разработчик может перехватить это исключение (глобально через @ExceptionHandler) для формирования пользовательского ответа с ошибками.
Аннотация @Valid поддерживает каскадную валидацию: если у объекта есть вложенные объекты, помеченные также @Valid, то будут валидированы и они (например, адрес внутри пользователя и т.д.).
Spring также предоставляет аннотацию @Validated – она, помимо всего прочего, позволяет указывать группы валидации (см. раздел про группировку), но для простой ситуации с формой обычно достаточно @Valid.
Пояснение:
При обработке веб-запросов Spring MVC может автоматически проверять входящие данные, если разработчик отмечает соответствующие параметров контроллера аннотацией @Valid. Например, рассмотрим контроллер, обрабатывающий отправку формы регистрации пользователя:
@Controller
public class UserController {
@PostMapping("/register")
public String submitForm(@Valid @ModelAttribute("user") UserForm form, BindingResult result) {
if (result.hasErrors()) {
return "register-form"; // вернуть обратно шаблон формы при ошибках
}
// ... сохранить пользователя ...
return "redirect:/success";
}
}
Здесь параметр UserForm form помечен @Valid, поэтому до выполнения тела метода Spring проверит поля объекта form согласно аннотациям в классе UserForm. Если какие-то поля не прошли валидацию, Spring занесет соответствующие ошибки в объект BindingResult result. Контроллер затем может проверить result.hasErrors() и при наличии ошибок вернуть пользователя на страницу формы. Если же ошибок нет – продолжить обработку (например, сохранить данные и сделать редирект). Такой подход упрощает логику: мы декларативно указываем, что form нужно валидировать, и не вызываем валидатор вручную – проверка происходит автоматически перед вызовом метода контроллера
spring.io.
Для REST-контроллеров или методов, которые принимают, к примеру, JSON-данные (@RequestBody) и не возвращают HTML-страницу, механизм тот же: @Valid перед параметром заставит Spring проверить его. Однако в случае REST-контроллера обычно нет BindingResult рядом с параметром, поэтому при ошибке сразу генерируется исключение MethodArgumentNotValidException. Spring Boot по умолчанию преобразует его в ответ 400 Bad Request
. Чтобы вернуть более подробное описание ошибок (например, список всех полей с сообщениями), часто используются глобальные обработчики – об этом далее.
Отметим, что @Valid используется не только в контроллерах. Его можно применять для валидации полей класса (например, валидировать вложенный объект) – Hibernate Validator будет валидировать вложенные объекты при наличии аннотации @Valid на поле ссылочного типа. Также @Valid применима к параметрам методов сервисного уровня (в сочетании с @Validated на классе) и даже к возвращаемым значениям методов (если включить соответствующую опцию). В контексте Spring MVC основной сценарий – валидация входных данных пользователя при помощи @Valid в методах контроллеров.
Аннотация @Valid и автоматическая валидация в контроллерах
В Spring MVC аннотация @Valid ставится перед параметром метода-контроллера (объектом формы или DTO) и указывает фреймворку автоматически провести валидацию этого объекта при выполнении метода.
Если объект не проходит проверку Bean Validation-аннотаций, поведение зависит от типа контроллера и сигнатуры метода:
В обычном MVC-контроллере (возвращающем представление) ошибки не вызывают сразу исключение – они накапливаются в объекте BindingResult (если он указан параметром сразу после валидируемого объекта). Контроллер может проверить bindingResult.hasErrors() и вернуть пользовательскую форму обратно с сообщениями об ошибках.
В REST-контроллере (методы с @ResponseBody или @RestController) при отсутствии BindingResult Spring выбрасывает исключение MethodArgumentNotValidException автоматически при обнаружении невалидных данных. Это приводит к ответу с HTTP 400 (Bad Request) по умолчанию. Разработчик может перехватить это исключение (глобально через @ExceptionHandler) для формирования пользовательского ответа с ошибками.
Аннотация @Valid поддерживает каскадную валидацию: если у объекта есть вложенные объекты, помеченные также @Valid, то будут валидированы и они (например, адрес внутри пользователя и т.д.).
Spring также предоставляет аннотацию @Validated – она, помимо всего прочего, позволяет указывать группы валидации (см. раздел про группировку), но для простой ситуации с формой обычно достаточно @Valid.
Пояснение:
При обработке веб-запросов Spring MVC может автоматически проверять входящие данные, если разработчик отмечает соответствующие параметров контроллера аннотацией @Valid. Например, рассмотрим контроллер, обрабатывающий отправку формы регистрации пользователя:
@Controller
public class UserController {
@PostMapping("/register")
public String submitForm(@Valid @ModelAttribute("user") UserForm form, BindingResult result) {
if (result.hasErrors()) {
return "register-form"; // вернуть обратно шаблон формы при ошибках
}
// ... сохранить пользователя ...
return "redirect:/success";
}
}
Здесь параметр UserForm form помечен @Valid, поэтому до выполнения тела метода Spring проверит поля объекта form согласно аннотациям в классе UserForm. Если какие-то поля не прошли валидацию, Spring занесет соответствующие ошибки в объект BindingResult result. Контроллер затем может проверить result.hasErrors() и при наличии ошибок вернуть пользователя на страницу формы. Если же ошибок нет – продолжить обработку (например, сохранить данные и сделать редирект). Такой подход упрощает логику: мы декларативно указываем, что form нужно валидировать, и не вызываем валидатор вручную – проверка происходит автоматически перед вызовом метода контроллера
spring.io.
Для REST-контроллеров или методов, которые принимают, к примеру, JSON-данные (@RequestBody) и не возвращают HTML-страницу, механизм тот же: @Valid перед параметром заставит Spring проверить его. Однако в случае REST-контроллера обычно нет BindingResult рядом с параметром, поэтому при ошибке сразу генерируется исключение MethodArgumentNotValidException. Spring Boot по умолчанию преобразует его в ответ 400 Bad Request
. Чтобы вернуть более подробное описание ошибок (например, список всех полей с сообщениями), часто используются глобальные обработчики – об этом далее.
Отметим, что @Valid используется не только в контроллерах. Его можно применять для валидации полей класса (например, валидировать вложенный объект) – Hibernate Validator будет валидировать вложенные объекты при наличии аннотации @Valid на поле ссылочного типа. Также @Valid применима к параметрам методов сервисного уровня (в сочетании с @Validated на классе) и даже к возвращаемым значениям методов (если включить соответствующую опцию). В контексте Spring MVC основной сценарий – валидация входных данных пользователя при помощи @Valid в методах контроллеров.
Если объект не проходит проверку Bean Validation-аннотаций, поведение зависит от типа контроллера и сигнатуры метода:
В обычном MVC-контроллере (возвращающем представление) ошибки не вызывают сразу исключение – они накапливаются в объекте BindingResult (если он указан параметром сразу после валидируемого объекта). Контроллер может проверить bindingResult.hasErrors() и вернуть пользовательскую форму обратно с сообщениями об ошибках.
В REST-контроллере (методы с @ResponseBody или @RestController) при отсутствии BindingResult Spring выбрасывает исключение MethodArgumentNotValidException автоматически при обнаружении невалидных данных. Это приводит к ответу с HTTP 400 (Bad Request) по умолчанию. Разработчик может перехватить это исключение (глобально через @ExceptionHandler) для формирования пользовательского ответа с ошибками.
Аннотация @Valid поддерживает каскадную валидацию: если у объекта есть вложенные объекты, помеченные также @Valid, то будут валидированы и они (например, адрес внутри пользователя и т.д.).
Spring также предоставляет аннотацию @Validated – она, помимо всего прочего, позволяет указывать группы валидации (см. раздел про группировку), но для простой ситуации с формой обычно достаточно @Valid.
Пояснение:
При обработке веб-запросов Spring MVC может автоматически проверять входящие данные, если разработчик отмечает соответствующие параметров контроллера аннотацией @Valid. Например, рассмотрим контроллер, обрабатывающий отправку формы регистрации пользователя:
@Controller
public class UserController {
@PostMapping("/register")
public String submitForm(@Valid @ModelAttribute("user") UserForm form, BindingResult result) {
if (result.hasErrors()) {
return "register-form"; // вернуть обратно шаблон формы при ошибках
}
// ... сохранить пользователя ...
return "redirect:/success";
}
}
Здесь параметр UserForm form помечен @Valid, поэтому до выполнения тела метода Spring проверит поля объекта form согласно аннотациям в классе UserForm. Если какие-то поля не прошли валидацию, Spring занесет соответствующие ошибки в объект BindingResult result. Контроллер затем может проверить result.hasErrors() и при наличии ошибок вернуть пользователя на страницу формы. Если же ошибок нет – продолжить обработку (например, сохранить данные и сделать редирект). Такой подход упрощает логику: мы декларативно указываем, что form нужно валидировать, и не вызываем валидатор вручную – проверка происходит автоматически перед вызовом метода контроллера
spring.io.
Для REST-контроллеров или методов, которые принимают, к примеру, JSON-данные (@RequestBody) и не возвращают HTML-страницу, механизм тот же: @Valid перед параметром заставит Spring проверить его. Однако в случае REST-контроллера обычно нет BindingResult рядом с параметром, поэтому при ошибке сразу генерируется исключение MethodArgumentNotValidException. Spring Boot по умолчанию преобразует его в ответ 400 Bad Request
. Чтобы вернуть более подробное описание ошибок (например, список всех полей с сообщениями), часто используются глобальные обработчики – об этом далее.
Отметим, что @Valid используется не только в контроллерах. Его можно применять для валидации полей класса (например, валидировать вложенный объект) – Hibernate Validator будет валидировать вложенные объекты при наличии аннотации @Valid на поле ссылочного типа. Также @Valid применима к параметрам методов сервисного уровня (в сочетании с @Validated на классе) и даже к возвращаемым значениям методов (если включить соответствующую опцию). В контексте Spring MVC основной сценарий – валидация входных данных пользователя при помощи @Valid в методах контроллеров.
Автор: к.п.н., Румянцев Сергей Александрович, доцент Финансового университета при Правительстве РФ; доцент ОЧУВО Международного инновационного университета; Консалтинг, управление разработкой ПО; системный и бизнес анализ; менеджмент; аналитиз данных; управление ИТ. Телефон для связи +79269444818 (мессенджеры)
Короткая ссылка:
В Spring MVC аннотация @Valid ставится перед параметром метода-контроллера (объектом формы или DTO) и указывает фреймворку автоматически провести валидацию этого объекта при выполнении метода.
Если объект не проходит проверку Bean Validation-аннотаций, поведение зависит от типа контроллера и сигнатуры метода:
В обычном MVC-контроллере (возвращающем представление) ошибки не вызывают сразу исключение – они накапливаются в объекте BindingResult (если он указан параметром сразу после валидируемого объекта). Контроллер может проверить bindingResult.hasErrors() и вернуть пользовательскую форму обратно с сообщениями об ошибках.
В REST-контроллере (методы с @ResponseBody или @RestController) при отсутствии BindingResult Spring выбрасывает исключение MethodArgumentNotValidException автоматически при обнаружении невалидных данных. Это приводит к ответу с HTTP 400 (Bad Request) по умолчанию. Разработчик может перехватить это исключение (глобально через @ExceptionHandler) для формирования пользовательского ответа с ошибками.
Аннотация @Valid поддерживает каскадную валидацию: если у объекта есть вложенные объекты, помеченные также @Valid, то будут валидированы и они (например, адрес внутри пользователя и т.д.).
Spring также предоставляет аннотацию @Validated – она, помимо всего прочего, позволяет указывать группы валидации (см. раздел про группировку), но для простой ситуации с формой обычно достаточно @Valid.
Пояснение:
При обработке веб-запросов Spring MVC может автоматически проверять входящие данные, если разработчик отмечает соответствующие параметров контроллера аннотацией @Valid. Например, рассмотрим контроллер, обрабатывающий отправку формы регистрации пользователя:
@Controller
public class UserController {
@PostMapping("/register")
public String submitForm(@Valid @ModelAttribute("user") UserForm form, BindingResult result) {
if (result.hasErrors()) {
return "register-form"; // вернуть обратно шаблон формы при ошибках
}
// ... сохранить пользователя ...
return "redirect:/success";
}
}
Здесь параметр UserForm form помечен @Valid, поэтому до выполнения тела метода Spring проверит поля объекта form согласно аннотациям в классе UserForm. Если какие-то поля не прошли валидацию, Spring занесет соответствующие ошибки в объект BindingResult result. Контроллер затем может проверить result.hasErrors() и при наличии ошибок вернуть пользователя на страницу формы. Если же ошибок нет – продолжить обработку (например, сохранить данные и сделать редирект). Такой подход упрощает логику: мы декларативно указываем, что form нужно валидировать, и не вызываем валидатор вручную – проверка происходит автоматически перед вызовом метода контроллера
spring.io.
Для REST-контроллеров или методов, которые принимают, к примеру, JSON-данные (@RequestBody) и не возвращают HTML-страницу, механизм тот же: @Valid перед параметром заставит Spring проверить его. Однако в случае REST-контроллера обычно нет BindingResult рядом с параметром, поэтому при ошибке сразу генерируется исключение MethodArgumentNotValidException. Spring Boot по умолчанию преобразует его в ответ 400 Bad Request
. Чтобы вернуть более подробное описание ошибок (например, список всех полей с сообщениями), часто используются глобальные обработчики – об этом далее.
Отметим, что @Valid используется не только в контроллерах. Его можно применять для валидации полей класса (например, валидировать вложенный объект) – Hibernate Validator будет валидировать вложенные объекты при наличии аннотации @Valid на поле ссылочного типа. Также @Valid применима к параметрам методов сервисного уровня (в сочетании с @Validated на классе) и даже к возвращаемым значениям методов (если включить соответствующую опцию). В контексте Spring MVC основной сценарий – валидация входных данных пользователя при помощи @Valid в методах контроллеров.
https://webprogr.ru/~W2tCL
Если объект не проходит проверку Bean Validation-аннотаций, поведение зависит от типа контроллера и сигнатуры метода:
В обычном MVC-контроллере (возвращающем представление) ошибки не вызывают сразу исключение – они накапливаются в объекте BindingResult (если он указан параметром сразу после валидируемого объекта). Контроллер может проверить bindingResult.hasErrors() и вернуть пользовательскую форму обратно с сообщениями об ошибках.
В REST-контроллере (методы с @ResponseBody или @RestController) при отсутствии BindingResult Spring выбрасывает исключение MethodArgumentNotValidException автоматически при обнаружении невалидных данных. Это приводит к ответу с HTTP 400 (Bad Request) по умолчанию. Разработчик может перехватить это исключение (глобально через @ExceptionHandler) для формирования пользовательского ответа с ошибками.
Аннотация @Valid поддерживает каскадную валидацию: если у объекта есть вложенные объекты, помеченные также @Valid, то будут валидированы и они (например, адрес внутри пользователя и т.д.).
Spring также предоставляет аннотацию @Validated – она, помимо всего прочего, позволяет указывать группы валидации (см. раздел про группировку), но для простой ситуации с формой обычно достаточно @Valid.
Пояснение:
При обработке веб-запросов Spring MVC может автоматически проверять входящие данные, если разработчик отмечает соответствующие параметров контроллера аннотацией @Valid. Например, рассмотрим контроллер, обрабатывающий отправку формы регистрации пользователя:
@Controller
public class UserController {
@PostMapping("/register")
public String submitForm(@Valid @ModelAttribute("user") UserForm form, BindingResult result) {
if (result.hasErrors()) {
return "register-form"; // вернуть обратно шаблон формы при ошибках
}
// ... сохранить пользователя ...
return "redirect:/success";
}
}
Здесь параметр UserForm form помечен @Valid, поэтому до выполнения тела метода Spring проверит поля объекта form согласно аннотациям в классе UserForm. Если какие-то поля не прошли валидацию, Spring занесет соответствующие ошибки в объект BindingResult result. Контроллер затем может проверить result.hasErrors() и при наличии ошибок вернуть пользователя на страницу формы. Если же ошибок нет – продолжить обработку (например, сохранить данные и сделать редирект). Такой подход упрощает логику: мы декларативно указываем, что form нужно валидировать, и не вызываем валидатор вручную – проверка происходит автоматически перед вызовом метода контроллера
spring.io.
Для REST-контроллеров или методов, которые принимают, к примеру, JSON-данные (@RequestBody) и не возвращают HTML-страницу, механизм тот же: @Valid перед параметром заставит Spring проверить его. Однако в случае REST-контроллера обычно нет BindingResult рядом с параметром, поэтому при ошибке сразу генерируется исключение MethodArgumentNotValidException. Spring Boot по умолчанию преобразует его в ответ 400 Bad Request
. Чтобы вернуть более подробное описание ошибок (например, список всех полей с сообщениями), часто используются глобальные обработчики – об этом далее.
Отметим, что @Valid используется не только в контроллерах. Его можно применять для валидации полей класса (например, валидировать вложенный объект) – Hibernate Validator будет валидировать вложенные объекты при наличии аннотации @Valid на поле ссылочного типа. Также @Valid применима к параметрам методов сервисного уровня (в сочетании с @Validated на классе) и даже к возвращаемым значениям методов (если включить соответствующую опцию). В контексте Spring MVC основной сценарий – валидация входных данных пользователя при помощи @Valid в методах контроллеров.
Короткая ссылка на новость:https://webprogr.ru/~W2tCL
Последние новости