Dojo 敏捷開發：集成 DOH 單元測試到 Ant build

 java -jar ../shrinksafe/js.jar runner.js testModule= ${yourmodule} 

               
 <target name="runUT"> 
    <java jar="dojo/util/shrinksafe/js.jar" fork="true" 
           failonerror="true"> 
        <arg value="dojo/util/doh/runner.js"/> 
        <arg value="dojoUrl=dojo/dojo/dojo.js"/> 
        <arg value="dohBase=dojo/util/doh/"/> 
        <arg value="testUrl=tests/module.js"/> 
        <arg value="testModule=tests.module"/> 
    </java> 
 </target> 

               
 dojo.provide("tests.sampleTest"); 
 doh.register("tests.sampleTest", [ function test_sample() { 
 doh.assertEqual("b", "a"); 
 } ]); 

 run: 
     [java] ------------------------------------------------------------ 
     [java] The Dojo Unit Test Harness, $Rev: 24146 $ 
     [java] Copyright (c) 2011, The Dojo Foundation, All Rights Reserved 
     [java] ------------------------------------------------------------ 
     [java] 1 tests to run in 1 groups 
     [java] ------------------------------------------------------------ 
     [java] GROUP "tests.sampleTest" has 1 test to run 
     [java] _AssertFailure: doh._AssertFailure: assertEqual() failed: 
     [java] expected 
     [java] b 
     [java] but got 
     [java] a 
     [java] : assertEqual() failed: 
     [java] expected 
     [java] b 
     [java] but got 
     [java] a 
     [java] doh._AssertFailure: assertEqual() failed: 
     [java] expected 
     [java] b 
     [java] but got 
     [java] a 
     [java] ERROR IN: 
     [java]  (function test_sample() {doh.assertEqual("b", "a");}) 
     [java] ------------------------------------------------------------ 
     [java] | TEST SUMMARY: 
     [java] ------------------------------------------------------------ 
     [java]  1 tests in 1 groups 
     [java]  0 errors 
     [java]  1 failures

BUILD FAILED </pre></td> 
    </tr> 
   </tbody> 
  </table> 
  
 
  
如果將 sampleTest.js 中 doh.assertEqual(“b”, “a”) 改為 doh.assertEqual(“a”, “a”)，就會是一個執行成功的結果，如清單 4 所示。
 
  
 
  清單 4. 成功的 DOH 單元測試運行結果 
  
 
  
 
   
 
    
 
     
               
 run: 
     [java] ------------------------------------------------------------ 
     [java] The Dojo Unit Test Harness, $Rev: 24146 $ 
     [java] Copyright (c) 2011, The Dojo Foundation, All Rights Reserved 
     [java] ------------------------------------------------------------ 
     [java] 1 tests to run in 1 groups 
     [java] ------------------------------------------------------------ 
     [java] GROUP "tests.sampleTest" has 1 test to run 
     [java] ------------------------------------------------------------ 
     [java] | TEST SUMMARY: 
     [java] ------------------------------------------------------------ 
     [java]  1 tests in 1 groups 
     [java]  0 errors 
     [java]  0 failures 
 BUILD SUCCESSFUL 
 
    
 
   
 
  
 
  
 
  
