spring boot3.0自定义校验注解并以文章状态校验为例

 更新时间:2025年05月14日 09:46:14   作者:养军博客  
本文详细介绍如何在 Spring Boot 中自定义校验注解,并以状态校验为例进行讲解,力求简洁明了,易于理解和实践,感兴趣的朋友跟随小编一起看看吧

Spring Boot 自定义校验注解:状态校验示例

本文详细介绍如何在 Spring Boot 中自定义校验注解,并以状态校验为例进行讲解,力求简洁明了,易于理解和实践。

在实际应用中,标准的注解校验可能无法满足所有需求,尤其是在处理一些特殊的校验场景时。例如,可能需要根据业务逻辑对字段进行复杂的组合校验,或是在运行时动态决定校验规则。在这种情况下,使用现有的注解校验就显得力不从心。因此,我们可以通过自定义校验注解,来实现更灵活和精确的校验逻辑。这不仅能够提高代码的可读性和可维护性,还能使我们的应用更好地应对各种复杂的业务需求。

下面是对“创建State注解”部分的创建以及教学

一、创建 @State 注解

在现有的 Spring Boot 项目中,我们可能需要实现一些业务特定的校验逻辑,例如,确保一个字段的状态值满足特定条件。为此,我们可以创建一个自定义的 State 注解。这个注解将用于标识某个字段的状态,并通过自定义的校验逻辑来确保其值的合法性和有效性。

步骤:

1. 创建自定义注解:

在项目的合适位置(如 com.example.validation 包下),新建一个 State 注解类。该注解可以接收多个参数,例如允许的状态值。

package com.YJZE.anno;
import com.YJZE.validation.StateValidation;
import jakarta.validation.Constraint;
import jakarta.validation.Payload;
import java.lang.annotation.*;
@Documented//元注解
@Target( ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = {StateValidation.class})
public @interface State {
    String message() default "state参数只能是草稿或者已发布";
    Class<?>[] groups() default {};
    //负载 获取到State注解的附加信息
    Class<? extends Payload>[] payload() default {};
}

2. 实现校验逻辑:

创建一个名为 StateValidator 的类, 实现 ConstraintValidator<State, String> 接口。在这个类中定义具体的校验逻辑,以验证字段的值是否在允许的状态值中。

package com.YJZE.validation;
import com.YJZE.anno.State;
import jakarta.validation.ConstraintValidator;
import jakarta.validation.ConstraintValidatorContext;
public class StateValidation implements ConstraintValidator<State,String> {
    /**
     *
     * @param s
     * @param constraintValidatorContext
     * @return
     */
    @Override
    public boolean isValid(String s, ConstraintValidatorContext constraintValidatorContext) {
        if(s == null){
            return false;
        }
        if(s.equals("已发布") || s.equals("草稿")){
            return true;
        }
        return false;
    }
}

二、 实现自定义校验

步骤:

1. 在实体类中使用自定义校验注解 @State:

在我们的实体类中,通常需要对某些字段添加约束,以确保它们的值符合业务逻辑的要求。为了应用我们刚刚创建的 @State 自定义注解,我们需要在需要进行状态校验的字段上添加此注解。

2. 添加 @State 注解:

在对应字段的声明上面添加 @State 注解,指定合法的状态值。例如,假设我们有一个 Article 实体类,其中有一个 status 字段,表示文章的状态:

import com.YJZE.anno.State;
import jakarta.validation.constraints.NotEmpty;
import jakarta.validation.constraints.NotNull;
import jakarta.validation.constraints.Pattern;
import lombok.Data;
import org.hibernate.validator.constraints.URL;
import java.time.LocalDateTime;
@Data
public class Article {
    private Integer id;//主键ID
    @URL
    private String coverImg;//封面图像
    @State
    private String state;//发布状态 已发布|草稿
    @NotNull
    private Integer categoryId;//文章分类id
    private Integer createUser;//创建人ID
    private LocalDateTime createTime;//创建时间
    private LocalDateTime updateTime;//更新时间
}

总结

在本教程中,我们深入探讨了如何在 Spring Boot 中创建和实现自定义校验注解。通过自定义的 @State 注解,我们能够根据具体的业务需求对字段状态进行灵活而精确的校验。这种方法不仅提升了代码的可读性和可维护性,还使得校验逻辑更加清晰明了。

