Gemeinschaft Lernen Tools-Bibliothek Freizeit
suchen
Deutsch
Heim > Java > javaLernprogramm > Wie führt SpringBoot eine Parameterüberprüfung durch?

Wie führt SpringBoot eine Parameterüberprüfung durch?

WBOY
Freigeben： 2023-05-18 15:52:36
nach vorne
1332 Leute haben es durchsucht

Einführung

Um zu verhindern, dass illegale Parameter das Geschäft beeinträchtigen, ist es häufig erforderlich, die Parameter der Schnittstelle zu überprüfen. Beispielsweise muss bei der Protokollierung überprüft werden, ob der Benutzername und das Kennwort leer sind in und beim Hinzufügen eines Benutzers. Sind die Formate der E-Mail-Adresse und der Mobiltelefonnummer des Benutzers korrekt? Es wäre zu umständlich, sich auf Code zu verlassen, um die Schnittstellenparameter einzeln zu überprüfen, und die Lesbarkeit des Codes wäre äußerst schlecht.

ValidatorDas Framework soll Entwicklern helfen, während der Entwicklung weniger Code zu schreiben und die Entwicklungseffizienz zu verbessern. Der Validator wird speziell zur Überprüfung von Schnittstellenparametern verwendet, z. B. zur Überprüfung allgemeiner Anforderungen und zur Überprüfung des E-Mail-Formats. Der Benutzername muss zwischen 6 und 12 liegen und so weiter.

Als nächstes werfen wir einen Blick darauf, wie das Parameterüberprüfungs-Framework in SpringbBoot integriert wird.

1. Integrierte Parameterüberprüfung in SpringBoot.

1.1 Abhängigkeiten einführen

@AssertFal se

Okay, es kann null sein. Wenn es nicht null ist, muss es falsch sein. Die Einstellung darf den Mindestwert nicht überschreiten Die Anzahl der Dezimalstellen muss innerhalb des angegebenen Bereichs liegen sein
@Max Das Maximum darf diesen Maximalwert nicht überschreiten
@Min Das Maximum darf diesen Minimalwert nicht unterschreiten
@NotNull kann nicht null sein, kann leer sein
@Null muss null sein
@Pattern muss den angegebenen regulären Ausdruck erfüllen
@Size Größe von Sammlungen, Arrays, Karten usw. ()Der Wert muss innerhalb des angegebenen Bereichs liegen
@Email Muss im E-Mail-Format vorliegen
@Length Die Länge muss innerhalb des angegebenen Bereichs liegen
@NotBlank String darf nicht null sein, string Nach trim() ist dies nicht möglich gleich „“ sein
@NotEmpty Die Größe() von Sammlungen, Arrays, Karten usw. darf nicht 0 sein; nach trim() kann die Zeichenfolge gleich „“
@Range Der Wert muss innerhalb des angegebenen Bereichs liegen
@URL muss eine URL sein

1.3定义校验类进行测试

package com.didiplus.modules.sys.controller;

import com.didiplus.modules.sys.domain.SysDictType;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import io.swagger.v3.oas.annotations.parameters.RequestBody;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.PutMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

/**
 * Author: didiplus
 * Email: 972479352@qq.com
 * CreateTime: 2022/4/25
 * Desc: 数据字典控制器
 */
@RestController
@Api(tags = "数据字典")
@RequestMapping("/api/sys/dictType")
public class SysDictTypeController {

    @ApiOperation("字典添加")
    @PostMapping("/add")
    public SysDictType add(@Validated @RequestBody SysDictType sysDictType) {
        return  sysDictType;
    }

    @ApiOperation("字典修改")
    @PutMapping("/edit")
    public SysDictType edit(@Validated @RequestBody SysDictType sysDictType) {
        return  sysDictType;
    }


}
Nach dem Login kopieren

这里我们先定义两个方法add,edit，都是使用了 @RequestBody注解，用于接受前端发送的json数据。

1.4打开接口文档模拟提交数据

Wie führt SpringBoot eine Parameterüberprüfung durch?

通过接口文档看到前三个字段都是必填项。

Wie führt SpringBoot eine Parameterüberprüfung durch?

由于email的格式不对就被拦截了，提示是因为邮箱地址不对。

2.参数异常加入全局异常处理器

