SpringBoot | 第八章:统一异常、数据校验处理

2018 年 8 月 12 日 ImportNew

(点击上方公众号,可快速关注)


来源:oKong ,

blog.lqdev.cn/2018/07/20/springboot/chapter-eight/


前言


在web应用中,请求处理时,出现异常是非常常见的。所以当应用出现各类异常时,进行异常的捕获或者二次处理(比如sql异常正常是不能外抛)是非常必要的,比如在开发对外api服务时,约定了响应的参数格式,如respCode、respMsg,调用方根据错误码进行自己的业务逻辑。本章节就重点讲解下统一异常和数据校验处理。


springboot中,默认在发送异常时,会跳转值/error请求进行错误的展现,根据不同的Content-Type展现不同的错误结果,如json请求时,直接返回json格式参数。


浏览器访问异常时:



使用postman访问时:



统一异常处理


显然,默认的异常页是对用户或者调用者而言都是不友好的,所以一般上我们都会进行实现自己业务的异常提示信息。


创建全局的统一异常处理类


利用@ControllerAdvice和@ExceptionHandler定义一个统一异常处理类


  • @ControllerAdvice:控制器增强,使@ExceptionHandler、@InitBinder、@ModelAttribute注解的方法应用到所有的 @RequestMapping注解的方法。

  • @ExceptionHandler:异常处理器,此注解的作用是当出现其定义的异常时进行处理的方法


创建异常类:CommonExceptionHandler


@ControllerAdvice

public class CommonExceptionHandler {

 

    /**

     *  拦截Exception类的异常

     * @param e

     * @return

     */

    @ExceptionHandler(Exception.class)

    @ResponseBody

    public Map<String,Object> exceptionHandler(Exception e){

        Map<String,Object> result = new HashMap<String,Object>();

        result.put("respCode", "9999");

        result.put("respMsg", e.getMessage());

        //正常开发中,可创建一个统一响应实体,如CommonResp

        return result; 

    }

}


多余不同异常(如自定义异常),需要进行不同的异常处理时,可编写多个exceptionHandler方法,注解ExceptionHandler指定处理的异常类,如


/**

 * 拦截 CommonException 的异常

 * @param ex

 * @return

 */

@ExceptionHandler(CommonException.class)

@ResponseBody

public Map<String,Object> exceptionHandler(CommonException ex){

    log.info("CommonException:{}({})",ex.getMsg(), ex.getCode());

    Map<String,Object> result = new HashMap<String,Object>();

    result.put("respCode", ex.getCode());

    result.put("respMsg", ex.getMsg());

    return result; 

}


由于加入了@ResponseBody,所以返回的是json格式,



说明异常已经被拦截了。


可拦截不同的异常,进行不同的异常提示,比如NoHandlerFoundException、HttpMediaTypeNotSupportedException、AsyncRequestTimeoutException等等,这里就不列举了,读者可自己加入后实际操作下。


对于返回页面时,返回ModelAndView即可,如


@ExceptionHandler(value = Exception.class)

    public ModelAndView defaultErrorHandler(HttpServletRequest req, Exception e) throws Exception {

        ModelAndView mav = new ModelAndView();

        mav.addObject("exception", e);

        mav.addObject("url", req.getRequestURL());

        mav.setViewName(DEFAULT_ERROR_VIEW);

        return mav;

    }


由于工作中都是才有前后端分离开发模式,所以一般上都没有直接返回资源页的需求了,一般上都是返回固定的响应格式,如respCode、respMsg、data,前端通过判断respCode的值进行业务判断,是弹窗还是跳转页面。


数据校验


在web开发时,对于请求参数,一般上都需要进行参数合法性校验的,原先的写法时一个个字段一个个去判断,这种方式太不通用了,所以java的JSR 303: Bean Validation规范就是解决这个问题的。


JSR 303只是个规范,并没有具体的实现,目前通常都是才有hibernate-validator进行统一参数校验。


JSR303定义的校验类型



Hibernate Validator 附加的 constraint



创建实体类


@Data

@NoArgsConstructor

@AllArgsConstructor

public class DemoReq {

     

    @NotBlank(message="code不能为空")

    String code;

     

    @Length(max=10,message="name长度不能超过10")

    String name;

}


然后在控制层方法里,加入@Valid即可,这样在访问前,会对请求参数进行检验。


@GetMapping("/demo/valid")

public String demoValid(@Valid DemoReq req) {

    return req.getCode() + "," + req.getName();

}


启动,后访问http://127.0.0.1:8080/demo/valid



加上正确参数后,http://127.0.0.1:8080/demo/valid?code=3&name=s



这样数据的统一校验就完成了,对于其他注解的使用,大家可自行谷歌下,基本上都很简单的,对于已有的注解无法满足校验需要时,也可进行自定义注解的开发,一下简单讲解下,自定义注解的编写


不使用@valid的情况下,也可利用编程的方式编写一个工具类,进行实体参数校验


public class ValidatorUtil {

    private static Validator validator = ((HibernateValidatorConfiguration) Validation

            .byProvider(HibernateValidator.class).configure()).failFast(true).buildValidatorFactory().getValidator();

 

    /**

     * 实体校验

     * 

     * @param obj

     * @throws CommonException

     */

    public static <T> void validate(T obj) throws CommonException {

        Set<ConstraintViolation<T>> constraintViolations = validator.validate(obj, new Class[0]);

        if (constraintViolations.size() > 0) {

            ConstraintViolation<T> validateInfo = (ConstraintViolation<T>) constraintViolations.iterator().next();

            // validateInfo.getMessage() 校验不通过时的信息,即message对应的值

            throw new CommonException("0001", validateInfo.getMessage());

        }

    }

}