主要步骤回顾:

  • 创建自定义注解:我们首先定义了 @State 注解,并使用 @Constraint 注解来标记其为校验注解。此外,借助自定义的验证器 StateValidation,实现了具体的校验逻辑。
  • 实现校验逻辑:通过实现 ConstraintValidator 接口,定义了有效的状态值(如 "已发布""草稿"),并在 isValid 方法中实现了相应的校验机制,以确保字段值合法。
  • 应用自定义校验:在实体类中,我们将自定义注解应用于需要进行状态校验的字段。例如,在 Article 类中,对 state 字段使用了 @State 注解,从而保证其值符合预定义规则。

优势

  • 灵活性:可根据具体业务需求灵活自定义校验逻辑,满足复杂场景的需要。
  • 可读性:通过注解清晰表达校验意图,减少冗余的样板代码,增强代码的可理解性。
  • 可维护性:集中化的校验逻辑便于后续的修改和扩展,提高了代码的可维护性。

通过学习和实践自定义校验注解,将能够更有效地应对应用程序的复杂需求,提升整体代码质量,并在复杂的业务场景中展现出更强的竞争力。希望这个示例能够对你的项目有所帮助,如需深入了解,欢迎评论区随时提问!

到此这篇关于spring boot3.0自定义校验注解:文章状态校验示例的文章就介绍到这了,更多相关spring boot自定义校验注解内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 详解Java中异步转同步的六种方法

    详解Java中异步转同步的六种方法

    针对应用中异步调用,能不能像同步调用一样立刻获取到命令的执行结果,如何实现异步转同步?不要担心,本文就来为大家详细讲讲Java中异步转同步的六种方法,感兴趣的可以了解一下
    2022-06-06
  • 详解IntelliJ IDEA 中如何配置多个jdk版本即(1.7和1.8两个jdk都可用)

    详解IntelliJ IDEA 中如何配置多个jdk版本即(1.7和1.8两个jdk都可用)

    这篇文章主要介绍了详解IntelliJ IDEA 中如何配置多个jdk版本即(1.7和1.8两个jdk都可用),非常具有实用价值,需要的朋友可以参考下
    2017-11-11
  • IntelliJ IDEA 2019.2 x64的安装、应用与简单配置(图文)

    IntelliJ IDEA 2019.2 x64的安装、应用与简单配置(图文)

    这篇文章主要介绍了IntelliJ IDEA 2019.2 x64的安装、应用与简单配置,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-10-10
  • SpringBoot中的Actuator详解

    SpringBoot中的Actuator详解

    这篇文章主要介绍了SpringBoot中的Actuator详解,Spring Boot Actuator 在Spring Boot第一个版本发布的时候就有了,它为Spring Boot提供了一系列产品级的特性,监控应用程序,收集元数据,运行情况或者数据库状态等,需要的朋友可以参考下
    2023-09-09
  • 解决springcloud Zuul丢失Cookie的问题

    解决springcloud Zuul丢失Cookie的问题

    这篇文章主要介绍了解决springcloud Zuul丢失Cookie的问题,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-10-10
  • Spring BeanDefinition使用介绍

    Spring BeanDefinition使用介绍

    BeanDefinition是Spring框架中非常核心的概念,BeanDefinition是定义Bean的配置元信息接口,Spring根据BeanDefinition来定义Bean对象,简单说就是对Bean信息的定义
    2023-01-01
  • java中Serializable接口作用详解

    java中Serializable接口作用详解

    这篇文章主要为大家详细介绍了java中Serializable接口作用,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-05-05
  • Java 实战项目之教材管理系统的实现流程

    Java 实战项目之教材管理系统的实现流程

    读万卷书不如行万里路,只学书上的理论是远远不够的,只有在实战中才能获得能力的提升,本篇文章手把手带你用java+SSM+jsp+mysql+maven实现教材管理系统,大家可以在过程中查缺补漏,提升水平
    2021-11-11
  • 怎样提高mybatis-plus中saveBatch方法的效率

    怎样提高mybatis-plus中saveBatch方法的效率

    这篇文章主要介绍了怎样提高mybatis-plus中saveBatch方法的效率问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-07-07
  • Java正确实现一个单例设计模式的示例

    Java正确实现一个单例设计模式的示例

    今天小编就为大家分享一篇关于Java正确实现一个单例设计模式的示例,小编觉得内容挺不错的,现在分享给大家,具有很好的参考价值,需要的朋友一起跟随小编来看看吧
    2019-01-01

最新评论