ASP.NET MVC單元測(cè)試：HttpContext類的Path屬性解惑
有關(guān)HttpContext類的Path屬性問(wèn)題描述
前一段時(shí)間有朋友在郵件中向我抱怨，說(shuō)他們團(tuán)隊(duì)在使用ASP.NET MVC開(kāi)發(fā)時(shí)，在單元測(cè)試的時(shí)候總是遇到一些不那么方便的地方。例如，對(duì)于HttpContext中各種千奇百怪的Path總是無(wú)法掌控。例如某個(gè)功能會(huì)用到HttpContext的Path屬性，有的又要用到RawUrl——有的又會(huì)涉及到HostName。于是在單元測(cè)試的時(shí)候，就可能需要填充Mock對(duì)象的多種Path屬性，而這幾種Path屬性的值，在理論上還有關(guān)系。這其實(shí)還是小事，一個(gè)麻煩的事情在于，如果功能實(shí)現(xiàn)的方式變了，例如原本使用RawUrl屬性，而后來(lái)忽然覺(jué)得應(yīng)該使用CurrentExecutionFilePath比較合適，于是單元測(cè)試就必須跟著改。如此反復(fù)，疲于奔命。
就我個(gè)人經(jīng)驗(yàn)看來(lái)，這種情況還是蠻常見(jiàn)的，因?yàn)槟承r(shí)候兩種Path屬性的值差不多，看上去都可以正常使用，于是剛開(kāi)始編寫的時(shí)候可能選擇了其中一個(gè)。但是后來(lái)發(fā)現(xiàn)，在另一些情況下兩種Path就有區(qū)別了，而且應(yīng)該使用的是另一個(gè)屬性，于是不得不修改，進(jìn)而單元測(cè)試失敗了。于是他問(wèn)我，有沒(méi)有什么好方法來(lái)“完整而可靠地”設(shè)置那些繽繁復(fù)雜的Path屬性。我之前其實(shí)也是根據(jù)需求設(shè)置各種Path屬性，但是這的確不好，最重要的問(wèn)題在于“單元測(cè)試”需要了解太多“被測(cè)試方法”的實(shí)現(xiàn)細(xì)節(jié)了，這種依賴非常的不可靠。雖然這也是Mock對(duì)象被人詬病的特點(diǎn)之一，但是如果我們能夠緩解這個(gè)缺陷自然再好不過(guò)了。
不過(guò)話說(shuō)回來(lái)，在“應(yīng)對(duì)”這個(gè)問(wèn)題之前，您要先了解目前的功能是不是真要訪問(wèn)HttpContext中的各種Path。ASP.NET MVC為了提高程序的可測(cè)試性作了很多努力，或者說(shuō)，將“關(guān)注點(diǎn)”進(jìn)行了很大程度的分離。在大部分情況下，我們都能夠不去觸及HttpContext，而且我們應(yīng)該盡可能避免這種情況的發(fā)生。例如，對(duì)Controller做單元測(cè)試的時(shí)候直接傳遞參數(shù)，為Model Binder做單元測(cè)試的時(shí)候使用ValueProvider。想來(lái)想去，會(huì)直接使用到HttpContext的Path屬性的場(chǎng)景不多，可能自定義Route算是一個(gè)吧，因?yàn)樗墓δ芫褪墙馕鯱RL。
HttpContext類的Path屬性原理
HttpContext的Path屬性都是通過(guò)HttpRequest對(duì)象獲得的。而事實(shí)上ASP.NET中的HttpRequest對(duì)象已經(jīng)為我們提供一種直接通過(guò)URL構(gòu)造的功能：
- var request = new HttpRequest(
- "", /* filename */
- "http://www.cnblogs.com/JeffreyZhao/", /* url */
- "hello=world"); /* querystring */
估計(jì)ASP.NET開(kāi)發(fā)團(tuán)隊(duì)也知道URL是個(gè)難辦的問(wèn)題，為我們預(yù)留了這樣一個(gè)構(gòu)造函數(shù)。這時(shí)的request對(duì)象會(huì)預(yù)填了大多數(shù)Path相關(guān)的屬性：
- request
- {System.Web.HttpRequest}
- AcceptTypes: null
- AnonymousID: null
- ApplicationPath: null
- AppRelativeCurrentExecutionFilePath: threw an exception of type 'System.NullReferenceException'
- Browser: null
- ClientCertificate: threw an exception of type 'System.NullReferenceException'
- ContentEncoding: threw an exception of type 'System.NullReferenceException'
- ContentLength: 0
- ContentType: ""
- Cookies: {System.Web.HttpCookieCollection}
- CurrentExecutionFilePath: "/JeffreyZhao/"
- FilePath: "/JeffreyZhao/"
- Files: {System.Web.HttpFileCollection}
- Filter: {System.Web.HttpInputStreamFilterSource}
- Form: {}
- Headers: {}
- HttpMethod: "GET"
- InputStream: {System.Web.HttpInputStream}
- IsAuthenticated: threw an exception of type 'System.NullReferenceException'
- IsLocal: false
- IsSecureConnection: false
- LogonUserIdentity: null
- Params: {hello=world}
- Path: "/JeffreyZhao/"
- PathInfo: ""
- PhysicalApplicationPath: threw an exception of type 'System.ArgumentNullException'
- PhysicalPath: ""
- QueryString: {hello=world}
- RawUrl: "/JeffreyZhao/?hello=world"
- RequestType: "GET"
- ServerVariables: {}
- TotalBytes: 0
- Url: {http://www.cnblogs.com/JeffreyZhao/}
- UrlReferrer: null
- UserAgent: null
- UserHostAddress: null
- UserHostName: null
- UserLanguages: null
以上內(nèi)容是從Visual Studio的Immediate Window中看到的，由此可以發(fā)現(xiàn)，其中大部分的Path屬性已經(jīng)準(zhǔn)備好了，但是AppRelativeCurrentExecutionFilePath屬性拋出異常（還有兩個(gè)與本地磁盤路徑有關(guān)的Path就忽略了），因?yàn)樗枰囟ǖ奶摂M路徑環(huán)境才能計(jì)算出來(lái)。通過(guò).NET Reflector觀察這個(gè)屬性的實(shí)現(xiàn)，會(huì)發(fā)現(xiàn)其中牽涉到的內(nèi)容不是一點(diǎn)兩點(diǎn)，幾乎不可能通過(guò)設(shè)置外部環(huán)境的方式來(lái)使其通過(guò)。因此，我們最終還是要通過(guò)Mock框架來(lái)進(jìn)行設(shè)置——反正我們也需要設(shè)置HttpRequest的其它屬性，不是嗎？
- var realRequest = new HttpRequest(
- "", /* filename */
- "http://www.cnblogs.com/JeffreyZhao/", /* url */
- "hello=world"); /* querystring */
- var mockRequest = new Mock<HttpRequestWrapper>(realRequest) { CallBase = true };
- mockRequest
- .Setup(r => r.AppRelativeCurrentExecutionFilePath)
- .Returns("~" + realRequest.CurrentExecutionFilePath);
這里還是使用Moq框架，而Mock的對(duì)象則是HttpRequestWrapper類型，而不是我們常用的HttpRequestBase類型。HttpRequestWrapper的特點(diǎn)便是可以“塞入”一個(gè)真正的HttpRequest對(duì)象，然后把所有成員都委托給這個(gè)HttpRequest對(duì)象。我們?cè)跇?gòu)建一個(gè)Mock<HttpRequestWrapper>對(duì)象之后，還需要把CallBase屬性設(shè)為true，這樣便可以讓Mock對(duì)象在默認(rèn)情況下直接使用Wrapper的實(shí)現(xiàn)了。
有了Request，我們便可以構(gòu)建一個(gè)HttpContext的Mock對(duì)象：
- var mockContext = new Mock<HttpContextBase>();
- mockContext.Setup(c => c.Request).Returns(mockRequest.Object);
但是，Moq框架有個(gè)限制，那就是如果您指定了這里的Request對(duì)象，再去通過(guò)HttpContext指定Request中的其他屬性，就會(huì)把原來(lái)的HttpRequest對(duì)象給覆蓋。也就是說(shuō)，下面的代碼會(huì)讓我們對(duì)HttpRequest做的努力付之東流：
- mockContext.Setup(c => c.Request.Form).Returns(new NameValueCollection());
這樣您會(huì)發(fā)現(xiàn)，mockContext.Object.Request下除了Form外的其他屬性都沒(méi)有值了（或拋出異常，視您Mock時(shí)的Behavior是Loose還是Strict而定）。因此，如果我們希望進(jìn)一步修改HttpRequest中屬性的時(shí)候，只能直接使用那個(gè)Mock<HttpRequestWrapper>對(duì)象進(jìn)行設(shè)置。我不清楚其他Mock框架的行為如何，如果您使用的也是Moq框架，可能就只得這么做了。
為了使用方便，我也在測(cè)試項(xiàng)目中準(zhǔn)備了這樣一個(gè)輔助方法：
- public static class MockHelper
- {
- public static Mock<HttpContextBase> MockRequest(string url, out Mock<HttpRequestWrapper> mockRequest)
- {
- int index = url.IndexOf('?');
- string path = index >= 0 ? url.Substring(0, index) : url;
- string queryString = index >= 0 ? url.Substring(index + 1) : "";
- var realRequest = new HttpRequest("", path, queryString);
- mockRequest = new Mock<HttpRequestWrapper>(realRequest) { CallBase = true };
- mockRequest
- .Setup(r => r.AppRelativeCurrentExecutionFilePath)
- .Returns("~" + realRequest.CurrentExecutionFilePath);
- var mockContext = new Mock<HttpContextBase>();
- mockContext.Setup(c => c.Request).Returns(mockRequest.Object);
- return mockContext;
- }
- }
于是我們就可以更方便地進(jìn)行相關(guān)的單元測(cè)試。例如，我們“象征性”地測(cè)試一下ASP.NET Routing中內(nèi)置的Route類型：
- [Fact]
- public void URL_Capturing_and_Generation()
- {
- // prepare route
- Route route = new Route("{controller}/{action}/{id}", null);
- // Mock request
- string url = "http://www.cnblogs.com/Home/Index/5";
- Mock<HttpRequestWrapper> mockRequest;
- var mockContext = MockHelper.MockRequest(url, out mockRequest);
- mockContext.Setup(c => c.Response.Charset).Returns("utf-8"); // if you need
- // test data capturing
- RouteData routeData = route.GetRouteData(mockContext.Object);
- Assert.Equal("Home", routeData.GetRequiredString("controller"));
- Assert.Equal("Index", routeData.GetRequiredString("action"));
- Assert.Equal("5", routeData.GetRequiredString("id"));
- // test url generation
- var hash = new { controller = "Account", action = "List", id = 1};
- var values = new RouteValueDictionary(hash);
- var requestContext = new RequestContext(mockContext.Object, routeData);
- var pathData = route.GetVirtualPath(requestContext, values);
- Assert.Equal("Account/List/1", pathData.VirtualPath);
- }
具體內(nèi)容就敘述到這里，目前Path相關(guān)的問(wèn)題應(yīng)該已經(jīng)不會(huì)給您造成太大問(wèn)題了。
以上就是對(duì)HttpContext類的Path屬性的問(wèn)題解惑。本文來(lái)自老趙點(diǎn)滴：《在單元測(cè)試時(shí)指定HttpContext的各種Path》
【編輯推薦】
