全栈之路-小程序API-SpringBoot项目中参数校验机制与LomBok工具集使用

  参数校验机制在web开发中是非常重要的，每当看到现在所在公司的校验代码，我都有头疼，每一个接口都是重新写参数的校验，有些复杂的接口，参数的校验甚至占了整个接口代码量的挺大一部分的，看着我都有些头疼，我知道可以优化，但是我并不知道该如何优化，正好，七月老师在这个项目中讲解到了这一部分，哈哈哈

一、参数校验机制探究

  参数校验这个是非常重要的，如果把这个参数校验封装好了，那真的能节省很多代码，而且能够节省很多时间，这个还是非常重要的啊，这里分为参数的传递与参数的校验两部分内容

 1、web开发中参数传递方式

在springboot中参数的传递基本上和springmvc中是类似的，就是基本上还是那几种的传递方式

（1）路由中的参数

举例说明：/v1/banner/test/2 （获取这个路由中的2这个参数）

在path路径中的参数是可以通过@PathVariable注解来获取的，注意这个可以做一个映射，参数的名的对应

    @GetMapping("/test/{id}")
    public String test(@PathVariable(name = "id") Integer id) {
        diana.r();
        throw new ForbiddenException(10001);
    }

（2）路由中的?后面的参数

举例说明：/v1/banner/test/2?name=ssc （在后台中获取name参数的数值）

这中类型的参数的获取是利用@RequestParam注解来实现值得获取的，这个就比较简单了

    @GetMapping("/test/{id}")
    public String test(@PathVariable(name = "id") Integer id, @RequestParam String name) {
        diana.r();
        throw new ForbiddenException(10001);
    }

（3）获取json格式的参数

也可以说是获取对象类型的参数，我们后台处理的时候使用对象接收的，但是在页面中进行传递的时候是json格式的参数，这里有一个新的概念，那就是DTO（Data Transfer Object）也就是数据传输对象，之后所有的参数传输对象我们都会用这种统一的格式进行传递

# DTO例子：（省略get/set方法）

public class PersonDTO {

    private String name;
    private Integer age;
}

# 如何应用DTO对象来进行参数的传输

  这里使用@RequestBody注解进行参数的传输的，用的是数据传输对象PersonDTO来接收参数的

    @PostMapping("/test")
    public String test(@RequestBody PersonDTO person) {
        diana.r();
        throw new ForbiddenException(10001);
    }

 2、参数校验机制和自定义校验

（1）基础验证注解

# 基础的注解就是一些SDK中提供的注解，使用的时候一定要在类上添加@Validated注解，组合使用才能起到作用，否则如果不加上这个注解，是没有作用的

# http body中参数和级联验证中，这个是稍微复杂一点的业务了，在对象中还有一个属性是对象类型的，这个的验证问题就也不是很复杂

（2）自定义校验注解

 说明：这里以比较两次输入的密码是否相同来举例，写一个自定义的注解，来实现该功能

# 首先创建两个属性password1和password2，在PersonDTO类中进行创建的，这里使用了lombok的功能注解，简化getter/setter的代码

@Builder
@Getter
public class PersonDTO {

    @Length(min = 2, max = 10, message = "name长度在2~10之间")
    private String name;
    private Integer age;

    private String password1;
    private String password2;
}

# 然后创建@PasswordEqual注解，这里需要添加两个特定的属性

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
public @interface PasswordEqual {

    String message() default "passwords are not equals";

    // 自定义验证注解需要默认增加这两个模板方法的
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

注意：注解只是一个标记，我们不可以在注解中实现业务逻辑代码，自定义注解是有一个专门的关联类来实现业务逻辑代码的，这是如何进行实现的呢

# 创建自定义注解的关联类

public class PasswordValidator implements ConstraintValidator<PasswordEqual, PersonDTO> {

    // 泛型中第二个是自定义注解修饰的目标类

