使用HTTP状态码 及其 Spring MVC处理捕获的异常

在默认情况下，Spring MVC处理Web请求时如果发现存在没有应用代码捕获的异常，那么会返回HTTP 500（Internal Server Error）错误。但是如果该异常是我们自己定义的并且使用@ResponseStatus注解进行修饰，那么Spring MVC则会返回指定的HTTP状态码：

@ResponseStatus(value = HttpStatus.NOT_FOUND, reason = "No Such Post")//404 Not Found
public class BlogNotFoundException extends RuntimeException {
    public PostNotFoundException(String message) {
        super(message);
    }
}

在Controller中可以这样使用它：

@GetMapping("/blogs/{id}")
public String showPost(@PathVariable("id") long id, Model model) {
    Blog blog = blogService.get(id);
    if (blog == null) throw new BlogNotFoundException("blog not found");
    model.addAttribute("blog", blog);
    return "item";
}

这样如果我们访问了一个不存在的文章，那么Spring MVC会根据抛出的BlogNotFoundException上的注解值返回一个404 Not Found给浏览器。

最佳实践

上述场景中，除了获取一篇文章的请求，还有更新和删除一篇文章的方法中都需要判断文章id是否存在。在每一个方法中都加上if (blog == null) throw new BlogNotFoundException("blog not found");是一种解决方案，但如果有10个、20个包含/posts/{id}的方法，虽然只有一行代码但让他们重复10次、20次也是非常不优雅的。

为了解决这个问题，可以将这个逻辑放在Service中实现：

public Post findBlog(long id) {
    Blog blog = blogRepository.findById(id);
    if (blog == null) throw new BlogNotFoundException("blog not found");
    return blog;
}

这样在所有的Controller方法中，只需要正常活取文章即可，所有的异常处理都交给了Spring MVC。