Spring boot全局异常捕获+按天记录日志

一、实现功能

    1、对用户ajax请求返回结果进行统一封装；

    2、系统按天自动生成日志文件，定期自动处理；

    3、系统自动捕获异常，并将异常信息(包括堆栈信息)自动输出至日志；

    4、自定义服务异常，将一些由用户操作不当的行为记录至日志，并及时反馈至页面。

二、ajax返回结果的封装

package com.example.testproject.commom;

import java.util.LinkedHashMap;

/**
 * ajax请求后需要接受的JSON
 * 统一返回值类型,便于在页面上进行统一处理
 */
public class AjaxJson {

	private boolean success = true;    // 是否成功
	private String errorCode = "-1";   //错误代码
	private String msg = "操作成功";    // 提示信息
	private LinkedHashMap body = new LinkedHashMap();//封装json的map
	
	public AjaxJson() {
	}

	/**
	 * 出现异常后调用此方法封装异常
	 * @param e 异常
	 */
	public AjaxJson(Throwable e) {
		this.success = false;
		this.errorCode = "-1";
		this.msg = e.getMessage();
	}

	public LinkedHashMap getBody() {
		return body;
	}

	public void setBody(LinkedHashMap body) {
		this.body = body;
	}

	public void put(String key, Object value){//向json中添加属性，在js中访问，请调用data.body.key
		body.put(key, value);
	}
	
	public void remove(String key){
		body.remove(key);
	}
	
	
	public String getMsg() {
		return msg;
	}

	public void setMsg(String msg) {//向json中添加属性，在js中访问，请调用data.msg
		this.msg = msg;
	}

	public boolean isSuccess() {
		return success;
	}

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

	public void setErrorCode(String errorCode) {
		this.errorCode = errorCode;
	}

	public String getErrorCode() {
		return errorCode;
	}
}

三、自定义服务异常类

package com.example.testproject.exception;

/**
 * 自定义业务异常类
 */
public class ServiceException extends RuntimeException {

	private static final long serialVersionUID = 1L;

	public ServiceException() {
		super();
	}

	public ServiceException(String message, Throwable cause, boolean enableSuppression, boolean writableStackTrace) {
		super(message, cause, enableSuppression, writableStackTrace);
	}

	public ServiceException(String message, Throwable cause) {
		super(message, cause);
	}

	public ServiceException(String message) {
		super(message);
	}

	public ServiceException(Throwable cause) {
		super(cause);
	}

}

四、全局异常捕获类 

package com.example.testproject.exception;

import com.example.testproject.commom.AjaxJson;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseBody;

import javax.servlet.http.HttpServletRequest;

/**
 * 全局异常捕获类
 */
// 过此注解声明此类为一个全局异常处理类
@ControllerAdvice
public class GlobalExceptionHandler {
	
	private static final Logger logger = LoggerFactory.getLogger(GlobalExceptionHandler.class);
	
	@ExceptionHandler(Exception.class)
	public void handleException(HttpServletRequest request, Exception e) {
		logger.error("---------------------- handleException start ---------------------- ");
		logger.error("url: [{}]", request.getRequestURL().toString());
		logger.error(e.getMessage(), e);
		logger.error("---------------------- handleException end ---------------------- ");
	}

	@ExceptionHandler(ServiceException.class)
	@ResponseBody
	public AjaxJson handleServiceException(HttpServletRequest request, ServiceException e) {
		logger.error("---------------------- handleServiceException start ---------------------- ");
		logger.error("url: [{}]", request.getRequestURL().toString());
		logger.error(e.getMessage(), e);
		logger.error("---------------------- handleServiceException end ---------------------- ");
		return new AjaxJson(e);
	}

}

五、自定义日志配置(按天输出)

    在src/main/resources下新增logback-spring.xml的日志配置文件，内容如下：

    logback
    
    
    
    
        
            %d{yyyy-MM-dd HH:mm:ss} - [%p] - %msg%n
        
    

    
    
        
            ${log.path}logback.%d{yyyy-MM-dd}.log
            30
            1GB
        
        
            %d{yyyy-MM-dd HH:mm:ss} - [%p] - %msg%n
        
    

    
        
        
    

    
    
        
        
    
    
    
        
        
    
    
    
        
        
    

注：对日志配置不熟或想更详细了解的同学，可以看《SpringBoot学习－（十）SpringBoot日志处理》这篇博客，写的十分详细。

 六、测试及结果

    6.1、测试类

@Controller
public class TestExceptionController {

    @RequestMapping("testException")
    @ResponseBody
    public AjaxJson index(String type){
        AjaxJson result = new AjaxJson();
        if("serviceE".equals(type)){
            throw new ServiceException("由于用户行为不当造成的异常！");
        } else {
            type = null;
            type.indexOf(",");
        }
        return result;
    }

}

     6.2、服务异常

     6.2.1、页面获得错误信息

    6.2.2、日志文件记录详细错误信息