spring boot freemarker 错误页 springboot错误页面处理

　　springboot作为微服务的便捷框架，在错误页面处理上也有了一些新的处理，不同于之前的pringmvc500的页面处理是比较简单的，用java config或者xml的形式，定义如下的Bean即可

1 <bean
 2 class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver"> 
 3   <property name="exceptionMappings"> 
 4     <props> 
 5      <prop key="org.apache.shiro.authz.UnauthenticatedException">pages/403</prop> 
 6      <prop key="org.apache.shiro.authz.UnauthorizedException">pages/403</prop> 
 7      <prop key="org.apache.shiro.authc.LockedAccountException">pages/locked</prop> 
 8      <prop key="java.lang.Throwable">pages/500</prop> 
 9     </props> 
10   </property> 
11 </bean>

　　404比较特殊，有两种方法可以参考

1.先设置 dispatcherServlet

1 @Bean
2 public ServletRegistrationBean dispatcherRegistration(DispatcherServlet dispatcherServlet) { 
3    ServletRegistrationBean registration = new ServletRegistrationBean(dispatcherServlet); 
4    dispatcherServlet.setThrowExceptionIfNoHandlerFound(true); 
5    return registration; 
6 }

@ControllerAdvice

1 @ControllerAdvice
 2 public class GlobalControllerExceptionHandler { 
 3    public static final String DEFAULT_ERROR_VIEW = "pages/404"; 
 4 
 5 @ExceptionHandler(value = NoHandlerFoundException.class) 
 6 public ModelAndView defaultErrorHandler(HttpServletRequest req, Exception e) throws Exception { 
 7     ModelAndView mav = new ModelAndView(); 
 8      mav.addObject("exception", e); 
 9      mav.addObject("url", req.getRequestURL()); 
10      mav.setViewName(DEFAULT_ERROR_VIEW); 
11      return mav; 
12    } 
13  }

　　不过上面这种处理方法，会造成对js，css等资源的过滤，最好使用第二种方法

2.集成 ErrorController

1 @Controller
 2 public class MainsiteErrorController implements ErrorController { 
 3 
 4   private static final String ERROR_PATH = "/error"; 
 5 
 6 @RequestMapping(value=ERROR_PATH) 
 7 public String handleError(){ 
 8     return "pages/404"; 
 9 } 
10 
11 @Override
12 public String getErrorPath() { 
13       // TODO Auto-generated method stub 
14       return ERROR_PATH; 
15     } 
16   }

3.拦截器的方法

　　今天给大家介绍一下SpringBoot中拦截器的用法，相比Struts2中的拦截器，SpringBoot的拦截器就显得更加方便简单了。
只需要写几个实现类就可以轻轻松松实现拦截器的功能了，而且不需要配置任何多余的信息，对程序员来说简直是一种福利啊。
废话不多说，下面开始介绍拦截器的实现过程：

第一步：创建我们自己的拦截器类并实现  HandlerInterceptor

