文件版本	開發工具	測試平臺	工程名字	日期	作者	備註
V1.0	2016.07.05	lutianfei	none

異常處理

• 異常處理思路
  
  • 系統中異常包括兩類：預期異常和執行時異常RuntimeException，前者通過捕獲異常從而獲取異常資訊，後者主要通過規範程式碼開發、測試通過手段減少執行時異常的發生。
  • 系統的dao、service、controller出現都通過throws Exception向上丟擲，最後由springmvc前端控制器交由異常處理器進行異常處理，如下圖：

• springmvc提供全域性異常處理器（一個系統只有一個異常處理器）進行統一異常處理。

自定義異常類

• 對不同的異常型別定義異常類，繼承Exception。
  

全域性異常處理器

• 思路：
  
  • 系統遇到異常，在程式中手動丟擲，dao拋給service、service給controller、controller拋給前端控制器，前端控制器呼叫全域性異常處理器。

• 全域性異常處理器處理思路：

  • 解析出異常型別
  • 如果該異常型別是系統自定義的異常，直接取出異常資訊，在錯誤頁面展示
  • 如果該異常型別不是系統 自定義的異常，構造一個自定義的異常型別（資訊為“未知錯誤”）

• springmvc提供一個HandlerExceptionResolver介面

@Override
    public
 
 ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
        //handler就是處理器介面卡要執行Handler物件（只有method）

//        解析出異常型別
//        如果該 異常型別是系統 自定義的異常，直接取出異常資訊，在錯誤頁面展示
//        String message = null;
//        if(ex instanceof CustomException){
 

//            message = ((CustomException)ex).getMessage();
//        }else{
////            如果該 異常型別不是系統 自定義的異常，構造一個自定義的異常型別（資訊為“未知錯誤”）
//            message="未知錯誤";
//        }

        //上邊程式碼變為
        CustomException customException = null;
        if(ex instanceof CustomException){
            customException = (CustomException)ex;
        }else{
            customException = new CustomException("未知錯誤");
        }

        //錯誤資訊
        String message = customException.getMessage();

        ModelAndView modelAndView = new ModelAndView();

        //將錯誤資訊傳到頁面
        modelAndView.addObject("message", message);

        //指向錯誤頁面
        modelAndView.setViewName("error");

        return modelAndView;
    }

• 錯誤頁面
  

• 在springmvc.xml配置全域性異常處理器
  

異常測試

• 在controller、service、dao中任意一處需要手動丟擲異常。

• 如果是程式中手動丟擲的異常，在錯誤頁面中顯示自定義的異常資訊，如果不是手動丟擲異常說明是一個執行時異常，在錯誤頁面只顯示“未知錯誤”。

• 在商品修改的controller方法中丟擲異常 .
  

• 在service介面中丟擲異常：
  

• 如果與業務功能相關的異常，建議在service中丟擲異常。

• 與業務功能沒有關係的異常，建議在controller中丟擲。

• 上邊的功能，建議在service中丟擲異常。

上傳圖片

• 在修改商品頁面，新增上傳商品圖片功能。

springmvc中對多部件型別解析

• 在頁面form中提交enctype="multipart/form-data"的資料時，需要springmvc對multipart型別的資料進行解析。

上傳流程

• 在springmvc.xml中配置multipart型別解析器。
  

• 加入上傳圖片的jar

  • 上邊的解析內部使用下邊的jar進行圖片上傳。
    

• 建立圖片虛擬目錄儲存圖片

• 通過圖形介面配置：
  

• 或者直接修改tomcat的配置：

  • 在conf/server.xml檔案<host>標籤中，新增虛擬目錄 ：
    

• 注意：在圖片虛擬目錄中，一定將圖片目錄分級建立（提高i/o效能），一般我們採用按日期(年、月、日)進行分級建立。

• 上傳圖片jsp頁面

<tr>
    <td>商品圖片</td>
    <td>
        <c:if test="${items.pic !=null}">
            <img src="/pic/${items.pic}" width=100 height=100/>
            <br/>
        </c:if>
        <input type="file"  name="items_pic"/> 
    </td>
</tr>

• controller方法