    @Override
    public boolean isValid(PersonDTO personDTO, ConstraintValidatorContext constraintValidatorContext) {
        String password1 = personDTO.getPassword1();
        String password2 = personDTO.getPassword2();
        boolean match = password1.equals(password2);
        return match;
    }

}

注意：注解和关联类是通过@Constraint注解进行组合在一起的，具体的做法就是在自定义注解中添加一个@Constraint注解指定PasswordValidator类的元类class

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
@Constraint(validatedBy = PasswordValidator.class)
public @interface PasswordEqual {

    String message() default "passwords are not equals";

    // 自定义注解需要默认增加这两个模板方法
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

## 这里设计的很巧妙的，在Java中这种编程模式是很优秀的，springboot中应用了很多这种优秀的编程模式，很清晰，代码可维护性很强

# 获取自定义校验注解的参数

在自定义注解中难免会有一些参数，就是在使用自定义注解的时候，我们会添加一些参数，那么如何在关联类中处理这些参数呢？首先我们应该获取到这些参数，重写initialize方法

public class PasswordValidator implements ConstraintValidator<PasswordEqual, PersonDTO> {

    // 泛型中第二个是自定义注解修饰的目标的类型

    private int min;
    private int max;

    @Override
    public void initialize(PasswordEqual constraintAnnotation) {
        this.min = constraintAnnotation.min();
        this.max = constraintAnnotation.max();
    }

    @Override
    public boolean isValid(PersonDTO personDTO, ConstraintValidatorContext constraintValidatorContext) {
        String password1 = personDTO.getPassword1();
        String password2 = personDTO.getPassword2();
        boolean match = password1.equals(password2);
        return match;
    }

}

二、LomBok工具集的使用

 1、lombok在项目中安装

这个直接就安装在pom.xml文件中就可以了，在pom/xml文件中引入lombok的依赖，但是在idea中查看类的机构的时候，如果不安装lombok的插件的话，是很不方便的，建议在idea中安装一个lombok的插件

# pom.xml文件中引入（这里没有写版本号，maven自动安装完成就可以了）

<!--lombok maven 依赖-->
<dependency>
      <groupId>org.projectlombok</groupId>
      <artifactId>lombok</artifactId>
</dependency>

# IDEA中安装lombok插件（直接在plugins插件市场中搜索就可以，直接安装）

 ## 安装完之后，还需要设置一个地方，具体就是：

 

 这样的话，在查看对象的类结构的时候，当我们使用lombok中的注解的时候，我们就可以正常的看到具体的属性本质是什么样子了

注意：关于在IDEA中如何查看Structure工具栏，是通过view ---> Tool windows ---> Structure这样查看的

 2、lombok中注解的学习

（1）@Getter/@Setter注解

 这两个注解就是针对代码中的get/set方法进行简化的

（2）constructor构造方法注解

## @AllArgsConstructor 全参数构造方法

## @NoArgsConstructor 无参数构造方法

## @RequiredArgsConstructor 部分参数构造器

（3）@Builder注解构造器模式

  这个使用的方法其实也是很简单的，但是有些需要注意的地方，先看一下这个注解是如何使用的

@Builder
public class PersonDTO {
    private String name;  
    private Integer age;
}

PersonDTO personDTO = PersonDTO.builder()
                .name("ssc")
                .age(18)
                .build();

具体对象创建的时候，我们只能使用builder这种方式进行构建，不能通过无参数的构造方法进行构建，因为在给一个对象加上@Builder注解之后，这个对象的无参数的构造方法会被变成私有的，无法使用

解决办法：继续给这个对象添加注解@Setter和@NoArgsConstructor注解，使其能够无参数构造

还有一个问题，那就是当这个数据传输对象作为结果返回的时候，我们是需要在加上@Getter注解的，这样的话，才能成功将这个对象进行序列化，前端页面才能成功的将这个结果进行接收

 内容出处：七月老师《从Java后端到全栈》视频课程

七月老师课程链接：https://class.imooc.com/sale/javafullstack