ASP.Net MVC單元測試


在計算機程式設計中,單元測試是一種軟體測試方法,通過這種方法對各個原始碼單元進行測試,以確定它們是否適合使用。 換句話說,這是一個軟體開發過程,在這個過程中,應用程式中最小的可測試部分(稱為單元)被單獨和獨立地審查以便正確執行和操作。

在程式程式設計中,一個單元可以是一個完整的模組,但更常見的是一個單獨的功能或過程。 在物件導向程式設計中,一個單元通常是一個完整的介面,比如一個類,但可能是一個單獨的方法。

單元測試通常是自動的,但也可以手動完成。

單元測試的目標

單元測試的主要目標是在應用程式中使用最小的可測試軟體,並確定其行為是否與期望的完全一致。每個單元在將它們整合到模組之前分別進行測試,以測試模組之間的介面。

我們來看一個單元測試的簡單例子,在這個例子中使用單元測試選項來建立一個新的ASP.NET MVC應用程式。

第1步 - 開啟Visual Studio,然後單擊:檔案 -> 新建 -> 專案 選單選項。一個新的專案對話方塊開啟。
第2步 - 在左側窗格中,選擇:模板 -> Visual C# -> Web
第3步 - 在中間窗格中,選擇:ASP.NET Web應用程式

第4步 - 在名稱欄位中輸入專案名稱為:MVCUnitTesting,然後單擊確定 繼續。
然後將看到下面的對話方塊,要求設定ASP.NET專案的初始內容。

第5步 - 選擇MVC作為模板,不要忘記選中對話方塊底部的新增單元測試核取方塊。也可以更改測試專案名稱,但在此範例中,我們將其保持原樣,因為它是預設名稱。

專案由Visual Studio建立後,將在「解決方案資源管理器」視窗中看到許多檔案和檔案夾。

第6步 - 可以看到在解決方案資源管理器中有兩個專案。 一個是ASP.NET Web專案,另一個是單元測試專案。

第7步 - 執行這個應用程式,會看到下面的輸出。

如上圖所示,導航欄上有「首頁」,「關於」和「聯絡人」按鈕。這裡點選「關於」連結,會看到下面的檢視。

現在展開MVCUnitTestingDemo 專案,將看到 Controllers 檔案夾下的HomeController.cs 檔案。

HomeController 包含三個操作方法,如下面的程式碼所示。

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.Mvc;

namespace MVCUnitTesting.Controllers
{
    public class HomeController : Controller
    {
        public ActionResult Index()
        {
            return View();
        }

        public ActionResult About()
        {
            ViewBag.Message = "Your application description page.";

            return View();
        }

        public ActionResult Contact()
        {
            ViewBag.Message = "Your contact page.";

            return View();
        }
    }
}

展開MVCUnitTestingDemo.Tests 專案,Controllers檔案夾下的HomeControllerTest.cs檔案。

在這個HomeControllerTest類中有三個方法,如下面的程式碼所示。

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Web.Mvc;
using Microsoft.VisualStudio.TestTools.UnitTesting;
using MVCUnitTesting;
using MVCUnitTesting.Controllers;

namespace MVCUnitTesting.Tests.Controllers
{
    [TestClass]
    public class HomeControllerTest
    {
        [TestMethod]
        public void Index()
        {
            // Arrange
            HomeController controller = new HomeController();

            // Act
            ViewResult result = controller.Index() as ViewResult;

            // Assert
            Assert.IsNotNull(result);
        }

        [TestMethod]
        public void About()
        {
            // Arrange
            HomeController controller = new HomeController();

            // Act
            ViewResult result = controller.About() as ViewResult;

            // Assert
            Assert.AreEqual("Your application description page.", result.ViewBag.Message);
        }

        [TestMethod]
        public void Contact()
        {
            // Arrange
            HomeController controller = new HomeController();

            // Act
            ViewResult result = controller.Contact() as ViewResult;

            // Assert
            Assert.IsNotNull(result);
        }
    }
}

這三個方法將測試IndexAboutContact操作方法是否正常工作。要測試這三個操作方法,請轉到測試 選單。選擇:執行 -> 所有測試 項來測試這些操作方法。

現在會看到左邊的測試資源管理器,可以看到所有的測試都通過了。再新增一個動作方法,它用於列出所有的員工。首先,需要在Models 檔案夾中新增一個Employee類。
以下是Employee類的實現 -

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;

namespace MVCUnitTesting.Models
{
    public class Employee
    {
        public int ID { get; set; }
        public string Name { get; set; }
        public DateTime JoiningDate { get; set; }
        public int Age { get; set; }
    }
}

新增EmployeeController 。 右鍵單擊解決方案資源管理器 中的Controllers 檔案夾,然後選擇:新增 -> 控制器 ,它將顯示「新增基架」對話方塊。選擇:MVC 5控制器 - 空 選項,然後點選「新增」 按鈕,如下圖所示 -

新增控制器對話方塊將出現。將名稱設定為:EmployeeController,然後單擊「新增」按鈕。

Controllers 檔案夾中看到一個新的 C# 檔案 - EmployeeController.cs,該檔案夾在Visual Studio中開啟並進行編輯。這裡使用下面的程式碼更新 EmployeeController