@RequestMapping("/editItemsSubmit")
public String editItemsSubmit(
        Model model,
        HttpServletRequest request,
        Integer id,
        ItemsCustom itemsCustom,
        MultipartFile items_pic//接收商品圖片
        ) throws Exception {

    // 獲取校驗錯誤資訊
    if (bindingResult.hasErrors()) {
        // 輸出錯誤資訊
        List<ObjectError> allErrors = bindingResult.getAllErrors();

        for (ObjectError objectError : allErrors) {
            // 輸出錯誤資訊
            System.out.println(objectError.getDefaultMessage());

        }
        // 將錯誤資訊傳到頁面
        model.addAttribute("allErrors", allErrors);


        //可以直接使用model將提交pojo回顯到頁面
        model.addAttribute("items", itemsCustom);

        // 出錯重新到商品修改頁面
        return "items/editItems";
    }
    //原始名稱
    String originalFilename = items_pic.getOriginalFilename();
    //上傳圖片
    if(items_pic!=null && originalFilename!=null && originalFilename.length()>0){

        //儲存圖片的物理路徑
        String pic_path = "F:\\develop\\upload\\temp\\";


        //新的圖片名稱
        String newFileName = UUID.randomUUID() + originalFilename.substring(originalFilename.lastIndexOf("."));
        //新圖片
        File newFile = new File(pic_path+newFileName);

        //將記憶體中的資料寫入磁碟
        items_pic.transferTo(newFile);

        //將新圖片名稱寫到itemsCustom中
        itemsCustom.setPic(newFileName);
    }
    // 呼叫service更新商品資訊，頁面需要將商品資訊傳到此方法
    itemsService.updateItems(id, itemsCustom);

    return "success";
}

springmvc進行json互動

• 常用的兩種方式
  
  • 1、請求json、輸出json，要求請求的是json串，所以在前端頁面中需要將請求的內容轉成json，不太方便。
  • 2、請求key/value、輸出json。此方法比較常用。

json環境準備

• 載入json轉的jar包

  • springmvc中使用jackson的包進行json轉換（@requestBody和@responseBody使用下邊的包進行json轉），如下：
    

• 配置json轉換器

  • 在註解介面卡中加入messageConverters
  • 注意：如果使用<mvc:annotation-driven /> 則不用定義下邊的內容。

<!--註解介面卡 -->
    <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
        <property name="messageConverters">
        <list>
        <bean class="org.springframework.http.converter.json.MappingJacksonHttpMessageConverter"></bean>
        </list>
        </property>
    </bean>

json互動測試

輸入json串，輸出是json串

• jsp頁面（jsonTest.jsp）
  
  • 使用jquery的ajax提交json串，對輸出的json結果進行解析。

<title>json互動測試</title>
<script type="text/javascript" src="${pageContext.request.contextPath }/js/jquery-1.4.4.min.js"></script>
<script type="text/javascript">
//請求json，輸出是json
function requestJson(){

    $.ajax({
        type:'post',
        url:'${pageContext.request.contextPath }/requestJson.action',
        contentType:'application/json;charset=utf-8',
        //資料格式是json串，商品資訊
        data:'{"name":"手機","price":999}',
        success:function(data){//返回json結果
            alert(data);
        }

    });


}

• controller方法

<title>json互動測試</title>
<script type="text/javascript" src="${pageContext.request.contextPath }/js/jquery-1.4.4.min.js"></script>
<script type="text/javascript">
//請求json，輸出是json
function requestJson(){

    $.ajax({
        type:'post',
        url:'${pageContext.request.contextPath }/requestJson.action',
        contentType:'application/json;charset=utf-8',
        //資料格式是json串，商品資訊
        data:'{"name":"手機","price":999}',
        success:function(data){//返回json結果
            alert(data);
        }
    });
}

• 測試結果
  

輸入key/value，輸出是json串(常用)

• jsp頁面
  
  • 使用jquery的ajax提交key/value串，對輸出的json結果進行解析。

//請求key/value，輸出是json
function responseJson(){
    $.ajax({
        type:'post',
        url:'${pageContext.request.contextPath }/responseJson.action',
        //請求是key/value這裡不需要指定contentType，因為預設就 是key/value型別
        //contentType:'application/json;charset=utf-8',
        //資料格式是json串，商品資訊
        data:'name=手機&price=999',
        success:function(data){//返回json結果
            alert(data.name);
        }

    });
}

• controller

//請求key/value，輸出json
@RequestMapping("/responseJson")
public @ResponseBody ItemsCustom responseJson(ItemsCustom itemsCustom){

    //@ResponseBody將itemsCustom轉成json輸出
    return itemsCustom;
}

• 測試
  

RESTful支援

• RESTful架構，就是目前最流行的一種網際網路軟體架構。它結構清晰、符合標準、易於理解、擴充套件方便，所以正得到越來越多網站的採用。

• RESTful（即Representational State Transfer的縮寫）其實是一個開發理念，是對http的很好的詮釋。

• 2、http的方法規範

  • 不管是刪除、新增、更新。。使用url是一致的，如果進行刪除，需要設定http的方法為delete，同理新增也一樣
  • 後臺controller方法：判斷http方法，如果是delete執行刪除，如果是post執行新增。

