Spring Boot
bietet integrierte Validierungsanmerkungen, die Ihnen dabei helfen können, Eingabefelder einfach und schnell zu validieren, z. B. auf Null- oder leere Felder zu prüfen, Längenbeschränkungen durchzusetzen und zu verwenden reguläre Ausdrücke Ausdrucksvalidierungsmuster sowie Validierung von E-Mail-Adressen. Spring Boot
提供了内置的验证注解,可以帮助简单、快速地对输入字段进行验证,例如检查 null 或空字段、强制执行长度限制、使用正则表达式验证模式以及验证电子邮件地址。
一些最常用的验证注释包括:
@NotNull
:指定字段不能为空。
@NotEmpty
:指定列表字段不能为空。
@NotBlank
:指定字符串字段不得为空或仅包含空格。
@Min
和 @Max
:指定数字字段的最小值和最大值。
@Pattern
:指定字符串字段必须匹配的正则表达式模式。
@Email
:指定字符串字段必须是有效的电子邮件地址。
具体用法参考下面例子:
public class User { @NotNull private Long id; @NotBlank @Size(min = 2, max = 50) private String firstName; @NotBlank @Size(min = 2, max = 50) private String lastName; @Email private String email; @NotNull @Min(18) @Max(99) private Integer age; @NotEmpty private List<String> hobbies; @Pattern(regexp = "[A-Z]{2}\d{4}") private String employeeId;
虽然 Spring Boot 的内置验证注释很有用,但它们可能无法涵盖所有情况。如果有特殊参数验证的场景,可以使用 Spring 的 JSR 303 验证框架创建自定义验证注释。自定义注解可以让你的的验证逻辑更具可重用性和可维护性。
假设我们有一个应用程序,用户可以在其中创建帖子。每个帖子都应该有一个标题和一个正文,并且标题在所有帖子中应该是唯一的。虽然 Spring Boot 提供了用于检查字段是否为空的内置验证注释,但它没有提供用于检查唯一性的内置验证注释。在这种情况下,我们可以创建一个自定义验证注解来处理这种情况。
首先,我们创建自定义约束注解UniqueTitle
:
@Target({ElementType.FIELD}) @Retention(RetentionPolicy.RUNTIME) @Constraint(validatedBy = UniqueTitleValidator.class) public @interface UniqueTitle { String message() default "Title must be unique"; Class<?>[] groups() default {}; Class<? extends Payload>[] payload() default {}; }
接下来,我们创建一个PostRepository
接口,目的是从数据库中检索帖子:
public interface PostRepository extends JpaRepository<Post, Long> { Post findByTitle(String title); }
然后我们需要定义验证器类 UniqueTitleValidator
,如下所示:
@Component public class UniqueTitleValidator implements ConstraintValidator<UniqueTitle, String> { @Autowired private PostRepository postRepository; @Override public boolean isValid(String title, ConstraintValidatorContext context) { if (title == null) { return true; } return Objects.isNull(postRepository.findByTitle(title)); } }
UniqueTitleValidator
实现了ConstraintValidator
接口,它有两个泛型类型:第一个是自定义注解UniqueTitle
,第二个是正在验证的字段类型(在本例中为String
). 我们还自动装配了PostRepository
类以从数据库中检索帖子。
isValid()
方法通过查询 PostRepository
来检查 title
是否为 null 或者它是否是唯一的。如果 title
为 null 或唯一,则验证成功,并返回 true。
定义了自定义验证注释和验证器类后,我们现在可以使用它来验证 Spring Boot 应用程序中的帖子标题:
public class Post { @UniqueTitle private String title; @NotNull private String body; }
我们已将 @UniqueTitle
注释应用于 Post
类中的 title
变量。验证此字段时,这将触发 UniqueTitleValidator
类中定义的验证逻辑。
除了前端或者客户端做了验证意外,服务器端验证输入是至关重要的。它可以确保在处理或存储任何恶意或格式错误的数据之前将其捕获,这对于应用程序的安全性和稳定性至关重要。
假设我们有一个允许用户创建新帐户的 REST
端点。端点需要一个包含用户用户名和密码的 JSON 请求体。为确保输入有效,我们可以创建一个 DTO(数据传输对象)类并将验证注释应用于其字段:
public class UserDTO { @NotBlank private String username; @NotBlank private String password; }
我们使用@NotBlank
注解来确保username
和password
字段不为空或 null。
接下来,我们可以创建一个控制器方法来处理 HTTP POST 请求并在创建新用户之前验证输入:
@RestController @RequestMapping("/users") @Validated public class UserController { @Autowired private UserService userService; @PostMapping public ResponseEntity<String> createUser(@Valid @RequestBody UserDTO userDto) { userService.createUser(userDto); return ResponseEntity.status(HttpStatus.CREATED).body("User created successfully"); } }
我们使用 Spring 的@Validated
注解来启用方法级验证,我们还将 @Valid
注释应用于 userDto
参数以触发验证过程。
当验证失败时,必须提供清晰简洁的错误消息来描述出了什么问题以及如何修复它。
这是一个示例,如果我们有一个允许用户创建新用户的 RESTful API
。我们要确保姓名和电子邮件地址字段不为空,年龄在 18 到 99 岁之间,除了这些字段,如果用户尝试使用重复的“用户名”创建帐户,我们还会提供明确的错误消息或“电子邮件”。
为此,我们可以定义一个带有必要验证注释的模型类 User,如下所示:
public class User { @NotBlank(message = "用户名不能为空") private String name; @NotBlank(message = "Email不能为空") @Email(message = "无效的Emaild地址") private String email; @NotNull(message = "年龄不能为空") @Min(value = 18, message = "年龄必须大于18") @Max(value = 99, message = "年龄必须小于99") private Integer age; }
我们使用 message属性为每个验证注释提供了自定义错误消息。
接下来,在我们的 Spring 控制器中,我们可以处理表单提交并使用 @Valid
注释验证用户输入:
@RestController @RequestMapping("/users") public class UserController { @Autowired private UserService userService; @PostMapping public ResponseEntity<String> createUser(@Valid @RequestBody User user, BindingResult result) { if (result.hasErrors()) { List<String> errorMessages = result.getAllErrors().stream() .map(DefaultMessageSourceResolvable::getDefaultMessage) .collect(Collectors.toList()); return ResponseEntity.badRequest().body(errorMessages.toString()); } // save the user to the database using UserService userService.saveUser(user); return ResponseEntity.status(HttpStatus.CREATED).body("User created successfully"); } }
我们使用 @Valid
注释来触发 User
对象的验证,并使用 BindingResult
@NotNull
: Das angegebene Feld darf nicht null sein. 🎜@NotEmpty
: Das angegebene Listenfeld darf nicht leer sein. 🎜@NotBlank
: Gibt an, dass das Zeichenfolgenfeld nicht leer sein oder nur Leerzeichen enthalten darf. 🎜@Min
und @Max
: Geben Sie die Mindest- und Höchstwerte für numerische Felder an. 🎜@Pattern
: Gibt das reguläre Ausdrucksmuster an, mit dem das Zeichenfolgenfeld übereinstimmen muss. 🎜@Email
: Gibt an, dass das Zeichenfolgenfeld eine gültige E-Mail-Adresse sein muss. 🎜# messages.properties user.name.required=Name is required. user.email.invalid=Invalid email format. user.age.invalid=Age must be a number between 18 and 99.🎜2. Benutzerdefinierte Validierungsanmerkungen verwenden🎜🎜Obwohl die integrierten Validierungsanmerkungen von Spring Boot nützlich sind, decken sie möglicherweise nicht alle Situationen ab. Wenn Sie spezielle Parametervalidierungsszenarien haben, können Sie das JSR 303-Validierungsframework von Spring verwenden, um benutzerdefinierte Validierungsanmerkungen zu erstellen. Benutzerdefinierte Anmerkungen können Ihre Validierungslogik wiederverwendbarer und wartbarer machen. 🎜🎜Angenommen, wir haben eine Anwendung, mit der Benutzer Beiträge erstellen können. Jeder Beitrag sollte einen Titel und einen Text haben und der Titel sollte für alle Beiträge eindeutig sein. Während Spring Boot integrierte Validierungsanmerkungen zum Überprüfen, ob ein Feld leer ist, bereitstellt, stellt es keine integrierten Validierungsanmerkungen zum Überprüfen der Eindeutigkeit bereit. In diesem Fall können wir eine benutzerdefinierte Validierungsanmerkung erstellen, um diese Situation zu bewältigen. 🎜🎜Zuerst erstellen wir eine benutzerdefinierte Einschränkungsanmerkung
UniqueTitle
: 🎜user.name.required=名称不能为空. user.email.invalid=无效的email格式. user.age.invalid=年龄必须在18到99岁之间.🎜Als nächstes erstellen wir eine
PostRepository
-Schnittstelle mit dem Zweck, Beiträge aus der Datenbank abzurufen: 🎜public class User { @NotNull(message = "{user.id.required}") private Long id; @NotBlank(message = "{user.name.required}") private String name; @Email(message = "{user.email.invalid}") private String email; @NotNull(message = "{user.age.required}") @Min(value = 18, message = "{user.age.invalid}") @Max(value = 99, message = "{user.age.invalid}") private Integer age; }🎜Dann Wir müssen die Validatorklasse
UniqueTitleValidator
wie folgt definieren: 🎜@Configuration public class AppConfig { @Bean public MessageSource messageSource() { ResourceBundleMessageSource messageSource = new ResourceBundleMessageSource(); messageSource.setBasename("messages"); messageSource.setDefaultEncoding("UTF-8"); return messageSource; } @Bean public LocalValidatorFactoryBean validator() { LocalValidatorFactoryBean validatorFactoryBean = new LocalValidatorFactoryBean(); validatorFactoryBean.setValidationMessageSource(messageSource()); return validatorFactoryBean; } }🎜
UniqueTitleValidator
implementiert die ConstraintValidator
-Schnittstelle, die zwei generische Typen hat: Der erste ist die benutzerdefinierte Annotation UniqueTitle
und die zweite ist der Feldtyp, der validiert wird (in diesem Fall String
). Wir haben auch die Klasse PostRepository
automatisch verknüpft, um Beiträge abzurufen aus der Datenbank. 🎜🎜Die Methode isValid()
prüft, ob title
null oder eindeutig ist, indem sie PostRepository
abfragt. Wenn title
null oder eindeutig ist, ist die Validierung erfolgreich und es wird „true“ zurückgegeben. 🎜🎜Nachdem die benutzerdefinierte Validierungsanmerkung und die Validatorklasse definiert sind, können wir sie jetzt verwenden, um Beitragstitel in unserer Spring Boot-Anwendung zu validieren: 🎜public class User { @NotBlank(groups = Default.class) private String firstName; @NotBlank(groups = Default.class) private String lastName; @Email(groups = EmailNotEmpty.class) private String email; // getters and setters omitted for brevity public interface EmailNotEmpty {} public interface Default {} }🎜Wir haben die Annotation
@UniqueTitle
auf angewendet title
-Variable in der >Post-Klasse. Bei der Validierung dieses Felds wird die in der Klasse UniqueTitleValidator
definierte Validierungslogik ausgelöst. 🎜🎜3. Verifizierung auf der Serverseite🎜🎜Zusätzlich zur Verifizierung am Frontend oder Client ist es entscheidend, die Eingaben auf der Serverseite zu verifizieren. Es stellt sicher, dass alle schädlichen oder fehlerhaften Daten erkannt werden, bevor sie verarbeitet oder gespeichert werden, was für die Anwendungssicherheit und -stabilität von entscheidender Bedeutung ist. 🎜🎜Angenommen, wir haben einen REST
-Endpunkt, der es Benutzern ermöglicht, neue Konten zu erstellen. Der Endpunkt erwartet einen JSON-Anfragetext, der den Benutzernamen und das Passwort des Benutzers enthält. Um sicherzustellen, dass die Eingabe gültig ist, können wir eine DTO-Klasse (Data Transfer Object) erstellen und Validierungsanmerkungen auf ihre Felder anwenden: 🎜@RestController @RequestMapping("/users") @Validated public class UserController { public ResponseEntity<String> createUser( @Validated({org.example.model.ex6.User.EmailNotEmpty.class}) @RequestBody User userWithEmail, @Validated({User.Default.class}) @RequestBody User userWithoutEmail) { // Create the user and return a success response } }🎜 Wir verwenden die Annotation
@NotBlank
, um sicherzustellen, dass Benutzername
und das Feld password
ist nicht leer oder null. 🎜🎜Als nächstes können wir eine Controller-Methode erstellen, um die HTTP-POST-Anfrage zu verarbeiten und die Eingabe zu validieren, bevor wir einen neuen Benutzer erstellen: 🎜@Target({ElementType.TYPE}) @Retention(RetentionPolicy.RUNTIME) @Constraint(validatedBy = EndDateAfterStartDateValidator.class) public @interface EndDateAfterStartDate { String message() default "End date must be after start date"; Class<?>[] groups() default {}; Class<? extends Payload>[] payload() default {}; }🎜Wir verwenden die
@Validated
-Annotation von Spring, um die Validierung auf Methodenebene zu ermöglichen Wenden Sie außerdem die Annotation @Valid
auf den Parameter userDto
an, um den Validierungsprozess auszulösen. 🎜🎜4. Geben Sie aussagekräftige Fehlermeldungen an🎜🎜Wenn die Validierung fehlschlägt, muss eine klare und prägnante Fehlermeldung bereitgestellt werden, die beschreibt, was schief gelaufen ist und wie das Problem behoben werden kann. 🎜🎜Dies ist ein Beispiel, wenn wir über eine RESTful API
verfügen, die es Benutzern ermöglicht, neue Benutzer zu erstellen. Wir stellen sicher, dass die Felder „Name“ und „E-Mail-Adresse“ nicht leer sind und zwischen 18 und 99 Jahre alt sind. Zusätzlich zu diesen Feldern stellen wir auch eine eindeutige Fehlermeldung oder „E-Mail-Adresse“ bereit, wenn ein Benutzer versucht, ein Konto bei zu erstellen ein doppelter „Benutzername“. 🎜🎜Dazu können wir eine Modellklasse User mit den erforderlichen Validierungsanmerkungen wie folgt definieren: 🎜public class EndDateAfterStartDateValidator implements ConstraintValidator<EndDateAfterStartDate, TaskForm> { @Override public boolean isValid(TaskForm taskForm, ConstraintValidatorContext context) { if (taskForm.getStartDate() == null || taskForm.getEndDate() == null) { return true; } return taskForm.getEndDate().isAfter(taskForm.getStartDate()); } }🎜Wir stellen für jede Validierungsanmerkung eine benutzerdefinierte Fehlermeldung mithilfe des Nachrichtenattributs bereit. 🎜🎜Als nächstes können wir in unserem Spring-Controller die Formularübermittlung verarbeiten und die Benutzereingabe mithilfe der Annotation
@Valid
validieren: 🎜@EndDateAfterStartDate public class TaskForm { @NotNull @DateTimeFormat(pattern = "yyyy-MM-dd") private LocalDate startDate; @NotNull @DateTimeFormat(pattern = "yyyy-MM-dd") private LocalDate endDate; }🎜Wir verwenden die Annotation
@Valid
Lösen Sie die Validierung für das User
-Objekt aus und verwenden Sie das BindingResult
-Objekt, um etwaige Validierungsfehler abzufangen. 🎜如果你的应用程序支持多种语言,则必须使用国际化 (i18n) 以用户首选语言显示错误消息。
以下是在 Spring Boot 应用程序中使用 i18n 处理错误消息的示例
首先,在资源目录下创建一个包含默认错误消息的 messages.properties
文件
# messages.properties user.name.required=Name is required. user.email.invalid=Invalid email format. user.age.invalid=Age must be a number between 18 and 99.
接下来,为每种支持的语言创建一个 messages_xx.properties
文件,例如,中文的 messages_zh_CN.properties
。
user.name.required=名称不能为空. user.email.invalid=无效的email格式. user.age.invalid=年龄必须在18到99岁之间.
然后,更新您的验证注释以使用本地化的错误消息
public class User { @NotNull(message = "{user.id.required}") private Long id; @NotBlank(message = "{user.name.required}") private String name; @Email(message = "{user.email.invalid}") private String email; @NotNull(message = "{user.age.required}") @Min(value = 18, message = "{user.age.invalid}") @Max(value = 99, message = "{user.age.invalid}") private Integer age; }
最后,在 Spring 配置文件中配置 MessageSource bean
以加载 i18n
消息文件
@Configuration public class AppConfig { @Bean public MessageSource messageSource() { ResourceBundleMessageSource messageSource = new ResourceBundleMessageSource(); messageSource.setBasename("messages"); messageSource.setDefaultEncoding("UTF-8"); return messageSource; } @Bean public LocalValidatorFactoryBean validator() { LocalValidatorFactoryBean validatorFactoryBean = new LocalValidatorFactoryBean(); validatorFactoryBean.setValidationMessageSource(messageSource()); return validatorFactoryBean; } }
现在,当发生验证错误时,错误消息将根据随请求发送的“Accept-Language”标头以用户的首选语言显示。
验证组是 Spring Boot 验证框架的一个强大功能,允许您根据其他输入值或应用程序状态应用条件验证规则。
现在有一个包含三个字段的User
类的情况下:firstName
、lastName
和email
。我们要确保如果 email
字段为空,则 firstName
或 lastName
字段必须非空。否则,所有三个字段都应该正常验证。
为此,我们将定义两个验证组:EmailNotEmpty
和 Default
。EmailNotEmpty
组将包含当 email
字段不为空时的验证规则,而 Default
组将包含所有三个字段的正常验证规则。
创建带有验证组的 User
类
public class User { @NotBlank(groups = Default.class) private String firstName; @NotBlank(groups = Default.class) private String lastName; @Email(groups = EmailNotEmpty.class) private String email; // getters and setters omitted for brevity public interface EmailNotEmpty {} public interface Default {} }
请注意,我们在User
类中定义了两个接口,EmailNotEmpty
和 Default
。这些将作为我们的验证组。
接下来,我们更新Controller
使用这些验证组
@RestController @RequestMapping("/users") @Validated public class UserController { public ResponseEntity<String> createUser( @Validated({org.example.model.ex6.User.EmailNotEmpty.class}) @RequestBody User userWithEmail, @Validated({User.Default.class}) @RequestBody User userWithoutEmail) { // Create the user and return a success response } }
我们已将@Validated
注释添加到我们的控制器,表明我们想要使用验证组。我们还更新了 createUser
方法,将两个 User
对象作为输入,一个在 email
字段不为空时使用,另一个在它为空时使用。
@Validated
注释用于指定将哪个验证组应用于每个 User
对象。对于 userWithEmail
参数,我们指定了 EmailNotEmpty
组,而对于 userWithoutEmail
参数,我们指定了 Default
组。
进行这些更改后,现在将根据“电子邮件”字段是否为空对“用户”类进行不同的验证。如果为空,则 firstName
或 lastName
字段必须非空。否则,所有三个字段都将正常验证。
如果需要验证跨多个字段的复杂输入规则,可以使用跨字段验证来保持验证逻辑的组织性和可维护性。跨字段验证可确保所有输入值均有效且彼此一致,从而防止出现意外行为。
假设我们有一个表单,用户可以在其中输入任务的开始日期和结束日期,并且我们希望确保结束日期不早于开始日期。我们可以使用跨域验证来实现这一点。
首先,我们定义一个自定义验证注解EndDateAfterStartDate
:
@Target({ElementType.TYPE}) @Retention(RetentionPolicy.RUNTIME) @Constraint(validatedBy = EndDateAfterStartDateValidator.class) public @interface EndDateAfterStartDate { String message() default "End date must be after start date"; Class<?>[] groups() default {}; Class<? extends Payload>[] payload() default {}; }
然后,我们创建验证器EndDateAfterStartDateValidator
:
public class EndDateAfterStartDateValidator implements ConstraintValidator<EndDateAfterStartDate, TaskForm> { @Override public boolean isValid(TaskForm taskForm, ConstraintValidatorContext context) { if (taskForm.getStartDate() == null || taskForm.getEndDate() == null) { return true; } return taskForm.getEndDate().isAfter(taskForm.getStartDate()); } }
最后,我们将EndDateAfterStartDate
注释应用于我们的表单对象TaskForm
:
@EndDateAfterStartDate public class TaskForm { @NotNull @DateTimeFormat(pattern = "yyyy-MM-dd") private LocalDate startDate; @NotNull @DateTimeFormat(pattern = "yyyy-MM-dd") private LocalDate endDate; }
现在,当用户提交表单时,验证框架将自动检查结束日期是否晚于开始日期,如果不是,则提供有意义的错误消息。
可以使用异常处理ExceptionHandler
来统一捕获和处理验证错误。
以下是如何在 Spring Boot 中使用异常处理来处理验证错误的示例:
@RestControllerAdvice public class RestExceptionHandler extends ResponseEntityExceptionHandler { @ExceptionHandler(MethodArgumentNotValidException.class) protected ResponseEntity<Object> handleMethodArgumentNotValid(MethodArgumentNotValidException ex, HttpHeaders headers, HttpStatus status, WebRequest request) { Map<String, Object> body = new LinkedHashMap<>(); body.put("timestamp", LocalDateTime.now()); body.put("status", status.value()); // Get all errors List<String> errors = ex.getBindingResult() .getFieldErrors() .stream() .map(x -> x.getDefaultMessage()) .collect(Collectors.toList()); body.put("errors", errors); return new ResponseEntity<>(body, headers, status); } }
在这里,我们创建了一个用 @RestControllerAdvice
注解的 RestExceptionHandler
类来处理我们的 REST API 抛出的异常。然后我们创建一个用 @ExceptionHandler
注解的方法来处理在验证失败时抛出的 MethodArgumentNotValidException
。
在处理程序方法中,我们创建了一个 Map
对象来保存错误响应的详细信息,包括时间戳、HTTP 状态代码和错误消息列表。我们使用 MethodArgumentNotValidException
对象的 getBindingResult()
方法获取所有验证错误并将它们添加到错误消息列表中。
最后,我们返回一个包含错误响应详细信息的ResponseEntity
对象,包括作为响应主体的错误消息列表、HTTP 标头和 HTTP 状态代码。
有了这个异常处理代码,我们的 REST API 抛出的任何验证错误都将被捕获并以结构化和有意义的格式返回给用户,从而更容易理解和解决问题。
需要为你的验证逻辑编写单元测试,以帮助确保它正常工作。
@DataJpaTest public class UserValidationTest { @Autowired private TestEntityManager entityManager; @Autowired private Validator validator; @Test public void testValidation() { User user = new User(); user.setFirstName("John"); user.setLastName("Doe"); user.setEmail("invalid email"); Set<ConstraintViolation<User>> violations = validator.validate(user); assertEquals(1, violations.size()); assertEquals("must be a well-formed email address", violations.iterator().next().getMessage()); } }
我们使用 JUnit 5 编写一个测试来验证具有无效电子邮件地址的“用户”对象。然后我们使用 Validator
接口来验证 User
对象并检查是否返回了预期的验证错误。
客户端验证可以通过向用户提供即时反馈并减少对服务器的请求数量来改善用户体验。但是,不应依赖它作为验证输入的唯一方法。客户端验证很容易被绕过或操纵,因此必须在服务器端验证输入,以确保安全性和数据完整性。
Das obige ist der detaillierte Inhalt vonWelche Techniken gibt es zur Überprüfung der SpringBoot-Parameter?. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!