chapter07_SpringMVC的高级技术_3_处理异常

最新推荐文章于 2024-07-03 07:28:57 发布

原创最新推荐文章于 2024-07-03 07:28:57 发布 · 135 阅读

CC 4.0 BY-SA版权

本文探讨了在服务器端程序中，如何通过精细化的异常处理来改善HTTP响应状态码，避免将所有未处理的异常统一映射为500InternalServerError。介绍了如何自定义异常类并使用@ResponseStatus注解来指定特定的HTTP状态码，以及在控制器中使用@ExceptionHandler注解来处理异常，最后提出使用@ControllerAdvice创建全局异常处理器的方法。

无论在服务器端的程序是否出现异常，有一个request过来时，总会有一个response响应回去。当内部不做任何处理时，如果出现异常，就会映射成 500 Internal Server Error
有时，由于路径错误等问题造成了空指针，产生NullPointerException，如果不做处理，也会输出 500 错误；而事实上这是由于没有找到资源文件造成的。我们希望它输出404 Not Found。这需要更加精细的异常处理
抛出更加精细的异常

示例 SpittleNotFoundException.java
```
  @ResponseStatus(value = HttpStatus.NOT_FOUND, reason = "Spittle Not Found")
  public class SpittleNotFoundException extends RuntimeException {
  }
```
添加了 @ResponseStatus 注解后，如果某个控制器方法抛出了 SpittleNotFoundException 这一运行期异常时，不会响应为500，而是会响应为404(HttpStatus.NOT_FOUND)

处理异常

(1) 有时，需要根据异常类型，返回我们编写好的异常页面。而且虽然几种异常对应的都是404 error，但是它们可能需要返回不同的页面。这就需要在控制器方法中catch这些异常，并对它们进行处理

示例 SpittleController.java

  @Controller
  @RequestMapping("/spittles")
  public class SpittleController {

      ...

      @RequestMapping(method = RequestMethod.POST)
      public String saveSpittle(SpittleForm form, Model model) {

          try {
      
              spittleRepository.save(new Spittle(null, form.getMessage(), new Date(), form.getLongitude(), form.getLatitude()));

              return "redirect:/spittles";

          } catch (DuplicateSpittleException e) {

              return "error/duplicate";
      
          } catch (RuntimeException e) {

              return "error/sql";
      }

      ...
  }

这样做可以满足需求，但是当需要处理的异常情况很多时，会扰乱主体控制器方法的编写

(2) 在控制器类中添加异常处理方法

示例 SpittleController.java

  @Controller
  @RequestMapping("/spittles")
  public class SpittleController {

      ...

      @RequestMapping(method = RequestMethod.POST)
      public String saveSpittle(SpittleForm form, Model model) {

          spittleRepository.save(new Spittle(null, form.getMessage(), new Date(), form.getLongitude(), form.getLatitude()));

          return "redirect:/spittles";
      }

      @ExceptionHandler(DuplicateSpittleException.class)
      public String handleNotFound() {

          return "error/duplicate";
      }

      ...
  }

在控制器类中增加带有 @ExceptionHandler注解的方法，它可以处理控制器内所有方法中抛出的DuplicateSpittleException异常。

但是，有的时候不同的控制器可能会抛出相同的异常类型，它们应该对应着相同的异常页面；采用这种方法，会导致不同的控制器中出现几乎相同的异常处理方法

(3) 为控制器添加通知

运用"切面"的思想，可以写一个专门的类，用来处理所有的相同类型的异常。

示例 AppWideExceptionHandler.java

  @ControllerAdvice
  public class AppWideExceptionHandler {

      @ExceptionHandler(DuplicateSpittleException.class)
      public String handleDuplicateSpittle() {

          return "error/duplicate";
      }

      @ExceptionHandler(RuntimeException.class)
      public String handleOtherRuntimeException() {

          return "error/otherException";
      }
  }

带有@ControllerAdvice的类通知所有的带有@RequestMapping注解的控制器上，这个类要包含1个或多个带有@ExceptionHandler注解的方法；

@ControllerAdvice已经使用了@Component注解，所以会被@ComponentScan到

添加了@ExceptionHandler方法和控制器中添加了@RequestMapping的方法的内容相似，也是要返回一个String类型的逻辑视图名称