• 3、對http的contentType規範

  • 請求時指定contentType，要json資料，設定成json格式的type。

REST的例子

• 查詢商品資訊，返回json資料。

• controller

  • 定義方法，進行url對映使用REST風格的url，將查詢商品資訊的id傳入controller方法。

• 輸出json使用@ResponseBody將java物件輸出json。

//查詢商品資訊，輸出json
///itemsView/{id}裡邊的{id}表示佔位符，通過@PathVariable獲取佔位符中的引數，
//如果佔位符中的名稱和形參名一致，在@PathVariable可以不指定名稱
@RequestMapping("/itemsView/{id}")
public @ResponseBody ItemsCustom itemsView(@PathVariable("id") Integer id)throws Exception{

    //呼叫service查詢商品資訊
    ItemsCustom itemsCustom = itemsService.findItemsById(id);

    return itemsCustom;

}

URL模板模式對映

• @RequestMapping(value="/ itemsView/{id}")：{×××}佔位符，請求的URL可以是“/viewItems/1”或“/viewItems/2”，通過在方法中使用@PathVariable獲取{×××}中的×××變數。

• @PathVariable用於將請求URL中的模板變數對映到功能處理方法的引數上。

  • 如果RequestMapping中表示為”/ itemsView /{id}”，id和形參名稱一致，@PathVariable不用指定名稱。

• REST方法的前端控制器配置

  • 在web.xml配置：

<!-- springmvc前端控制器，rest配置 -->
    <servlet>
        <servlet-name>springmvc_rest</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!-- contextConfigLocation配置springmvc載入的配置檔案（配置處理器對映器、介面卡等等） 如果不配置contextConfigLocation，預設載入的是/WEB-INF/servlet名稱-serlvet.xml（springmvc-servlet.xml） -->
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:spring/springmvc.xml</param-value>
        </init-param>
    </servlet>

    <servlet-mapping>
        <servlet-name>springmvc_rest</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

對靜態資源的解析

• 在配置前端控制器的url-parttern中指定/，對靜態資源的解析出現問題：
  

• 在springmvc.xml中新增靜態資源解析方法。
  

攔截器

• Spring Web MVC 的處理器攔截器類似於Servlet 開發中的過濾器Filter，用於對處理器進行預處理和後處理。

• 定義攔截器，需要實現HandlerInterceptor介面。介面中提供三個方法。

  • preHandle方法
    
    • 進入 Handler方法之前執行
    • 用於身份認證、身份授權
    • 比如身份認證，如果認證不通過表示當前使用者沒有登陸，需要此方法攔截不再向下執行
      
      • return false表示攔截，不向下執行
      • return true表示放行
  • postHandle方法
    
    • 進入Handler方法之後，返回modelAndView之前執行
    • 應用場景從modelAndView出發：將公用的模型資料(比如選單導航)在這裡傳到檢視，也可以在這裡統一指定檢視
  • afterCompletion方法
    
    • 執行Handler完成執行此方法
    • 應用場景：統一異常處理，統一日誌處理

public class HandlerInterceptor1 implements HandlerInterceptor {


    //進入 Handler方法之前執行
    //用於身份認證、身份授權
    //比如身份認證，如果認證不通過表示當前使用者沒有登陸，需要此方法攔截不再向下執行
    @Override
    public boolean preHandle(HttpServletRequest request,
            HttpServletResponse response, Object handler) throws Exception {
        //return false表示攔截，不向下執行
        //return true表示放行
        return false;
    }

    //進入Handler方法之後，返回modelAndView之前執行
    //應用場景從modelAndView出發：將公用的模型資料(比如選單導航)在這裡傳到檢視，也可以在這裡統一指定檢視
    @Override
    public void postHandle(HttpServletRequest request,
            HttpServletResponse response, Object handler,
            ModelAndView modelAndView) throws Exception {
    }

    //執行Handler完成執行此方法
    //應用場景：統一異常處理，統一日誌處理
    @Override
    public void afterCompletion(HttpServletRequest request,
            HttpServletResponse response, Object handler, Exception ex)
            throws Exception {
    }
}

攔截器配置

• 針對HandlerMapping配置
  
  • springmvc攔截器針對HandlerMapping進行攔截設定，如果在某個HandlerMapping中配置攔截，經過該 HandlerMapping對映成功的handler最終使用該 攔截器。
  • 一般不推薦使用。

<bean
    class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping">
    <property name="interceptors">
        <list>
            <ref bean="handlerInterceptor1"/>
            <ref bean="handlerInterceptor2"/>
        </list>
    </property>
