Spring中的@ControllerAdvice三种用法详解
@ControllerAdvice三种用法
首先,@ControllerAdvice本质上是一个@Component,因此也会被当成组建扫描。
加了@ControllerAdvice的类为那些声明了(@ExceptionHandler、@InitBinder 或 @ModelAttribute注解修饰的)方法的类而提供的 专业化的@Component , 以供多个 Controller类所共享。 说白了,就是aop思想的一种实现,你告诉我需要拦截规则,我帮你把他们拦下来,具体你想做更细致的拦截筛选和拦截之后的处理, 你自己通过@ExceptionHandler、@InitBinder 或 @ModelAttribute这三个注解以及被其注解的方法来自定义。
- @ExceptionHandler注解标注的方法:用于捕获Controller中抛出的不同类型的异常,从而达到异常全局处理的目的;
- @InitBinder注解标注的方法:用于请求中注册自定义参数的解析,从而达到自定义请求参数格式的目的;
- @ModelAttribute注解标注的方法:表示此方法会在执行目标Controller方法之前执行
这三个注解都可以在普通的Controller类上使用,ControllerAdvice只是作用范围可以自定义(默认全部)
1.作用范围
ControllerAdvice 提供了多种指定Advice规则的定义方式,默认什么都不写,则是Advice所有Controller,当然你也可以通过下列的方式指定规则 比如:
- 指定包
//匹配org.my.pkg包及其子包下的所有Controller @ControllerAdvice(basePackages="org.my.pkg") //当然也可以用数组的形式指定,如: @ControllerAdvice(basePackages={"org.my.pkg", "org.my.other.pkg"}),
- 指定注解
也可以通过指定注解来匹配,比如我自定了一个 @CustomAnnotation 注解,我想匹配所有被这个注解修饰的 Controller, 可以这么写:
@ControllerAdvice(annotations={CustomAnnotation.class})
2.预设全局数据 @ModelAttribute
使用@ModelAttribute可以在controller请求前存入数据
// 1.无返回值方法,放入Model,自定义 key ,value @ModelAttribute() public void presetParam(Model model) { model.addAttribute("globalAttr", "我是全局参数"); } // 2.不有指定name,返回值方法,返回值是map,int等,key就是map,int等,,value是返回值 @ModelAttribute() public Map<String, String> presetParam2() { Map<String, String> map1 = new HashMap<String, String>(); map1.put("key1", "value1"); return map1; } // 3.指定name,返回值方法,key就是name,value是返回值 @ModelAttribute(name = "map2") public Map<String, String> presetParam3() { Map<String, String> map = new HashMap<String, String>(); map.put("key2", "value2"); return map; } // 4.可以接受请求参数 @ModelAttribute() public void presetParam4(@RequestParam("name") String name,Model model) { model.addAttribute("name", name); }
- 使用
//1.使用Model取出 @GetMapping("model") public String methodOne(Model model) { Map<String, Object> modelMap = model.asMap(); System.out.println(modelMap.get("name").toString()); // 传入name的值 return modelMap.get("globalAttr").toString(); } //2.使用ModelMap取出 @GetMapping("modelMap") public String methodThree(ModelMap modelMap) { return modelMap.get("map").toString(); } //3.@ModelAttribute()指定key,直接取出 @GetMapping("modelAttribute") public String methodTwo(@ModelAttribute("map2") Map map2) { return map2.toString(); }
3.处理全局异常 @ExceptionHandler
// @Validated参数校验 ,解析BindingResult的错误信息并返回 @ExceptionHandler(BindException.class) @ResponseBody public JsonResult exceptionHandler(BindException e, BindingResult result) { List<FieldError> fieldErrors = result.getFieldErrors(); String collect = fieldErrors.stream().map(f -> f.getField()+":"+f.getDefaultMessage()).collect(Collectors.joining(",")); return new JsonResult(JsonResult.Validated_ERROR, collect); } //这里就是通用的异常处理器了,所有预料之外的Exception异常都由这里处理 @ExceptionHandler(Exception.class) @ResponseBody public JsonResult exceptionHandler(Exception e) { return new JsonResult(JsonResult.SYSTEM_ERROR, e.getMessage()); }
4.请求参数预处理 @InitBinder
使用默认的属性编辑器
@InitBinder public void initBinder(WebDataBinder dataBinder){ /* * 创建一个字符串微调编辑器 * 参数{boolean emptyAsNull}: 是否把空字符串("")视为 null */ StringTrimmerEditor trimmerEditor = new StringTrimmerEditor(true); /* * 注册自定义编辑器 * 接受两个参数{Class<?> requiredType, PropertyEditor propertyEditor} * requiredType:所需处理的类型 * propertyEditor:属性编辑器,StringTrimmerEditor就是 propertyEditor的一个子类 */ dataBinder.registerCustomEditor(String.class, trimmerEditor); //日期格式的字符串转换成Date对象 dataBinder.registerCustomEditor(Date.class, new CustomDateEditor(new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"), false)); dataBinder.addValidators(paramVOValidator); }
自定义属性编辑器
/** * @description: 防止xss注入 * @params: String类型转换,将所有传递进来的String进行HTML编码,防止XSS攻击 * @return: */ //@InitBinder protected void initBinder2(WebDataBinder binder) { System.out.println("22222222222222"); //自定义属性编辑器 PropertyEditorSupport binder.registerCustomEditor(String.class, new PropertyEditorSupport() { @Override public void setAsText(String text) { setValue(text == null ? null : StringEscapeUtils.escapeHtml4(text.trim())); } @Override public String getAsText() { Object value = getValue(); return value != null ? value.toString() : ""; } }); }
自定义参数校验 @Validated!!!
@Data public class ParamVO implements Serializable { @ApiModelProperty("age") private Integer age; @ApiModelProperty("name") private String name; }
@Component public class ParamVOValidator implements Validator { /** * @description: 满足条件才往下走 * @params: * @return: */ @Override public boolean supports(Class<?> clazz) { // 只支持ParamVO类型对象的校验 return ParamVO.class.equals(clazz); } /** * @description: 自定义校验规则 * @params: * @return: */ @Override public void validate(Object target, Errors errors) { ParamVO paramVO = (ParamVO) target; String userName = paramVO.getName(); if (StringUtils.isEmpty(userName) || userName.length() < 8) { errors.rejectValue("name", "valid.userNameLen", new Object[]{"minLength", 8}, "用户名不能少于8位"); } } }
@Autowired private ParamVOValidator paramVOValidator; @InitBinder public void initBinder(WebDataBinder dataBinder) { dataBinder.addValidators(paramVOValidator); }
注意!!!这三个注解都可以在普通的Controller类上使用,ControllerAdvice只是作用范围可以自定义(默认全部)
到此这篇关于Spring中的@ControllerAdvice三种用法详解的文章就介绍到这了,更多相关@ControllerAdvice三种用法内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!
相关文章
Java如何利用状态模式(state pattern)替代if else
这篇文章主要给大家介绍了关于Java如何利用状态模式(state pattern)替代if else的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧2020-11-11Spring Boot 2结合Spring security + JWT实现微信小程序登录
这篇文章主要介绍了Spring Boot 2结合Spring security + JWT实现微信小程序登录,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下2021-01-01Java8 Stream对两个 List 遍历匹配数据的优化处理操作
这篇文章主要介绍了Java8 Stream对两个 List 遍历匹配数据的优化处理操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧2020-08-08
最新评论