集成瀏覽器運行方式
 
  
命令行運行方式在很多方面存在著缺陷，例如：無法測試與 DOM 操作相關的代碼，無法測試瀏覽器的兼容性等等。而瀏覽器運行方式就能夠彌補這些缺陷。可是將瀏覽器運行方式集成到 Ant build 中會相對復雜一些。這種方式需要一個可訪問服務器的支持，這個服務器可以是一個部署好的公用服務器，也可以是在 build 中啟動的一個本地服務器，下面以本地服務器為例。在 build 中啟動一個本地的 Web 服務器可以使用嵌入式的 Web 服務器，例如 Jetty。
 
  
在瀏覽器運行方式中，主入口是一個 html 文件，例如 runner.html。我們可以將該文件放在 WebContent 的根目錄中，并將啟動的 Web 服務器的 Web 應用根目錄設置為 WebContent，這樣就可以通過 http://localhost/runner.html 訪問。
 
  
所以在 Ant build 中啟動單元測試就變得簡單了，只需要啟動一個瀏覽器并且訪問該地址即可，這里的瀏覽器可以是任何想要測試的瀏覽器，也可以將每種瀏覽器測試一遍。以 Firefox 為例，Ant 片段如清單 5 所示。
 
  
 
  清單 5. Ant 中啟動瀏覽器 
  
 
  
 
   
 
    
 
     
               
 <target name="runUT"> 
    <exec executable=" C:\Program Files\Mozilla Firefox\firefox.exe"> 
        <arg value="http://localhost/runner.html"/> 
 </exec> 
 </target> 
 
    
 
   
 
  
 
  
 
  
其中，executable 是瀏覽器應用程序可執行文件或命令的路徑，arg 是訪問 runner.html 的 web 路徑。這條命令可以達到啟動單元測試的目的，但是當瀏覽器被啟動起來以后這條命令就直接返回了，所以 Ant build 可能在單元測試執行結束之前就已經返回了，無法得到單元測試的執行結果。所以我們需要一個辦法讓 Ant build 等待單元測試執行結束。這時候可以借助 Web 服務器來傳遞這個消息。
 
  
我們可以實現一個服務器端的消息轉接服務，該服務可以通過 HTTP 寫入或者讀取單元測試的執行結果。在 runner.html 中添加一段 JavaScript 代碼用于在單元測試執行結束后將結果通過 Ajax 方式寫入到服務中。除此之外，我們還需要實現一個 Java 可執行類，該類以一定間隔從服務器端的服務中去取執行結果，當無法取得執行結果時等待一定間隔重試，直到取得執行結果，然后輸出執行結果并且根據執行結果 是否成功決定返回結果。在 Ant build 中，當單元測試被啟動后啟動該 Java 可執行類。通過這個方式我們可以讓 Ant build 等待單元測試執行結束并且將單元測試的結果輸出，當單元測試失敗時讓 build 失敗。
 
  
 
   
編寫消息轉接服務 
消息轉接服務是一個簡單的服務器端處理單元，以什么方式實現取決于項目的服務器端技術，可以是 Servlet、REST executor 等等。下面以 REST executor 為例實現該處理單元。
 
我們需要將寫入和讀取的 HTTP 請求都定向到這個處理單元中。寫入的 HTTP 請求附帶 HTTP 消息體，讀取的 HTTP 請求沒有 HTTP 消息體。所以該處理單元可以通過是否有 HTTP 消息體來判斷是寫入請求還是讀取請求。實現代碼如清單 6。
 
 
 清單 6. 消息轉接服務代碼示例
 
    
 
     
 
      
 
       


public class ResultService extends ReqExecutor {


       private String result = ""; 
       public ReqExecutor newInstance() { 
            return this ; 
   } 
        public HTTPResponse execute(HTTPRequest req) { 
            String body = req.getBody(); 
            if(body != null && !body.trim().equals("")) result = body; 
            else { 
               return new StringResponse(result); 
            } 
        } 

} </pre></td> 
      </tr> 
     </tbody> 
    </table> 
 
為了保證寫入和讀取的 HTTP 請求都由同一個 ResultService 對象進行處理，所以這里當 newInstance 時就返回 this。
 
將該消息注冊到 REST framework 中，并為其指定一個不與其它服務沖突的 URL，例如： ”/resultService”。
 </li> 
   
修改 DOH 的執行代碼 
在 DOH 中，runner.js 中有一個 doh._report 方法負責在單元測試執行結束后匯報執行結果。我們可以修改該方法，讓它在所有測試執行結束后把運行結果通過 Ajax 方式發送給服務器端的消息轉接服務。修改后的方法體如清單 7。
 
 
 清單 7. 修改后的 doh._report 方法
 
    
 
     
 
      
 
       
               