虽然我们之前定义了全局异常拦截器，也看到了拦截器确实生效了，但是Validator校验框架返回的错误提示太臃肿了，不便于阅读，为了方便前端提示，我们需要将其简化一下。

直接修改之前定义的 RestExceptionHandler，单独拦截参数校验的三个异常：

javax.validation.ConstraintViolationException

org.springframework.validation.BindException

org.springframework.web.bind.MethodArgumentNotValidException

代码如下：

package com.didiplus.common.web.response.Handler;

import com.didiplus.common.web.response.Result;

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.validation.BindException;
import org.springframework.validation.ObjectError;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;

import javax.validation.ConstraintViolation;
import javax.validation.ConstraintViolationException;
import javax.validation.ValidationException;

import java.util.stream.Collectors;

/**
 * Author: didiplus
 * Email: 972479352@qq.com
 * CreateTime: 2022/4/24
 * Desc:  默认全局异常处理。
 */
@RestControllerAdvice
public class RestExceptionHandler {
    /**
     * 默认全局异常处理。
     * @param e the e
     * @return ResultData
     */
    @ExceptionHandler(value = {BindException.class, ValidationException.class, MethodArgumentNotValidException.class})
    public ResponseEntity<Result<String>> handleValidatedException(Exception e) {
            Result<String>  result = null;
            if (e instanceof  MethodArgumentNotValidException) {
                MethodArgumentNotValidException ex =(MethodArgumentNotValidException)  e;
                result = Result.failure(HttpStatus.BAD_REQUEST.value(),
                                ex.getBindingResult().getAllErrors().stream()
                                        .map(ObjectError::getDefaultMessage)
                                        .collect(Collectors.joining(";"))
                                );
            } else  if (e instanceof ConstraintViolationException){
                ConstraintViolationException ex = (ConstraintViolationException) e;
                result = Result.failure(HttpStatus.BAD_REQUEST.value(),
                                        ex.getConstraintViolations().stream()
                                                .map(ConstraintViolation::getMessage)
                                                .collect(Collectors.joining(";"))
                                        );
            }else  if (e instanceof BindException) {
                BindException  ex = (BindException ) e;
                result = Result.failure(HttpStatus.BAD_REQUEST.value(),
                                        ex.getAllErrors().stream()
                                                .map(ObjectError::getDefaultMessage)
                                                .collect(Collectors.joining(";"))
                                        );
            }
            return new ResponseEntity<>(result,HttpStatus.BAD_REQUEST);
    }
}
Nach dem Login kopieren

美化之后错误信息提示更加友好

Wie führt SpringBoot eine Parameterüberprüfung durch?

3.自定义参数校验

虽然Spring Validation 提供的注解基本上够用，但是面对复杂的定义，我们还是需要自己定义相关注解来实现自动校验。
比如上面实体类中添加的sex性别属性，只允许前端传递传 M，F 这2个枚举值，如何实现呢？

3.1创建自定义注解

package com.didiplus.common.annotation;

import javax.validation.Constraint;
import javax.validation.Payload;
import java.lang.annotation.Documented;
import java.lang.annotation.Repeatable;
import java.lang.annotation.Retention;
import java.lang.annotation.Target;

import static java.lang.annotation.ElementType.*;
import static java.lang.annotation.RetentionPolicy.RUNTIME;

/**
 * Author: didiplus
 * Email: 972479352@qq.com
 * CreateTime: 2022/4/26
 * Desc:
 */
@Target({METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER, TYPE_USE})
@Retention(RUNTIME)
@Repeatable(EnumString.List.class)
@Documented
@Constraint(validatedBy = EnumStringValidator.class)//标明由哪个类执行校验逻辑
public @interface EnumString {

    String message() default "value not in enum values.";

    Class<?>[] groups() default {};

    Class<? extends Payload>[] palyload() default {};
    /**
     * @return date must in this value array
     */
    String[] value();

    /**
     * Defines several {@link EnumString} annotations on the same element.
     *
     * @see EnumString
     */
    @Target({METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER, TYPE_USE})
    @Retention(RUNTIME)
    @Documented
    @interface List {

        EnumString[] value();
    }


}
Nach dem Login kopieren

3.2自定义校验逻辑

package com.didiplus.common.annotation;

