在Java Web开发中，拦截器（Interceptor）是一个非常重要的组件，它可以帮助我们在请求的处理流程中进行特定的操作，比如权限验证、日志记录等。本文将详细介绍Java中的三个核心拦截器方法：preHandle、postHandle和afterCompletion，并通过代码示例和表格对比来阐述它们的具体区别和应用场景。

preHandle方法详解

调用时机 preHandle方法在Controller方法处理之前被调用。如果preHandle方法返回false，则后续的Controller方法将不会执行。

方法签名

public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception;

代码示例

public class MyInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        // 权限验证逻辑
        if (!checkPermission(request)) {
            response.sendError(HttpServletResponse.SC_FORBIDDEN, "Access Denied");
            return false;
        }
        return true;
    }
    private boolean checkPermission(HttpServletRequest request) {
        // 具体的权限验证逻辑
        return true;
    }
}

postHandle方法详解

调用时机 postHandle方法在Controller方法处理之后，但在视图渲染之前被调用。

方法签名

public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception;

代码示例

public class MyInterceptor implements HandlerInterceptor {
    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        // 修改ModelAndView对象
        if (modelAndView != null) {
            modelAndView.addObject("globalMessage", "This is a global message");
        }
    }
}

afterCompletion方法详解

调用时机 afterCompletion方法在DispatcherServlet进行视图渲染之后被调用，通常用于清理资源。

方法签名

public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception;

代码示例

public class MyInterceptor implements HandlerInterceptor {
    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        // 清理资源逻辑
        if (ex != null) {
            log.error("Request processing failed", ex);
        }
    }
}

方法对比

流程步骤

1. 客户端发起请求
2. 拦截器链中的preHandle方法依次执行 如果preHandle返回false，则中断请求处理流程
3. Controller方法处理请求
4. 拦截器链中的postHandle方法依次执行 可以对ModelAndView对象进行修改
5. 视图渲染
6. 拦截器链中的afterCompletion方法依次执行 用于清理资源

应用场景

通过本文的介绍，我们可以了解到preHandle、postHandle和afterCompletion三个方法在Java拦截器中的作用和区别。preHandle适用于在请求处理前进行权限验证等操作，postHandle适用于在Controller方法处理后进行统一的请求后处理，而afterCompletion则适用于在视图渲染后进行资源清理等操作。在实际开发中，合理利用这些拦截器方法可以大大提高代码的可维护性和扩展性。