基于springboot开发的服务器控制器接收参数及校验

一、控制器获得前端传来的参数

1、url路径带的参数

形式一：/banner/id （id是参数值 比如：1）

在函数参数中使用@PathVariable Integer id，参考示例代码1

注意：参数名字的定义，要跟@GetMapping("/test1/{id}")中的id一致，如果不一致，要使用@PathVariable(name="id")

2）/banner?id=1&name=liangdm

使用@RequestParam String name，参考示例代码1

示例代码1

假设请求url地址为：http://localhost/api/vi/test1/1?name=deming

@GetMapping("/test1/{id}")

public void test1(@PathVariable Integer id,

                          @RequestParam String name) {

    System.out.println("xxxxx");

}

2、获得RequestBody体传递过来的参数，一般是json对象

{

username:"deming",

password:"123456"

}

1) 方法一 ：使用@RequestBody Map<String,Object> person 这种方法需要装箱、解构，比较麻烦，不推荐使用

2）方法二：定义数据传输对象 PersonDTO person，使用@RequestBody PersonDTO person来接受参数

步骤一：创建javabean，如使用@Getter、@Setter，需要使用maven安装lombok插件

@Getter

@Setter

public class PersonDTO {

  private String username;

private String password;

}

步骤二：

@PostMapping("/test2")

public PersonDTO test2(@RequestBody PersonDTO person) {

    PersonDTO dto = PersonDTO.builder().name("liangde").age(18).build();

    return dto;

}

二、对获得参数进行校验

使用参数校验，首先在控制器的类上打上@Validated 开启参数校验

@Validated

public class BannerController {

}

1 使用基础内置的验证注解，如：@Range  @Length @Max @Min等，适用于url请求的路径参数

@GetMapping("/test1/{id}")

public void test1(@PathVariable @Range(min = 1, max = 10, message = "id号超出1-10") Integer id

        , @RequestParam @Length(min = 7) String name) {

    System.out.println("this is test1");

}

2、如果是对json对象进行参数校验，需要在@RequestBody 加上@Validated 注解，如下所示

第一步：在javabean对象前，打上@Validated 注解

public PersonDTO test2(@RequestBody @Validated PersonDTO person) {

    PersonDTO dto = PersonDTO.builder().name("liangde").age(18).build();

    return dto;

}

第二步，因为PersonDTO的成员变量是基础参数，对这些基础参数的校验使用基础验证注解就可以了，如下所示：

public class PersonDTO {

    @Length(min=2,max=10,message="姓名的长度应在2～10之间")

    private String name;

}

另外，如果说PersonDTO中有SchoolDTO这种对象成员变量，对这种成员变量的校验，需要打上@Valid注解，这种情况叫级连验证，如下所示

public class PersonDTO {

    @Length(min=2,max=10,message="姓名的长度应在2～10之间")

    private String name;

    @Valid

    private SchoolDTO schoolDTO;

}

注：schoolDTO下的成员变量参数校验使用普通验证注解

其他基础校验注解

​@Null  //被注释的元素必须为null@NotNull  //被注释的元素不能为null@AssertTrue  //被注释的元素必须为true@AssertFalse  //被注释的元素必须为false@Min(value)  //被注释的元素必须是一个数字，其值必须大于等于指定的最小值@Max(value)  //被注释的元素必须是一个数字，其值必须小于等于指定的最大值@DecimalMin(value)  //被注释的元素必须是一个数字，其值必须大于等于指定的最小值@DecimalMax(value)  //被注释的元素必须是一个数字，其值必须小于等于指定的最大值@Size(max,min)  //被注释的元素的大小必须在指定的范围内。@Digits(integer,fraction)  //被注释的元素必须是一个数字，其值必须在可接受的范围内@Past  //被注释的元素必须是一个过去的日期@Future  //被注释的元素必须是一个将来的日期@Pattern(value) //被注释的元素必须符合指定的正则表达式。@Email //被注释的元素必须是电子邮件地址@Length //被注释的字符串的大小必须在指定的范围内@NotEmpty  //被注释的字符串必须非空@Range  //被注释的元素必须在合适的范围内