import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;
import java.util.Arrays;
import java.util.List;


/**
 * Author: didiplus
 * Email: 972479352@qq.com
 * CreateTime: 2022/4/26
 * Desc:
 */
public class EnumStringValidator implements ConstraintValidator<EnumString,String> {
    private List<String> enumStringList;

    @Override
    public void initialize(EnumString constraintAnnotation) {
        enumStringList = Arrays.asList(constraintAnnotation.value());

    }

    @Override
    public boolean isValid(String value, ConstraintValidatorContext constraintValidatorContext) {
        if(value == null) {
            return true;
        }
        return enumStringList.contains(value);
    }
}
Nach dem Login kopieren

3.3在字段上增加注解

    @ApiModelProperty(value = "性别")
    @EnumString(value = {"F","M"}, message="性别只允许为F或M")
    private String sex;
Nach dem Login kopieren

3.4体验效果

Wie führt SpringBoot eine Parameterüberprüfung durch?

4.分组校验

一个对象在新增的时候某些字段是必填，在更新是有非必填。如上面的 SysDictType中id 属性在新增操作时都是必填。 面对这种场景你会怎么处理呢？

其实 Validator校验框架已经考虑到了这种场景并且提供了解决方案，就是分组校验。 要使用分组校验，只需要三个步骤：

4.1定义分组接口

package com.didiplus.common.base;

import javax.validation.groups.Default;

/**
 * Author: didiplus
 * Email: 972479352@qq.com
 * CreateTime: 2022/4/26
 * Desc:
 */
public interface ValidGroup extends Default {

    interface Crud extends ValidGroup{
        interface Create extends Crud{

        }

        interface Update extends Crud{

        }

        interface Query extends Crud{

        }

        interface Delete extends Crud{

        }
    }
}
Nach dem Login kopieren

4.2在模型中给参数分配分组

    @Null(groups = ValidGroup.Crud.Create.class)
    @NotNull(groups = ValidGroup.Crud.Update.class,message = "字典ID不能为空")
    @ApiModelProperty("ID")
    private String id;
Nach dem Login kopieren

4.3体现效果

Wie führt SpringBoot eine Parameterüberprüfung durch?

Wie führt SpringBoot eine Parameterüberprüfung durch?

Das obige ist der detaillierte Inhalt vonWie führt SpringBoot eine Parameterüberprüfung durch?. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!

Verwandte Etiketten：
springboot
Quelle：yisu.com
Vorheriger Artikel：So implementieren Sie die Protokollierung in CompletableFuture in Java Nächster Artikel：So verwenden Sie Streams zum Sortieren von Arrays in Java
Erklärung dieser Website
Der Inhalt dieses Artikels wird freiwillig von Internetnutzern beigesteuert und das Urheberrecht liegt beim ursprünglichen Autor. Diese Website übernimmt keine entsprechende rechtliche Verantwortung. Wenn Sie Inhalte finden, bei denen der Verdacht eines Plagiats oder einer Rechtsverletzung besteht, wenden Sie sich bitte an admin@php.cn
Neueste Artikel des Autors
Aktuelle Ausgaben
Die POST-Anfrage funktioniert einwandfrei, wenn Postman verwendet wird, jedoch nicht, wenn React Axios und das Spring Boot-Backend verwendet werden Von der Reaktionskonsole erhalte ich die Fehlermeldung „Ressource kann nicht geladen werde...
Aus 2024-04-05 13:07:01
0
1
396
SQL Server: Verwendung des CASE WHEN-Ausdrucks mit der WHERE-Klausel Ich habe ein neues SpringBoot-Projekt mit SQLServer und muss die nativen MySQL-Abfragen fü...
Aus 2024-04-03 14:46:55
0
1
351
Was sind die Architekturschichten einer Spring Boot + React + MySQL-Anwendung? Ich versuche, eine Dokumentation über die Anwendung zu schreiben, weiß aber nicht, wie ich...
Aus 2024-04-03 10:07:06
0
1
410
verwandte Themen
Mehr>
Beliebte Empfehlungen
Beliebte Tutorials
Mehr>
Verwandte Tutorials
Beliebte Empfehlungen
Aktuelle Kurse
Neueste Downloads
Mehr>
Web-Effekte
Quellcode der Website
Website-Materialien
Frontend-Vorlage