</bean>
    <bean id="handlerInterceptor1" class="springmvc.intercapter.HandlerInterceptor1"/>
    <bean id="handlerInterceptor2" class="springmvc.intercapter.HandlerInterceptor2"/>

• 類全域性攔截器
  
  • springmvc配置類似全域性的攔截器，springmvc框架將配置的類似全域性的攔截器注入到每個HandlerMapping中。

攔截測試

• 測試需求 : 測試多個攔截器各各方法執行時機。

• 編寫兩個攔截

  • 兩個攔截器都放行,concole 輸出：

HandlerInterceptor1…preHandle
HandlerInterceptor2…preHandle

HandlerInterceptor2…postHandle
HandlerInterceptor1…postHandle

HandlerInterceptor2…afterCompletion
HandlerInterceptor1…afterCompletion

• 總結：

  • preHandle方法按順序執行，
  • postHandle和afterCompletion按攔截器配置的逆向順序執行。

• 攔截器1放行，攔截器2不放行,concole 輸出：

HandlerInterceptor1…preHandle
HandlerInterceptor2…preHandle
HandlerInterceptor1…afterCompletion

• 總結：

  • 攔截器1放行，攔截器2 preHandle才會執行。
  • 攔截器2 preHandle不放行，攔截器2 postHandle和afterCompletion不會執行。
  • 只要有一個攔截器不放行，postHandle不會執行。

• 攔截器1不放行，攔截器2不放行,concole 輸出：

HandlerInterceptor1…preHandle

• 總結：

  • 攔截器1 preHandle不放行，postHandle和afterCompletion不會執行。
  • 攔截器1 preHandle不放行，攔截器2不執行。

• 小結

  • 根據測試結果，對攔截器應用。
  • 比如：統一日誌處理攔截器，需要該 攔截器preHandle一定要放行，且將它放在攔截器連結中第一個位置。
  • 比如：登陸認證攔截器，放在攔截器連結中第一個位置。許可權校驗攔截器，放在登陸認證攔截器之後。（因為登陸通過後才校驗許可權）

攔截器應用（實現登陸認證）

• 需求

  • 1、使用者請求url
  • 2、攔截器進行攔截校驗
    
    • 如果請求的url是公開地址（無需登陸即可訪問的url），讓放行
    • 如果使用者session 不存在跳轉到登陸頁面
    • 如果使用者session存在放行，繼續操作。

• 登陸controller方法

@Controller
public class LoginController {

    // 登陸
    @RequestMapping("/login")
    public String login(HttpSession session, String username, String password)
            throws Exception {

        // 呼叫service進行使用者身份驗證
        // ...

        // 在session中儲存使用者身份資訊
        session.setAttribute("username", username);
        // 重定向到商品列表頁面
        return "redirect：/items/queryItems.action";
    }

    // 退出
    @RequestMapping("/logout")
    public String logout(HttpSession session) throws Exception {

        // 清除session
        session.invalidate();

        // 重定向到商品列表頁面
        return "redirect：/items/queryItems.action";
    }

}

• login.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>系統登陸</title>
</head>
<body>
<form action="${pageContext.request.contextPath }/login.action" method="post">
使用者賬號：<input type="text" name="username" /><br/>
使用者密碼 ：<input type="password" name="password" /><br/>
<input type="submit" value="登陸"/>
</form>
</body>
</html>

• 登陸認證攔截實現

public class LoginInterceptor implements HandlerInterceptor {


    //進入 Handler方法之前執行
    //用於身份認證、身份授權
    //比如身份認證，如果認證通過表示當前使用者沒有登陸，需要此方法攔截不再向下執行
    @Override
    public boolean preHandle(HttpServletRequest request,
            HttpServletResponse response, Object handler) throws Exception {

        //獲取請求的url
        String url = request.getRequestURI();
        //判斷url是否是公開 地址（實際使用時將公開 地址配置配置檔案中）
        //這裡公開地址是登陸提交的地址
        if(url.indexOf("login.action")>=0){
            //如果進行登陸提交，放行
            return true;
        }

        //判斷session
        HttpSession session  = request.getSession();
        //從session中取出使用者身份資訊
        String username = (String) session.getAttribute("username");

        if(username != null){
            //身份存在，放行
            return true;
        }

        //執行這裡表示使用者身份需要認證，跳轉登陸頁面
        request.getRequestDispatcher("/WEB-INF/jsp/login.jsp").forward(request, response);

        //return false表示攔截，不向下執行
        //return true表示放行
        return false;
    }

• 攔截器配置(同上)
  
  • 注：之前的preHandler 方法要返回true。