1 package example.Interceptor;
 2 import javax.servlet.http.HttpServletRequest;
 3 import javax.servlet.http.HttpServletResponse;
 4 import org.springframework.stereotype.Controller;
 5 import org.springframework.web.bind.annotation.RequestMapping;
 6 import org.springframework.web.servlet.HandlerInterceptor;
 7 import org.springframework.web.servlet.ModelAndView;
 8 
 9 /**
10  * 自定义拦截器1 
11  *
12  * @author 林志强(208017534)
13  * @myblog www.wolzq.com
14  * @create 2016年9月20日
15  */
16 @Controller
17 public class ErrorInterceptor implements HandlerInterceptor {
18 
19     /**
20      * preHandle方法是进行处理器拦截用的，顾名思义，该方法将在Controller处理之前进行调用，SpringMVC中的Interceptor拦截器是链式的，可以同时存在 
21      * 多个Interceptor，然后SpringMVC会根据声明的前后顺序一个接一个的执行，而且所有的Interceptor中的preHandle方法都会在 
22      * Controller方法调用之前调用。SpringMVC的这种Interceptor链式结构也是可以进行中断的，这种中断方式是令preHandle的返 
23      * 回值为false，当preHandle的返回值为false的时候整个请求就结束了。 
24      */
25     @Override
26     public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
27         throws Exception {
28         System.out.println(">>>MyInterceptor1>>>>>>>在请求处理之前进行调用（Controller方法调用之前）");
29         return true;// 只有返回true才会继续向下执行，返回false取消当前请求 
30     }
31     /**
32      * 这个方法只会在当前这个Interceptor的preHandle方法返回值为true的时候才会执行。postHandle是进行处理器拦截用的，它的执行时间是在处理器进行处理之 
33      * 后，也就是在Controller的方法调用之后执行，但是它会在DispatcherServlet进行视图的渲染之前执行，也就是说在这个方法中你可以对ModelAndView进行操 
34      * 作。这个方法的链式结构跟正常访问的方向是相反的，也就是说先声明的Interceptor拦截器该方法反而会后调用，这跟Struts2里面的拦截器的执行过程有点像， 
35      * 只是Struts2里面的intercept方法中要手动的调用ActionInvocation的invoke方法，Struts2中调用ActionInvocation的invoke方法就是调用下一个Interceptor 
36      * 或者是调用action，然后要在Interceptor之前调用的内容都写在调用invoke之前，要在Interceptor之后调用的内容都写在调用invoke方法之后。 
37      */
38     @Override
39     public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler,
40                            ModelAndView modelAndView) throws Exception {
41         System.out.println(">>>MyInterceptor1>>>>>>>请求处理之后进行调用，但是在视图被渲染之前（Controller方法调用之后）");
42         if(response.getStatus()==500){
43             modelAndView.setViewName("/errorpage/500");
44         }else if(response.getStatus()==404){
45             modelAndView.setViewName("/errorpage/404");
46         }
47     }
48 
49     /**
50      * 该方法也是需要当前对应的Interceptor的preHandle方法的返回值为true时才会执行。该方法将在整个请求完成之后，也就是DispatcherServlet渲染了视图执行， 
51      * 这个方法的主要作用是用于清理资源的，当然这个方法也只能在当前这个Interceptor的preHandle方法的返回值为true时才会执行。 
52      */
53     @Override
54     public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)
55         throws Exception {
56         System.out.println(">>>MyInterceptor1>>>>>>>在整个请求结束之后被调用，也就是在DispatcherServlet 渲染了对应的视图之后执行（主要是用于进行资源清理工作）");
57     }
58 }

第二步：创建一个Java类继承WebMvcConfigurerAdapter，并重写 addInterceptors 方法。

　　实例化我们自定义的拦截器，然后将对像手动添加到拦截器链中（在addInterceptors方法中添加）。

1 import example.Interceptor.ErrorInterceptor;
 2 import example.Interceptor.MyInterceptor2;
 3 import org.springframework.context.annotation.Configuration;
 4 import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
 5 import org.springframework.web.servlet.config.annotation.WebMvcConfigurerAdapter;
 6 @Configuration
 7 public class MyWebAppConfigurer extends WebMvcConfigurerAdapter {
 8     @Override
 9     public void addInterceptors(InterceptorRegistry registry) {
10 // 多个拦截器组成一个拦截器链 
11 // addPathPatterns 用于添加拦截规则 
12 // excludePathPatterns 用户排除拦截 
13         registry.addInterceptor(new ErrorInterceptor()).addPathPatterns("/**");
14         super.addInterceptors(registry);
15     }
16 
17 }

　　到这里拦截器就基本实现了，我上面给出的例子中是可以实现对404或者500的拦截。
不过需要注意的是，这种拦截有时候也会出现特别大问题。例如一个网页中如果需要加载很多的图片或者js文件资源，可是正好没有这个资源，也就是找不到这么多个资源报一堆的404错误。这个时候如果还是单纯的使用这种拦截就会出现null指针异常的情况。
　　针对这种情况，我研究了一种方法可以解决这样类似的问题。
　　解决方案就是：创建一个类并实现 ErrorController 接口，这样就可以利用这个类来处理上面发生的问题了。
下面给出代码：

1 package example.controller; 
 2 import org.springframework.boot.autoconfigure.web.ErrorController; 
 3 import org.springframework.stereotype.Controller; 
 4 import org.springframework.web.bind.annotation.RequestMapping; 
 5 @Controller 
 6 public class MainsiteErrorController implements ErrorController { 
 7      
 8     private static final String ERROR_PATH = "/error"; 
 9 
10 @RequestMapping(value=ERROR_PATH) 
11 public String handleError(){ 
12      return "errorpage/error"; 
13 } 
14 @Override 
15 public String getErrorPath() { 
16      return ERROR_PATH; 
17    } 
18 }

这样就可以实现对404,500等错误信息的拦截了，而且也不会发生那种空指针异常的情况了！