使用


@GetMapping("/demo/valid")

public String demoValid(@Valid DemoReq req) {

    //手动校验

    ValidatorUtil.validate(req);

    return req.getCode() + "," + req.getName();

}


自定义校验注解


自定义注解,主要时实现ConstraintValidator的处理类即可,这里已编写一个校验常量的注解为例:参数值只能为特定的值。


自定义注解


@Documented

//指定注解的处理类

@Constraint(validatedBy = {ConstantValidatorHandler.class })

@Target({ METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER })

@Retention(RUNTIME)

public @interface Constant {

 

   String message() default "{constraint.default.const.message}";

 

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

 

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

 

   String value();

}


注解处理类


public class ConstantValidatorHandler implements ConstraintValidator<Constant, String> {

 

    private String constant;

 

    @Override

    public void initialize(Constant constraintAnnotation) {

        //获取设置的字段值

        this.constant = constraintAnnotation.value();

    }

 

    @Override

    public boolean isValid(String value, ConstraintValidatorContext context) {

        //判断参数是否等于设置的字段值,返回结果

        return constant.equals(value);

    }

}


使用


@Constant(message = "verson只能为1.0",value="1.0")

String version;


运行:


此时,自定义注解已生效。大家可根据实际需求进行开发。


大家看到在校验不通过时,返回的异常信息是不友好的,此时可利用统一异常处理,对校验异常进行特殊处理,特别说明下,对于异常处理类,共有以下几种情况(被@RequestBody和@RequestParam注解的请求实体,校验异常类是不同的)


@ExceptionHandler(MethodArgumentNotValidException.class)

    public Map<String,Object> handleBindException(MethodArgumentNotValidException ex) {

        FieldError fieldError = ex.getBindingResult().getFieldError();

        log.info("参数校验异常:{}({})", fieldError.getDefaultMessage(),fieldError.getField());

        Map<String,Object> result = new HashMap<String,Object>();

        result.put("respCode", "01002");

        result.put("respMsg", fieldError.getDefaultMessage());

        return result;

    }

 

 

    @ExceptionHandler(BindException.class)

    public Map<String,Object> handleBindException(BindException ex) {

        //校验 除了 requestbody 注解方式的参数校验 对应的 bindingresult 为 BeanPropertyBindingResult

        FieldError fieldError = ex.getBindingResult().getFieldError();

        log.info("必填校验异常:{}({})", fieldError.getDefaultMessage(),fieldError.getField());

        Map<String,Object> result = new HashMap<String,Object>();

        result.put("respCode", "01002");

        result.put("respMsg", fieldError.getDefaultMessage());

        return result;

    }


启动后,提示就友好了



所以统一异常还是很有必要的。


总结


本章节主要是阐述了统一异常处理和数据的合法性校验,同时简单实现了一个自定义的注解类,大家在碰见已有注解无法解决时,可通过自定义的形式进行,当然对于通用而已,利用@Pattern(正则表达式)基本上都是可以实现的。


最后


目前互联网上很多大佬都有springboot系列教程,如有雷同,请多多包涵了。本文是作者在电脑前一字一句敲的,每一步都是实践的。若文中有所错误之处,还望提出,谢谢。


系列



【关于投稿】


如果大家有原创好文投稿,请直接给公号发送留言。


① 留言格式:
【投稿】+《 文章标题》+ 文章链接

② 示例:
【投稿】《不要自称是程序员,我十多年的 IT 职场总结》:http://blog.jobbole.com/94148/

③ 最后请附上您的个人简介哈~



看完本文有收获?请转发分享给更多人

关注「ImportNew」,提升Java技能

登录查看更多
1

相关内容

干净的数据:数据清洗入门与实践,204页pdf
专知会员服务
161+阅读 · 2020年5月14日
【实用书】Python爬虫Web抓取数据,第二版,306页pdf
专知会员服务
116+阅读 · 2020年5月10日
【实用书】流数据处理,Streaming Data,219页pdf
专知会员服务
76+阅读 · 2020年4月24日
【经典书】Python数据数据分析第二版,541页pdf
专知会员服务
192+阅读 · 2020年3月12日
【干货】大数据入门指南:Hadoop、Hive、Spark、 Storm等
专知会员服务
95+阅读 · 2019年12月4日
【初学者系列】tensorboard学习笔记
专知
7+阅读 · 2019年10月4日
已删除
创业邦杂志
5+阅读 · 2019年3月27日
介绍WAF以及过滤机制
黑白之道
22+阅读 · 2019年2月5日
自动文本摘要
AI研习社
21+阅读 · 2018年10月27日
Spark的误解-不仅Spark是内存计算,Hadoop也是内存计算
Arxiv
12+阅读 · 2018年9月5日
Arxiv
11+阅读 · 2018年1月18日
VIP会员
相关资讯
【初学者系列】tensorboard学习笔记
专知
7+阅读 · 2019年10月4日
已删除
创业邦杂志
5+阅读 · 2019年3月27日
介绍WAF以及过滤机制
黑白之道
22+阅读 · 2019年2月5日
自动文本摘要
AI研习社
21+阅读 · 2018年10月27日
Spark的误解-不仅Spark是内存计算,Hadoop也是内存计算
Top
微信扫码咨询专知VIP会员