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 }
再增加处理错误页面的handler,加上 @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等错误信息的拦截了,而且也不会发生那种空指针异常的情况了!