using MVCUnitTesting.Models;
using System;
using System.Collections.Generic;
using System.Linq;

using System.Web;
using System.Web.Mvc;

namespace MVCUnitTesting.Controllers
{
    public class EmployeeController : Controller
    {
        [NonAction]

        public List<Employee> GetEmployeeList()
        {
            return new List<Employee>{
            new Employee{
               ID = 1,
               Name = "Maxsu",
               JoiningDate = DateTime.Parse(DateTime.Today.ToString()),
               Age = 23
            },

            new Employee{
               ID = 2,
               Name = "Carson",
               JoiningDate = DateTime.Parse(DateTime.Today.ToString()),
               Age = 45
            },

            new Employee{
               ID = 3,
               Name = "Kobe Bryant",
               JoiningDate = DateTime.Parse(DateTime.Today.ToString()),
               Age = 37
            },

            new Employee{
               ID = 4,
               Name = "Laura",
               JoiningDate = DateTime.Parse(DateTime.Today.ToString()),
               Age = 26
            },
         };
        }

        // GET: Employee
        public ActionResult Index()
        {
            return View();
        }

        public ActionResult Employees()
        {
            var employees = from e in GetEmployeeList()
                            orderby e.ID
                            select e;
            return View(employees);
        }
    }
}

要為Employee操作方法新增檢視,請右鍵單擊Employees方法並選擇:新增檢視…

您將看到檢視的預設名稱。從「模板」下拉選單中選擇「List」,從「模型類」下拉選單中選擇「Employee」,然後單擊「確定」。

現在需要新增一個連結到Employees列表,開啟Views/Shared 檔案夾下的_layout.cshtml 檔案,並在聯絡人 連結下面新增員工列表 連結。

<li>@Html.ActionLink("員工列表", "Employees", "Employee")</li>

以下是_layout.cshtml 的完整實現 -

<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>@ViewBag.Title - 我的 ASP.NET 應用程式</title>
    @Styles.Render("~/Content/css")
    @Scripts.Render("~/bundles/modernizr")
</head>
<body>
    <div class="navbar navbar-inverse navbar-fixed-top">
        <div class="container">
            <div class="navbar-header">
                <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
                    <span class="icon-bar"></span>
                    <span class="icon-bar"></span>
                    <span class="icon-bar"></span>
                </button>
                @Html.ActionLink("應用程式名稱", "Index", "Home", new { area = "" }, new { @class = "navbar-brand" })
            </div>
            <div class="navbar-collapse collapse">
                <ul class="nav navbar-nav">
                    <li>@Html.ActionLink("主頁", "Index", "Home")</li>
                    <li>@Html.ActionLink("關於", "About", "Home")</li>
                    <li>@Html.ActionLink("聯絡方式", "Contact", "Home")</li>
                    <li>@Html.ActionLink("員工列表", "Employees", "Employee")</li>
                </ul>
            </div>
        </div>
    </div>
    <div class="container body-content">
        @RenderBody()
        <hr />
        <footer>
            <p>? @DateTime.Now.Year - 我的 ASP.NET 應用程式</p>
        </footer>
    </div>

    @Scripts.Render("~/bundles/jquery")
    @Scripts.Render("~/bundles/bootstrap")
    @RenderSection("scripts", required: false)
</body>
</html>

要從Employee控制器測試Employees動作方法,需要在單元測試專案中新增另一個測試方法。在HomeControllerTest.cs檔案中的EmployeeControllerTest類程式碼之後,如下所示 -

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Web.Mvc;
using Microsoft.VisualStudio.TestTools.UnitTesting;
using MVCUnitTesting;
using MVCUnitTesting.Controllers;

namespace MVCUnitTesting.Tests.Controllers
{
    [TestClass]
    public class HomeControllerTest
    {
        [TestMethod]
        public void Index()
        {
            // Arrange
            HomeController controller = new HomeController();

            // Act
            ViewResult result = controller.Index() as ViewResult;

            // Assert
            Assert.IsNotNull(result);
        }

        [TestMethod]
        public void About()
        {
            // Arrange
            HomeController controller = new HomeController();

            // Act
            ViewResult result = controller.About() as ViewResult;

            // Assert
            Assert.AreEqual("Your application description page.", result.ViewBag.Message);
        }

        [TestMethod]
        public void Contact()
        {
            // Arrange
            HomeController controller = new HomeController();

            // Act
            ViewResult result = controller.Contact() as ViewResult;

            // Assert
            Assert.IsNotNull(result);
        }
    }

    [TestClass]
    public class EmployeeControllerTest
    {
        [TestMethod]
        public void Employees()
        {
            // Arrange
            EmployeeController controller = new EmployeeController();

            // Act
            ViewResult result = controller.Index() as ViewResult;

            // Assert
            Assert.IsNotNull(result);
        }
    }
}

測試 選單中選擇:執行 -> 所有測試 項來測試這些操作方法。

可以看到Employees測試方法現在也通過了。執行應用程式時將看到以下輸出。

點選導航欄中的「員工列表」選項,將看到員工列表資訊,如下圖所示 -