关于视图的单元测试
说到ASP.NET MVC,我们似乎始终都在关注对于Controller的测试——虽然Stephen Walther也写过如何脱离Web Server对View进行单元测试,但是他的方法可看而不可用。复杂的构造和预备,以及对生成的HTML字符串作判断——这真是在对视图做单元测试吗?仔细分析他的代码可以发现,这其实是在对ViewEngine做单元测试。而且,如果真要对ViewEngine做单元测试,也不应该像他那样依赖外部文件。在我看来,他的做法什么都不是……似乎美观,似乎能博得一些“掌声”,但是这个掌声是来自于他的解决方案,还是大家一时的冲动呢?
如果要对视图做单元测试,还是要将内容呈现在浏览器中才行。在对网页做单元测试时,我们一般会使用WatiN等工具操作浏览器,打开页面,再对其DOM元素结构及内容作断言。不过……这是单元测试吗?可惜这只能算是一种回归测试或用户验收测试。因为,我们在打开一个页面的时候,从表现层到业务逻辑再到数据访问,应用程序的每个部件都在忙碌着。而单元测试讲究的是“分离”,分离一切关注,分离一切依赖。因为分离,我们才能准确定位错误;因为分离,我们才能在测试中使用我们准备好的数据。
既然要分离,我们就必须遵循一定的使用规范。在《ASP.NET MVC单元测试最佳实践》中我提到,在View中只能使用ViewData中的数据,而不该依赖其他内容(包括HttpContext)。这样我们就可以自行构造ViewData并注入一个视图对象中。事实上,这个约定在ASP.NET MVC自带的项目模板中就被破坏了。请看Views\Shared\LogOnUserControl.ascx,其中通过this.User来查看当前用户的登陆状态。这是个定义在传统Page对象上的属性,从当前HttpContext上直接获取。如果使用这种方式,我们在单元测试时就难以“模拟”当前用户的登陆状态,进而难以使测试覆盖到测试的各种情况了。
Lightweight Test Automation Framework
在这里,老赵推荐使用ASP.NET Team提供的Lightweight Test Automation Framework(下文称之为LTAF)作为测试工具,它目前已经在CodePlex上更新至Feb Update版本。这个框架的作用与WatiN和Selenium类似,可操作浏览器对应用程序编写回归测试。虽然在某些方面(例如DOM元素的选取)不如“竞争对手”,但是LTAF自有其独到之处:
- 由于直接在浏览器中运行,它天生便支持现有的——以及未来可能出现的任意浏览器。
- 由于直接部署在被测试的网站中,因此测试代码和网站页面是在同一个进程中。
第一点优势自不必说,而第二点更是关键。试想WatiN和Selenium,都是通过编写代码在浏览器中打开页面。这意味着我们的在测试代码和被测试的网页分别在不同的进程中。在这个前提下,如果我们要将测试代码中定义的数据传递给被测试的网页(也就是视图对象),我们就必须进行跨进程的通信。而无论怎么实现,都逃不过“序列化”一途,这无疑增加了复杂度。而使用LTAF之后,这个问题瞬间烟消云散了,因为我们可以直接在内存中“传递”测试数据,一切都只是个引用而已。
不过任何事物都具有两面性,LTAF也有一些难以天生的,而且是永远无法弥补的缺点。例如:
- 由于LTAF将待测试的页面放置在Frame中,因此该页面上的window.top等基于浏览器frame结构的属性会被改变。
- 由于LTAF的本质是使用JavaScript来操作DOM,这意味着任何会阻塞程序进行的操作(例如alert)都不能使用,否则将阻塞整个测试过程。
不过幸运的是,这两点都不回成为严重的问题。对于第一种,我们只需要编写一个自定的getTop方法来替换直接访问windows.top的做法即可。而第二种情况——老赵从来不喜欢alert或confirm这种“纯浏览器功能”,因为它们会带来很差的用户体验,更何况现在的JavaScript类库/框架都能很轻松的做出这种效果,您觉得呢?
LTAF的具体使用方式可参考其Release Note。令人奇怪的是,老赵发现直接在项目中使用LTAF会有一些小问题(不过它的示例为什么就一切正常呢?),因此进行了一些细微的修改。请注意~\UnitView\DriverPage.aspx文件尾部的一些JavaScript代码。
UnitView的使用
于是老赵编写了一个组件UnitView,方便我们构造一个单元测试时所需的数据。有了数据,便能够直接将视图在浏览器中加以呈现了。例如:
[WebTestClass] public class HomeTests { [WebTestMethod] public void LoggedOnIndexTest() { var data = new TestViewData<IndexModel> { ControllerName = "Home", ActionName = "Index", Model = new IndexModel { Message = "Welcome guys!", Identity = new UserIdentity { IsAuthenticated = true, Name = "Jeffrey Zhao" } } }; HtmlPage page = new HtmlPage(TestViewData.GenerateHostUrl(data)); // Assert title Assert.AreEqual("Home Page", page.Elements.Find("title", 0).GetInnerText()); // Assert head element var mainContent = page.Elements.Find("main"); var head2 = mainContent.ChildElements.FindAll("h2").Single(); Assert.AreEqual(data.Model.Message, head2.GetInnerText(), "Message should be displayed."); var loginTabInnerText = page.Elements.Find("logindisplay").GetInnerTextRecursively(); Assert.IsTrue(loginTabInnerText.Contains("Welcome"), "'Welcome' missed."); Assert.IsTrue(loginTabInnerText.Contains(data.Model.Identity.Name), "Login name missed."); } }
自然,Web Server是不可或缺的。幸运的是,分离让我们的视图只会涉及最简单的测试数据,这样VS自带的简单Web Server就足够了。在上面的代码中,我们直接构造了强类型的TestViewData对象,它包含呈现一个视图所需要的所有数据:
- Cotroller和Action名称。从理论上说,由不同的Controller和Action进入同样的视图可能会得到不同的结果。
- View和Master名称。如果省略,则表明将使用默认的视图,即通过Controller和Action的值来确定。
- ViewData和Model。
TestViewData.GenerateHostUrl方法会把data保存起来,并返回一个URL。访问该URL便能够得到对应的视图内容。
如果您想使用UnitView,可以从上面的链接中下载UnitView的源代码和示例在本机进行尝试。使用UnitView时主要有以下几个注意点:
- 将Tests项目的输出路径指向被测试网站的bin目录,这样既可以在运行时得到正确的程序集,又不必为网站添加多余的引用。
- 将~\UnitView目录复制到您的网站根目录下(在发布网站时,请剔除该目录)。如果想使用其它目录,请关注接下来UnitView实现分析。
- 编辑~\UnitView\Web.config文件,将MvcApp.Tests.dll修改为您自己的包含测试代码的程序集。
UnitView实现分析
UnitView组件非常简单,简单地几乎不值一提。TestViewData类型包含了测试需要的所有数据,而TestViewData
此外,TestViewData还有一些静态方法:
public class TestViewData { static TestViewData() { PersistentProvider = new InProcPersistentProvider(); } public static IPersistentProvider PersistentProvider { get; set; } public static string GenerateHostUrl(TestViewData data) { var key = PersistentProvider.Save(data); return ViewHostHandlerUrl + "?key=" + HttpUtility.UrlEncode(key); } private static string ViewHostHandlerUrl { get { return ConfigurationManager.AppSettings["UnitView_ViewHostHandlerUrl"] ?? "/UnitView/ViewHostHandler.ashx"; } } internal static TestViewData Load(string key) { return PersistentProvider.Load(key); } ... }
GenerateHostUrl方法将委托PersistentProvider保存对象,并得到一个key。这个key将拼接在ViewHostHandlerUrl属性上,这便是被测试的路径。从代码中可以看出,如果您不想使用默认的测试路径,只需在web.config的AppSettings节点中添加一个目标地址即可。
PersistentProvider属性为IPersistentProvider接口类型,其中定义了Save/Load/Remove三个方法。IPersistentProvider在项目中只有一个实现:InProcPersistentProvider,它会将TestViewData存放在内存中的一个字典里。这个实现已经足够让UnitView结合LTAF运行(LTAF的同进程特性起到了关键的作用)。不过,如果您还是希望使用WatiN等独立进程的测试工具,就必须实现自己的IPersistentProvider类型。例如您可以实现一个FilePersistentProvider,将TestViewData序列化至一个外部文件中,这样就可以在合适的时候将它取回了。
另一个较为关键的类型是UnitView.Engine.ViewHostHandler:
public class ViewHostHandler : IHttpHandler { private HttpContext Context { get; set; } public void ProcessRequest(HttpContext context) { this.Context = context; ControllerContext controllerContext = new ControllerContext( new HttpContextWrapper(context), this.Data.RouteData, new MockController()); new ViewResult { MasterName = this.Data.MasterName, ViewName = this.Data.ViewName, TempData = this.Data.TempData, ViewData = this.Data.ViewData, }.ExecuteResult(controllerContext); } private string Key { get { string key = this.Context.Request.QueryString["key"]; if (String.IsNullOrEmpty(key)) { throw new ArgumentNullException("key"); } return key; } } private TestViewData m_data; private TestViewData Data { get { if (this.m_data == null) { this.m_data = TestViewData.Load(this.Key); if (this.m_data == null) { throw new ArgumentNullException("Cannot retrieve the data."); } } return this.m_data; } } public bool IsReusable { get { return false; } } }
首先,在ProcessRequest方法会取回TestViewData,并根据这些数据构造一个ViewResult对象,最后执行它的ExecuteResult方法来输出视图内容。由于ExecuteRequest方法的需要,我们还必须构造一个ControllerContext对象,也就意味着我们还必须提供一个Controller对象和HttpContext的封装。从代码中可以看出,我们这里使用了最简单的数据。由于视图遵守“约定”,它只会从ViewData中获取数据,所以无论Controller或HttpContext是什么值都已经无关紧要了。
您可能会想,为什么会有这样的“约定”,不让视图从HttpContext对象中获取数据呢?Mock一个HttpContext对象也不是那么困难(这里要感谢各种强大的Mock框架)啊。可惜,Mock后的HttpContext很难进行序列化,这样就几乎杜绝了跨进程通信的可能,这对于使用WatiN和Selenium进行测试的朋友们无疑是一种灾难。权衡之下,老赵决定放弃对HttpContext的支持。
注1:目前UnitView基于ASP.NET MVC RC构建,当RTM发布后我会进行必要的更新。请关注老赵这篇文章和托管在MSDN Code Gallery上的代码(http://code.msdn.microsoft.com/UnitView)。
注2:在《ASP.NET MVC单元测试最佳实践》中我也包含了UnitView组件,实现略有不同——请以本篇文章为主。