2 自定义校验注解做参数校验

第一步：定义一个注解类型PasswordEqual

@Documented

@Retention(RetentionPolicy.RUNTIME)

//ElementType.TYPE 注解应用在类中， ElementType.METHOD  注解应用在方法，，ElementType.filed 注解应用在字段

@Target(ElementType.TYPE)

@Constraint(validatedBy = PasswordValidator.class)  //关联类设定PasswordValidator.class，双向关联

public @interface PasswordEqual {

    int min() default 2;

    int max() default 6;

    String message() default "password are not equal"; //出错时，提示消息

//    规范中必须有以下两个模版方法

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

    Class<? extends Payload>[] payload() default {};

}

第二步：创建自定义注解的关联类PasswordValidator ，通过实现接口进行注解关联

//第一个参数时自定义注解PasswordEqual,，第二个参数是注解修饰的类型PersonDTO

public class PasswordValidator implements ConstraintValidator<PasswordEqual, PersonDTO> {

    private int min;

    private int max;

    private String message;

    @Override

    public void initialize(PasswordEqual constraintAnnotation) {

        this.min = constraintAnnotation.min();

        this.max = constraintAnnotation.max();

        this.message = constraintAnnotation.message();

    }

    @Override

    public boolean isValid(PersonDTO value, ConstraintValidatorContext context) {

        String password1 = value.getPassword1();

        String password2 = value.getPassword2();

        boolean match = password1.equals(password2);

        System.out.println(this.min);

        System.out.println(this.max);

        System.out.println(this.message);

        return match;

    }

}

3、应用注解

@PasswordEqual(min=1,max=100,message="两次密码输入不一致")  //注解打在类上面

public class PersonDTO {

    private String password1;

    private String password2;

}

4、参数校验过程捕获异常，并反馈给前端

前面是使用注解的方法校验参数的异常，一般在后台信息打印异常信息，如果需要把异常信息返回给前端，需要增强框架内容，增加以下方法捕获异常并返回异常信息

1）捕获url路径参数异常

    @ExceptionHandler(ConstraintViolationException.class)

    @ResponseBody

    @ResponseStatus(code=HttpStatus.BAD_REQUEST)

    public UnifyResponse handleConstraintException(HttpServletRequest req, ConstraintViolationException e){

        String requestURL = req.getRequestURI();

        String method = req.getMethod();

        String message = e.getMessage();

        return new UnifyResponse(10001,message,method + " " + requestURL);

    }

2） 捕获DTO参数错误异常，可以同时处理多个参数异常， 状态码统一为参数错误状态码

    @ExceptionHandler(MethodArgumentNotValidException.class)

    @ResponseStatus(code= HttpStatus.BAD_REQUEST)

    @ResponseBody

    public UnifyResponse handleBeanValidation(HttpServletRequest req,MethodArgumentNotValidException e) {

        String requestURL = req.getRequestURI();

        String method = req.getMethod();

        List<ObjectError> errors = e.getBindingResult().getAllErrors();

        String message = this.FormatAllErrorsMessage(errors);

        return new UnifyResponse(10001,message,method + " " +requestURL);

    }

    private String FormatAllErrorsMessage( List<ObjectError> errors) {

        StringBuffer errMsg = new StringBuffer();

        errors.forEach(error->

                errMsg.append(error.getDefaultMessage()).append(","));

        return errMsg.toString();

    }

©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 212,185评论 6赞 493
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 90,445评论 3赞 385
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 157,684评论 0赞 348
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 56,564评论 1赞 284
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 65,681评论 6赞 386
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 49,874评论 1赞 290
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 39,025评论 3赞 408
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 37,761评论 0赞 268
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 44,217评论 1赞 303
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,545评论 2赞 327
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,694评论 1赞 341
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 34,351评论 4赞 332
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 39,988评论 3赞 315
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,778评论 0赞 21
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,007评论 1赞 266
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 46,427评论 2赞 360
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 43,580评论 2赞 349

推荐阅读更多精彩内容