doh._report = function (){ 
        this .debug("| TEST SUMMARY:"); 
        this .debug(this ._line); 
        this .debug("\t", this ._testCount, "tests in", 
                             this ._groupCount, "groups"); 
        this .debug("\t", this ._errorCount, "errors"); 
        this .debug("\t", this ._failureCount, "failures"); 
  //--------------------------------------------------------------------------- 
             // 定義 request 對象，把需要寫入 build 的信息傳遞給 server 端
             var request = { 
                 //url 為用于接收參數的 rest excutor 
        url: "http://localhost/resultService", 
        handleAs: "text", 
        preventCache: true , 
        content : 
        // 總 test case 數量
        "testCount: " + this ._testCount + "\n" + 
        // 總 test suit 數量
        "groupCount: " + this ._groupCount + "\n" + 
        // 出錯數量
        "errorCount: " + this ._errorCount + "\n" + 
        // 失敗數量
        "failureCount: " + this ._failureCount + "\n" + 
        // 全部執行過程中的 log 內容
        "logBody: " + dojo.byId("logBody").innerHTML + 
                 // 執行結果是成功或者失敗，將被 Ant build 用于決定是否讓 build 失敗
        this ._errorCount + this ._failureCount > 0 ? "successful"  : "failed", 
        load: function (data, ioargs){ 
            console.log("ok"); 
        }, 
        error: function (error){ 
            console.log("error"); 
        } 
               }; 
               // 向 server 端發送 POST 請求
               dojo.xhrPost(request); 
 } 
 
      
 
     
 
    
 
 
方法體中分割線以上部分為原方法體，以下部分為增加的代碼。在該方法中可以分別通過內部變量或者 innerHTML 獲得所有已執行單元測試的統計信息（比如：test case 的數量、test suit 的數量）和執行結果（比如：出錯數量、失敗數量、執行的 log 內容）。在以上的樣例實現中，只是簡單的將所有這些內容以純文字的形式返回給消息轉接服務。如果不希望這樣，當然也可以選擇其它的方式（例如 JSON）和內容，但是這樣也同時需要修改消息轉接服務和 Ant build 中的 Java 可執行類。
 
 
   
集成 Java 可執行類到 Ant build 
這個 Java 可執行類需要提交 HTTP 請求到 http://localhost/resultService，并且獲取消息轉接服務所保存的執行結果。代碼如清單 8。
 
 
 清單 8. Java 可執行類示例
 
    
 
     
 
      
 
       


                 import java.io.IOException; 
 import java.io.InputStream; 
 import java.net.URL;

public class ResultRequest {
public static void main(String[] args) throws IOException { 
        URL u = new URL("http://localhost/resultService&quot;); 
        //int tryCounts = 0; 
        while (true ){ 
            //if(tryCounts > 60) System.exit(1); 
            //tryCounts++; 
            InputStream inStream = u.openStream(); 
            String result = readContentFromStream(inStream); 
            if (result != null && !result.trim().equals("")) { 
                System.out.println(result); 
                if (result.endsWith("failed")) System.exit(1); 
               else return ; 
            } else { 
                Thread.sleep(1000); 
            } 
        } 
    } 
 } </pre></td> 
      </tr> 
     </tbody> 
    </table> 
 
該類打開連接消息轉接服務的 URL，獲得 URL 所返回的內容，如果返回的內容為空則繼續等待，等待時間可以設置為一個合適的時間，比如 1 秒鐘；如果返回的內容不為空則說明已經取到單元測試的運行結果，然后輸出取到的結果并且從結果中獲得單元測試是否成功，如果不成功則以錯誤代碼返回，否則 直接返回。
 
將該類集成到 Ant build 中，首先將該類編譯打包，然后放在一個 build 腳本可以訪問的庫目錄中，例如 WebContent/lib。Ant 片段如清單 9。
 
 
 清單 9. 集成 Java 可執行類到 Ant
 
    
 
     
 
      
 
       
               
