Asp.Net Core 轻松学-利用文件监视进行快速测试开发

前言

    在进行 Asp.Net Core 应用程序开发过程当中，一般的作法是先把业务代码开发完成，而后创建单元测试，最后进入本地系统集成测试；在这个过程当中，程序员的大部分时间几乎都花费在开发、运行、调试上，并且一再的重复这个过程，我称这个过程为“程序员开发螺旋”，而且在这个步骤中，重复率最高且没有创造力的工做就是启动、测试，做为程序员，努力提升生产力咱们追求的目标，咱们的工做就是尽可能消灭重复劳动，解放生产力，提升产出效率；下面就经过一个简单的例子来演示，如何经过文件监视进行快速开发。

• 本示例将会使用两个项目用做演示，以下图

1. 创建业务项目 UserCenterDemo

1.1 在 UserCenterDemo.HomeController 里面编写一个简单的业务方法

[Route("api/[controller]")]
    [ApiController]
    public class HomeController : ControllerBase
    {
        [HttpGet("{id}")]
        public IActionResult Get(int id)
        {
            int code = 0;
            string userName = string.Empty;
            switch (id)
            {
                case 100:
                    userName = "Ron.liang";
                    break;
                default:
                    userName = "Guest";
                    code = 403;
                    break;
            }

            return new JsonResult(new { code, userName });
        }
    }

该业务方法很是简单，仅根据传入的 id 值进行判断，若是不是 100 则返回 code=403

2. 创建 xUnit 单元测试项目 UserCenterDemoTest

2.1 引用项目 UserCenterDemo 和引用 NuGet 包

Microsoft.AspNetCore.App
Microsoft.AspNetCore.TestHost

UserCenterDemo 使用了主机集成测试方式，对主机集成测试不了解到同窗，能够查看我上一篇博客： Asp.Net Core 轻松学-利用xUnit进行主机级别的网络集成测试.

2.2 编写测试用例 UserCenterDemoTest.HomeControllerTest.cs

public class HomeControllerTest
    {
        public static TestServer serverHost;
        public static HttpClient client;
        public HomeControllerTest()
        {
            if (serverHost == null)
            {
                serverHost = new TestServer(new WebHostBuilder().UseStartup<UserCenterDemo.Startup>());
                client = serverHost.CreateClient();
            }
        }

        class TestResult
        {
            public int Code { get; set; }
            public string UserName { get; set; }
        }

        [Fact]
        public async void GetUserNameTest()
        {
            var data = await client.GetAsync("/api/home/100");
            var result = await data.Content.ReadAsStringAsync();
            var obj = JsonConvert.DeserializeObject<TestResult>(result);
            Assert.Equal(0, obj.Code);
        }

        [Fact]
        public async void GetGuestTest()
        {
            var data = await client.GetAsync("/api/home/0");
            var result = await data.Content.ReadAsStringAsync();
            var obj = JsonConvert.DeserializeObject<TestResult>(result);
            Console.WriteLine(result);
            Assert.Equal(403, obj.Code);
        }
    }

该测试包含两个测试方法，分别是获取 id=100 的用户和 id=0 的 Guest 用户

3. 使用 dotnet watch 进行监视测试

按照以往的开发习惯，咱们如今应该作的事情可能有两个，一是启动项目使用浏览器进行访问业务接口 Get ，二是运行单元测试，无论怎么样，这两个动做都将消耗咱们大量的时间
如今，有一种全新的选择，咱们能够经过使用 dotnet watch test 对项目文件进行监视变更，自动运行单元测试，并将测试结果输出到控制台

3.1 打开 cmd.exe 程序，切换到测试项目目录 UserCenterDemoTest，输入 dotnet watch test，等待运行

上图表示，当咱们输入命令 dotnet watch test 后，监视程序正在启动，并在启动完成后当即执行了一次单元测试，红色方框部分表示有 2 个测试用例已经过，而后程序并无退出，而是在最后输出了一个提示，正在等待文件变更以重启 dotnet 应用程序

3.2 接下来咱们修改测试用例 GetGuestTest 的断言结果 code=0，看看发生了什么

能够看到，在修改完成保存文件的瞬间，程序当即重启生成，而后执行测试，测试结果断言不经过
那么问题来了，上面只是监视了测试项目，若是咱们修改了 UserCenterDemo.Controllers ，可以自动监视吗，答案是确定的

3.3 如今修改 UserCenterDemo.Controllers ，修改获取 Guest 的 code=0，返回成功

[Route("api/[controller]")]
    [ApiController]
    public class HomeController : ControllerBase
    {
        [HttpGet("{id}")]
        public IActionResult Get(int id)
        {
            int code = 0;
            string userName = string.Empty;
            switch (id)
            {
                case 100:
                    userName = "Ron.liang";
                    break;
                default:
                    userName = "Guest";
                    code = 403;
                    break;
            }

            return new JsonResult(new { code, userName });
        }
    }

• 输出结果，已自动监视执行

为何会这样呢，由于咱们的测试项目引用了业务项目 UserCenterDemo
因此能够监视到，查看 UserCenterDemoTest.csproj 文件，起做用的是如下代码

<ItemGroup>
    <ProjectReference Include="..\UserCenterDemo\UserCenterDemo.csproj" />
  </ItemGroup>

5. 扩展使用

5.1 若是你以为老是不停的输出各类信息让你以为很不友好，那么你能够排除监视，好比移除对 UserCenterDemo.csproj 的监视，只须要增长配置 Watch="false" 便可

<ItemGroup>
    <ProjectReference Include="..\UserCenterDemo\UserCenterDemo.csproj" Watch="false"/>
  </ItemGroup>

5.2 独立监视

当项目比较大的时候，咱们可能须要对监视项目进行管理，这个时候再逐一的对每一个项目进行监视设置就变得很是的麻烦，而后咱们就能够创建一个单独的文件夹，建立一个 watch.csproj 文件，填以下面的内容

<Project>
    <ItemGroup>
        <TestProjects Include="..\**\*.csproj" />
        <Watch Include="..\**\*.cs" />
    </ItemGroup>

    <Target Name="WatchManage">
        <MSBuild Targets="VSTest" Projects="@(TestProjects)" />
    </Target>

    <Import Project="$(MSBuildExtensionsPath)\Microsoft.Common.targets" />
</Project>

5.3 注意路径，由于本示例的目录结构是这样

因此文件中的监视节点我必须加入 .. 回退到上一级，上面的代码表示，监视上一级目录下的 .csproj/.cs 文件变更，并为本次监视管理命名为：WatchManage

5.4 如今进入目录 watch 输入命令 dotnet watch msbuild /t:WatchManager

能够看到，已经成功对两个项目进行变更监视

结束语

• 经过本示例，咱们了解到如何在项目开发过程当中减小重复劳动，提升生产力的方法
• 学习了 dotnet watch test 的使用方法
• 掌握了在应对项目繁多的时候，创建独立文件监视管理器的方法

示例代码下载

https://github.com/lianggx/EasyAspNetCoreDemo/tree/master/UserCenterDemo