單元測試(一)：我的第一個單元測試

一.創建項目並在被測試項目中編寫程式碼

     分別建立兩個類庫項目：被測試項目（Demo）和 測試項目（命名規範：在被項目項目後添加.Tests   Demo.Tests）  

     在Demo中添加如下程式碼：

 1 namespace Demo
 2 {
 3     public class FileVerify
 4     {
 5         public bool IsValidFileName(string filename)
 6         {
 7             if(filename.EndsWith(".txt"))
 8             {
 9                 return true;
10             }
11             return false;
12         }
13     }
14 }

 

二.安裝測試框架NUit,需要安裝兩個包（下圖所示）

NUint是編寫單元測試框架用的包

NUnit3TestAdapter是適配VS中的測試資源管理器的 

注意：如果只安裝NUnit包，在測試資源管理器中點擊運行測試 則不會執行 而會提示：測試未運行

 

三.在Demo.Tests中編寫單元測試

 1 using NUnit.Framework;
 2 
 3 namespace Demo.Tests
 4 {
 5     [TestFixture]
 6     public class FileVerifyTests
 7     {
 8         [Test]
 9         public void IsValidFileName_BadExtensions_ReturnFalse()
10         {
11             FileVerify fileVerify = MakFileVerify();
12 
13             var result = fileVerify.IsValidFileName("filename.too");
14 
15             Assert.False(result);
16         }
17 
18 
19         private FileVerify MakFileVerify()
20         {
21             return new FileVerify();
22         }
23     }
24 }

1.Demo.Tests項目需先引用項目Demo

2.需引用NUnit.Framework命名空間

3.添加Attribute

   [TestFixture]：添加到類上，標識該類包含自動化測試 

   [Test]：添加到方法上，標識該方法是一個需要調用的自動化測試   

   標註了這兩個Attribute 測試資源管理器中就可以找到該測試方法了

4.測試方法訪問修飾符必須為public 返回值類型必須為void 

5.測試方法名稱【IsValidFileName_BadExtensions_ReturnFalse】 命名三個部分：

    ①【工作單元名】如果工作單元是一個方法，那就是方法名；如果工作單元是一組方法，那名稱需要抽象一點，涵蓋這一組方法。

    ②【測試進行的假設條件】假設條件可以從兩方面來理解：一是描述傳給方法的參數，例如本例中的【BadExtensions】二是描述系統的初始狀態

    ③【預期】對測試方法的預期。測試方法有3中行為：返回一個值（真實值或異常）【例如本例中的RetureFalse】、改變系統狀態、調用第三方系統

    然後將①②③用_連接起來  這樣可讀性會很高

6.方法體包含三個行為：創建對象（Line 11） 操作對象（Line 13） 斷言（Line 15）  

   建議：行為之間空一行，並且不在斷言中進行函數調用，這樣有良好的可讀性，讓更多的人可以讀懂測試

7.MakeFileVerify方法是一個工廠方法，這樣做的目的是為了：當之後FileVerify的構造函數發生變化後 只需要改動這一個地方  為單元測試的可維護性打下了基礎

8.Assert.False（）是NUnit框架中斷言的方法

 

四.對該測試添加正驗證

     對於上面的測試從邏輯上講不是完整的，我們還需要考慮擴展名的大小寫，所以我們添加大寫和小寫後綴的測試，程式碼如下

        [Test]
        public void IsValidFileName_GoodExtensionLower_ReturnTrue()
        {
            FileVerify fileVerify = MakFileVerify();

            var result = fileVerify.IsValidFileName("filename.txt");

            Assert.True(result);
        }

        [Test]
        public void IsValidFileName_GoodExtensionUpper_ReturnTrue()
        {
            FileVerify fileVerify = MakFileVerify();

            var result = fileVerify.IsValidFileName("filename.TXT");

            Assert.True(result);
        }

     然後執行測試，發現大寫測試失敗，測試結果如下

     

     這個時候我們需要修改產品程式碼,修改位置在Line 3，忽略大小寫，程式碼修改如下

1         public bool IsValidFileName(string filename)
2         {
3             if(filename.EndsWith(".txt",StringComparison.CurrentCultureIgnoreCase))
4             {
5                 return true;
6             }
7             return false;
8         }

      這個時候重新運行測試，3個測試就全部通過了

 

五.使用NUnit的【參數化測試】功能重構測試 

 1         [TestCase("filename.txt")]
 2         [TestCase("filename.TXT")]
 3         public void IsValidFileName_GoodExtension_ReturnTrue(string filename)
 4         {
 5             FileVerify fileVerify = MakFileVerify();
 6 
 7             var result = fileVerify.IsValidFileName(filename);
 8 
 9             Assert.True(result);
10         }

     1.將方法上標記的[Test]替換為[TestCase(“參數”)]

     2.重新命名測試方法將GoodExtension後的大小寫去除，變得更通用

     3.將測試方法參數中定義一個參數filename

     4.把測試中硬編碼的值替換成這個測試方法的參數

     5.把替換掉的值放到[TestCase(param1)]中

     測試運行器會將TestCase括弧中的參數賦值給測試方法的參數；可以在一個測試方法上添加多個[TestCase]

六.測試預期異常   保證當異常應該拋出時，被測試的方法能夠正確的拋出異常

     當用戶輸入的文件名為null或空時，這個時候應該拋出ArgumentException異常。如果程式碼沒有拋出異常，那麼測試就是失敗的

     修改後的產品程式碼為

 1         public bool IsValidFileName(string filename)
 2         {
 3             if (string.IsNullOrWhiteSpace(filename))
 4             {
 5                 throw new ArgumentException();
 6             }
 7             if (filename.EndsWith(".txt", StringComparison.CurrentCultureIgnoreCase))
 8             {
 9                 return true;
10             }
11             return false;
12         }

     添加的測試為

1         [Test]
2         public void IsValidFileName_EmptyFileName_Throw()
3         {
4             FileVerify fileVerify = MakFileVerify();
5 
6             var ex = Assert.Catch<ArgumentException>(() => fileVerify.IsValidFileName(""));
7 
8             StringAssert.Contains("filename has to be provided", ex.Message);
9         }

      這樣一個簡單的測試就完成了！

      如有錯誤之處，請指出！

 

     

 

Tags:

VirMach 便宜 VPS

QNews

QNews