 <target name="testResult" depends="runUT"> 
    <java classname="ResultRequest" classpath="lib" failonerror=”true”/> 
 </target> 
 
      
 
     
 
    
 
 
該 target 在 runUT target 后執行，所包含的工作就是執行這個 Java 類。
 </li> 
  </ol> 
  
回頁首
 
  
提高代碼可測試性
 
  
根據前面的介紹，DOH 支持兩種運行模式，這兩種運行模式也可以通過不同的方式集成到 Ant build 中。但是，由于這兩種方式都有各自的特點以及所擅長的測試類型，所以我們可以通過重構代碼和編寫恰當的單元測試來提高代碼的可測試性。
 
  
首先，盡可能地將代碼中的復雜邏輯抽象為獨立的 JavaScript 邏輯模塊，以便于可以按照 JavaScript 代碼邏輯進行測試，并且使用命令行的方式進行運行。例如，Widget 中不與 DOM 內容進行交互的方法邏輯；Ajax 通信中對請求或者響應消息進行處理的邏輯代碼等等。
 
  
其次，將無法抽象成為獨立 JavaScript 邏輯模塊的代碼的測試選擇瀏覽器方式運行。例如，Widget 的行為中需要與 DOM 內容進行交互的方法；在各種瀏覽器中行為可能會不一樣的代碼等等。
 
  
通過將單元測試集成到 Ant build 中，您也可以通過自己的嘗試和摸索不斷發現其它能夠提高代碼可測試性的方法。
 
  
小結
 
  
本文首先簡單介紹了 Dojo 單元測試的幾種類型以及使用 DOH 進行 Dojo 單元測試的兩種運行方式 ，然后重點闡述了這兩種運行方式如何與 Ant build 進行集成以滿足敏捷開發的需要。將單元測試集成到 build 是敏捷開發中持續集成的關鍵要素，通過使用本文所介紹的方法將 Dojo 單元測試集成到項目的 build 中，可以使項目開發成員在開發過程中及時地發現 Dojo 代碼中的缺陷，從而提高項目的開發效率和代碼質量。
 文章出處： 
  IBM developerWorks

                    
                    

                        
 本文由用戶 jopen 自行上傳分享，僅供網友學習交流。所有權歸原作者，若您的權利被侵害，請聯系管理員。
                        
 轉載本站原創文章，請注明出處，并保留原始鏈接、圖片水印。
                        
 本站是一個以用戶分享為主的開源技術平臺，歡迎各類分享！
                        
 本文地址：http://www.baiduhome.net/lib/view/open1326714427562.html
                        
 單元測試 JavaScript
                    

                
                

                    

                        
相關經驗
                        

 
 Dojo 敏捷開發：集成 DOH 單元測試到 Ant build
  
 JavaScript 單元測試框架 DOH
  
 ANT和SVN集成 SvnAnt
  
 將CKEditor集成到Java開發環境中
  
 Dojo的移動Web開發框架 - Dojo Mobile
                         
                    
                    

                        
相關資訊
                        

 
 dojo的發展歷史
  
 敏捷開發的6個實戰經驗
  
 開發速度正在殺死敏捷嗎？
  
 敏捷開發的關鍵挑戰
  
 修復bug與解決問題——從敏捷到精益
                         
                    
                    

                        
相關文檔
                        

 
  編寫ant：build.xml的方法
  
  ANT 的最完整build.xml解釋
  
  ANT-build.xml文件詳解
  
  敏捷開發基礎
  
  敏捷開發交流 - 系統剖析圖，持續集成
  
  敏捷開發 - SCRUM
  
  Oracle EBS Form開發基礎
  
  深居淺出AutoCAD二次開發