Проверка данных формы с помощью аннотаций (@Size, @Email и др) в Spring MVC

Эта статья является продолжением статьи о формах в Spring и о проверке введенных пользователем данных. Будут рассмотрены аннотации, заменяющие валидатор.

Чтобы указать параметры проверки имя пользователя будем использовать следующие аннотации:

@NotBlank
@Size(min=3, max=16)
private String username;

Аннотация @Email используется для проверки правильности введенного email'а:

@Email
private String email;

Увы, нет стандартной аннотации, которая проверяет совпадение значений двух полей (в нашем случае - password и confirmPassword). Такую аннотацию мы создадим в следующей статье.

То есть, окончательный вариант класса SignupForm будет выглядеть следующим образом:

package com.seostella.springfa.form;

import javax.validation.constraints.Size;

import org.hibernate.validator.constraints.Email;
import org.hibernate.validator.constraints.NotBlank;

public class SignupForm {
	@NotBlank
	@Size(min=3, max=16)
	private String username;
	
	@NotBlank
	private String password;
	
	@NotBlank
	private String confirmPassword;
	
	@Email
	private String email;
	
	public String getUsername() {
		return username;
	}
	
	public void setUsername(String username) {
		this.username = username;
	}
	
	public String getPassword() {
		return password;
	}
	
	public void setPassword(String password) {
		this.password = password;
	}
	
	public String getConfirmPassword() {
		return confirmPassword;
	}
	
	public void setConfirmPassword(String confirmPassword) {
		this.confirmPassword = confirmPassword;
	}
	
	public String getEmail() {
		return email;
	}
	
	public void setEmail(String email) {
		this.email = email;
	}
}

В классе SignupValidator уже нет никакой необходимости, поэтому он исключен из проекта.

Необходимо внести еще одну правку в контроллер SignupController. Так как мы используем аннотации, которые будут проверять значение полей класса, необходимо описать аннотацией @Valid параметр метода SignupForm. Ниже приведен полный листинг класса SignupController:

package com.seostella.springfa.controller;

import javax.validation.Valid;

import org.springframework.stereotype.Controller;
import org.springframework.ui.ModelMap;
import org.springframework.validation.BindingResult;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

import com.seostella.springfa.form.SignupForm;

@Controller
@RequestMapping("/signup")
public class SignupController {

	@RequestMapping(method = RequestMethod.GET)
	public String signup(ModelMap model) {
		SignupForm signupForm = new SignupForm();
		model.put("signupForm", signupForm);
		return "signup";
	}

	@RequestMapping(method = RequestMethod.POST)
	public String processSignup(@Valid final SignupForm signupForm, final BindingResult result) {
		if (result.hasErrors()) {
			return "signup";
		}
		return "signup-success";
	}
}

Остальные файлы проекта остаются без изменений.

В классе SignupForm использовались аннотации из двух пакетов: javax.validation.constraints и org.hibernate.validator.constraints. Рассмотрим остальные аннотации из этих пакетов.

Пакет javax.validation.constraints:

• AssertFalse - значение аннотированного элемента должно быть false;
• AssertTrue - значение аннотированного элемента должно быть true;
• DecimalMax - значением аннотированного элемента должно быть число, которое должно быть меньше или равно указанному максимальному числу;
• DecimalMin - значением аннотированного элемента должно быть число, которое должно быть меньше или равно указанному минимальному числу;
• Digits - аннотированный элемент должен быть числом в пределах допустимого диапазона. Поддерживаемые типы: BigDecimal, BigInteger, String, byte, short, int, long и их типы-обертки. null считаются валидным значением;
• Future - аннотированный элемент должен быть датой в будущем;
• Max - значением аннотированного элемента должно быть число, которое должно быть меньше или равно указанному максимальному числу;
• Min - значением аннотированного элемента должно быть число, которое должно быть меньше или равно указанному минимальному числу;
• NotNull - аннотированный элемент не должен быть null;
• Null - аннотированный элемент должен быть null;
• Past - аннотированный элемент должен быть датой в прошлом;
• Pattern - аннотированный элемент (типа String) должен соответствовать регулярному выражению;
• Size - аннотированный размер элемента должно быть между заданными границами (границы включены в диапазон).

Пакет org.hibernate.validator.constraints:

• CreditCardNumber - аннотированный элемент должен представлять действительный номер кредитной карты;
• Email - строка должна быть правильно сформированным адресом электронной почты;
• Length - длина аннотированной строка должна быть между минимальным и максимальным значением (включительно);
• NotBlank - аннотированная строка не равна null и не является пустой;
• NotEmpty - аннотированный элемент типа String, Collection, Map или массив не равен null и не является пустым;
• Range - аннотированный элемент должен быть в соответствующем диапазоне;
• URL - аннотированная строка является правильным URL-адресом.

Код проекта Вы можете скачать по следующей ссылке - Скачать spring-fa.zip.