您的位置:

SpringBoot全局异常处理注解

一、@ControllerAdvice注解

在Spring Boot开发中,开发人员通常需要在代码中对异常进行处理。可以使用@ControllerAdvice注解定义一个类,该类中可以定义多个@ExceptionHandler注解方法来实现对全局异常的处理。

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(value = Exception.class)
    @ResponseBody
    public Map handleException(Exception e){
        Map
    map = new HashMap<>();
        map.put("code","500");
        map.put("message",e.getMessage());
        return map;
    }
}

   
  

使用@ControllerAdvice注解定义的异常处理类,其中使用@ExceptionHandler注解标注的方法可以捕捉到对应的异常类型并进行处理。在上面的例子中,handleException方法捕捉到了Exception类型的异常,并返回了一个Map对象,其中包含了异常的状态码和错误信息。

二、@RestControllerAdvice注解

@RestControllerAdvice注解与@ControllerAdvice注解类似,但是在返回值类型上有所不同。使用@RestControllerAdvice注解定义的异常处理类,其中使用@ExceptionHandler注解标注的方法返回值为Object类型。以下是一个使用@RestControllerAdvice注解的异常处理类的例子:

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(value = Exception.class)
    public Object handleException(Exception e){
        Map map = new HashMap<>();
        map.put("code","500");
        map.put("message",e.getMessage());
        return map;
    }
}

  

在这个例子中,handleException方法的返回值为Object类型。在方法中,定义了返回值为Map类型的变量map,序列化后返回该变量。

三、@ExceptionHandler注解

除了在@ControllerAdvice或@RestControllerAdvice注解标注的类中使用@ExceptionHandler注解处理异常外,在Controller中也可以使用该注解来处理局部异常。以下是一个Controller中使用@ExceptionHandler注解处理异常的例子:

@RestController
@RequestMapping("/demo")
public class DemoController {

    @ExceptionHandler(value = Exception.class)
    public Map handleException(Exception e){
        Map
    map = new HashMap<>();
        map.put("code","500");
        map.put("message",e.getMessage());
        return map;
    }

    @GetMapping("/{id}")
    public Map
     getDemoById(@PathVariable int id){
        // 模拟获取实体对象的过程
        if(id == 1){
            throw new RuntimeException("ID不能为1");
        }
        Map
      map = new HashMap<>();
        map.put("id",id);
        map.put("name","demo");
        return map;
    }
}

     
    
   
  

在上面的例子中,当Controller的getDemoById方法执行时,如果抛出了RuntimeException异常,handleException方法就会被调用并返回一个Map对象。如果没有抛出异常,则正常返回实体对象。

四、@ResponseStatus注解

@ResponseStatus注解可以用来定义异常的HTTP响应状态码和自定义的异常消息。在Spring Boot开发中,我们可以使用该注解来管理相同类型的异常,并为它们指定相同的HTTP响应状态码和自定义异常信息。以下是一个使用@ResponseStatus注解的例子:

@ResponseStatus(value = HttpStatus.FORBIDDEN, reason = "Forbidden")
public class ForbiddenException extends RuntimeException {
}

在上面的例子中,定义了一个ForbiddenException类,并使用@ResponseStatus注解为该异常定义了返回状态码为403,错误信息为"Forbidden"。

五、结合自定义异常使用

在开发中,我们经常会使用自定义异常来处理业务中的异常情况。这个时候,结合上面介绍的注解进行全局异常处理会更加方便。以下是一个使用自定义异常和全局异常处理注解的例子:

@ResponseStatus(value = HttpStatus.FORBIDDEN, reason = "Forbidden")
public class ForbiddenException extends RuntimeException {
}

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(value = ForbiddenException.class)
    public Map handleForbiddenException(ForbiddenException e){
        Map
    map = new HashMap<>();
        map.put("code","403");
        map.put("message",e.getMessage());
        return map;
    }

    @ExceptionHandler(value = Exception.class)
    public Map
     handleException(Exception e){
        Map
      map = new HashMap<>();
        map.put("code","500");
        map.put("message",e.getMessage());
        return map;
    }
}

@RestController
@RequestMapping("/demo")
public class DemoController {

    @GetMapping("/{id}")
    public Map
       getDemoById(@PathVariable int id){
        // 模拟获取实体对象的过程
        if(id == 1){
            throw new ForbiddenException();
        }
        Map
       
        map = new HashMap<>(); map.put("id",id); map.put("name","demo"); return map; } }
       
      
     
    
   
  

在上面的例子中,定义了一个自定义异常ForbiddenException,并使用@ResponseStatus注解为该异常定义了返回状态码为403和错误信息为"Forbidden"。在全局异常处理注解中,分别使用@ExceptionHandler注解处理ForbiddenException和Exception两个异常类型,并分别返回了对应的Map对象。在Controller中,如果抛出了ForbiddenException异常,handleForbiddenException方法就会被调用并返回一个Map对象,如果抛出了其他类型的异常,则调用handleException方法返回Map对象。

六、总结

在Spring Boot开发中,合理使用全局异常处理注解可以避免在代码中出现大量的重复代码。在定义注解时,需注意注解的使用范围和返回值类型。结合自定义异常使用,可更好地管理代码异常情况。