Spring3.2新注解@ControllerAdvice

@ControllerAdvice，是spring3.2提供的新注解，从名字上可以看出大体意思是控制器增强。让我们先看看@ControllerAdvice的实现：

 

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

}

 没什么特别之处，该注解使用@Component注解，这样的话当我们使用<context:component-scan>扫描时也能扫描到，具体可参考【第十二章】零配置 之 12.3 注解实现Bean定义 ——跟我学spring3。

 

其javadoc定义是：

写道

/**
* Indicates the annotated class assists a "Controller".
*
* <p>Serves as a specialization of {@link Component @Component}, allowing for
* implementation classes to be autodetected through classpath scanning.
*
* <p>It is typically used to define {@link ExceptionHandler @ExceptionHandler},
* {@link InitBinder @InitBinder}, and {@link ModelAttribute @ModelAttribute}
* methods that apply to all {@link RequestMapping @RequestMapping} methods.
*
* @author Rossen Stoyanchev
* @since 3.2
*/

即把@ControllerAdvice注解内部使用@ExceptionHandler、@InitBinder、@ModelAttribute注解的方法应用到所有的 @RequestMapping注解的方法。非常简单，不过只有当使用@ExceptionHandler最有用，另外两个用处不大。

 

 

接下来看段代码：

 

@ControllerAdvice
public class ControllerAdviceTest {

    @ModelAttribute
    public User newUser() {
        System.out.println("============应用到所有@RequestMapping注解方法，在其执行之前把返回值放入Model");
        return new User();
    }

    @InitBinder
    public void initBinder(WebDataBinder binder) {
        System.out.println("============应用到所有@RequestMapping注解方法，在其执行之前初始化数据绑定器");
    }

    @ExceptionHandler(UnauthenticatedException.class)
    @ResponseStatus(HttpStatus.UNAUTHORIZED)
    public String processUnauthenticatedException(NativeWebRequest request, UnauthenticatedException e) {
        System.out.println("===========应用到所有@RequestMapping注解的方法，在其抛出UnauthenticatedException异常时执行");
        return "viewName"; //返回一个逻辑视图名
    }
}

 

如果你的spring-mvc配置文件使用如下方式扫描bean

 <context:component-scan base-package="com.sishuok.es" use-default-filters="false">
        <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
    </context:component-scan>

 需要把@ControllerAdvice包含进来，否则不起作用：

 <context:component-scan base-package="com.sishuok.es" use-default-filters="false">
        <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
        <context:include-filter type="annotation" expression="org.springframework.web.bind.annotation.ControllerAdvice"/>
    </context:component-scan>

 

1、@ModelAttribute注解的方法作用请参考SpringMVC强大的数据绑定（2）——第六章 注解式控制器详解——跟着开涛学SpringMVC中的【二、暴露表单引用对象为模型数据】，作用是一样的，只不过此处是对所有的@RequestMapping注解的方法都起作用。当需要设置全局数据时比较有用。

2、@InitBinder注解的方法作用请参考SpringMVC数据类型转换——第七章 注解式控制器的数据验证、类型转换及格式化——跟着开涛学SpringMVC，同1类似。当需要全局注册时比较有用。

3、@ExceptionHandler，异常处理器，此注解的作用是当出现其定义的异常时进行处理的方法，其可以使用springmvc提供的数据绑定，比如注入HttpServletRequest等，还可以接受一个当前抛出的Throwable对象。可以参考javadoc或snowolf的Spring 注解学习手札（八）补遗——@ExceptionHandler。

 

该注解非常简单，大多数时候其实只@ExceptionHandler比较有用，其他两个用到的场景非常少，这样可以把异常处理器应用到所有控制器，而不是@Controller注解的单个控制器。

 

评论

5 楼 beyond0432 2018-12-28  

引用

@ControllerAdvice，是spring3.2提供的新注解，从名字上可以看出大体意思是控制器增强。

看到这句话，我都不想往下看了，名字的字面意思是“Controller通知”，not控制器高级

4 楼 ynyee 2016-09-27  

这样就可以不用在夫类中定义@ExceptionHandler了？

3 楼 topbox163 2015-07-17  

MARK..........

2 楼 jinnianshilongnian 2013-06-11  

非常感谢 

1 楼 yingzhor 2013-06-11  

import java.util.ArrayList;
import java.util.HashMap;
import java.util.LinkedList;
import java.util.List;
import java.util.Map;

import org.springframework.validation.BindingResult;
import org.springframework.validation.FieldError;
import org.springframework.validation.ObjectError;

import com.fasterxml.jackson.annotation.JsonAutoDetect;
import com.fasterxml.jackson.annotation.JsonAutoDetect.Visibility;
import com.fasterxml.jackson.annotation.JsonProperty;

@JsonAutoDetect(fieldVisibility = Visibility.NONE, getterVisibility = Visibility.NONE, isGetterVisibility = Visibility.NONE)
public class DataBindingException extends RuntimeException {

	private static final long serialVersionUID = 4886698281191876208L;

	@JsonProperty
	private boolean success = true;
	
	@JsonProperty
	private List<String> globalErrors = new ArrayList<String>();
	
	@JsonProperty
	private Map<String, List<String>> fieldErrors = new HashMap<String, List<String>>();

	public DataBindingException(BindingResult bindingResult) {
		if (bindingResult.hasErrors()) {
			success = false;
			for (ObjectError oe :bindingResult.getGlobalErrors()) {
				this.globalErrors.add(oe.getDefaultMessage());
			}
			
			for (FieldError fe : bindingResult.getFieldErrors()) {
				String f = fe.getField();
				
				if (fieldErrors.get(f) != null) {
					fieldErrors.get(f).add(fe.getDefaultMessage());
				} else {
					List<String> list = new LinkedList<String>();
					list.add(fe.getDefaultMessage());
					fieldErrors.put(f, list);
				}
			}
		} 
	}

	// getter & setter
	// ----------------------------------------------------------------------------------------------------
	public boolean isSuccess() {
		return success;
	}

	public void setSuccess(boolean success) {
		this.success = success;
	}

	public List<String> getGlobalErrors() {
		return globalErrors;
	}

	public void setGlobalErrors(List<String> globalErrors) {
		this.globalErrors = globalErrors;
	}

	public Map<String, List<String>> getFieldErrors() {
		return fieldErrors;
	}

	public void setFieldErrors(Map<String, List<String>> fieldErrors) {
		this.fieldErrors = fieldErrors;
	}
	
}

import org.outman.mvc.exception.DataBindingException;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseBody;

@ControllerAdvice
public class ApplicationControllerAdvice {

	@ExceptionHandler(DataBindingException.class)
	public @ResponseBody Object handleBusinessException(DataBindingException ex) {
		return ex;
	}

}

给你的博客配个例子吧。