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等錯誤信息的攔截了,而且也不會發生那種空指針異常的情況了!