Question

我是Unit Testing的新手，我正在尝试为我的Web API Controller的POST方法创建一些Xunit测试。

这是我的Controller的POST方法：

[HttpPost("")]
public async Task<IActionResult> CreateArea([FromBody] AreaForCreationDto area)
{
    // Check that the 'area' object parameter can be de-serialised to a AreaForCreationDto.
    if (area == null)
    {
        var message = "Could not de-serialise the request body to an AreaForCreationDto object";
        _logger.LogError(message);

        // Return an error 400.
        return BadRequest(message);
    }

    /*
     * ModelState.IsValid is determined by the attributes associated with the 
     * Data Annotations on the properties of the ViewModel.
     */
    if (!ModelState.IsValid)
    {
        // Return a response with a Status Code 422.
        return new UnprocessableEntityObjectResult(ModelState);
    };

    // Map a AreaForCreationDto object to a Area entity.
    var areaEntityToAdd = _mapper.Map<Area>(area);

    // Call the repository to add the new Area entity to the DbContext.
    _areaRepository.AddArea(areaEntityToAdd);

    // Save the new Area entity, added to the DbContext, to the SQL database.
    if (await _areaRepository.SaveChangesAsync())
    {
        // Note: AutoMapper maps the values of the properties from the areaEntityToAdd
        // to a new areaToReturn object.
        // This ensures that we don't expose our Area entity to the web browser.
        var areaToReturn = _mapper.Map<AreaDto>(areaEntityToAdd);

        // Return a 201 'created' response along with the location URL in the
        // response Header.
        return CreatedAtRoute("GetArea",
            new { id = areaToReturn.Id },
            areaToReturn);
    }
    else {
        // The save failed.
        var message = $"Could not save new Area {areaEntityToAdd.Id} to the database.";
        _logger.LogWarning(message);
        throw new Exception(message);
    };
}

我编写的第一个单元测试旨在确保在发送POST请求时，如果对象可以反序列化为AreaForCreation对象，则该函数将返回201 CreatedAtRouteResult以及已经创建的新区域。

这是Xunit测试：

[Fact]
public void ReturnAreaForCreateArea()
{
    //Arrange

    var _mockAreaRepository = new Mock<IAreaRepository>();
    _mockAreaRepository
        .Setup(x => x.AddArea(testArea));

    var _mockMapper = new Mock<IMapper>();
    _mockMapper
        .Setup(_ => _.Map<Area>(It.IsAny<AreaForCreationDto>()))
        .Returns(testArea);

    var _mockLogger = new Mock<ILogger<AreasController>>();
    var _sut = new AreasController(_mockAreaRepository.Object, _mockLogger.Object, _mockMapper.Object);

    // Act
    var result = _sut.CreateArea(testAreaForCreationDto);

    // Assert
    Assert.NotNull(result);
    var objectResult = Assert.IsType<CreatedAtRouteResult>(result);
    var model = Assert.IsAssignableFrom<AreaDto>(objectResult.Value);
    var areaDescription = model.Description;
    Assert.Equal("Test Area For Creation", areaDescription);
}

当单元测试尝试Assert.IsType<CreatedAtRouteResult>(result)时，我收到异常。调试显示Controller无法保存到存储库。我的AreaRepository具有以下AddArea函数，该函数不返回值，因此我假设我的_mockAreaRepository不需要设置Return条件（此处可能有误）。

我是否需要为调用mockAreasRepository的结果配置SaveChangesAsync()？

Answer 1

是的，因为你需要模拟已完成任务的返回以允许方法

的异步

await _areaRepository.SaveChangesAsync()

能够继续。

您还需要将测试更新为 async ，方法是返回Task并等待测试中的方法。

[Fact]
public async Task ReturnAreaForCreateArea() { //<-- note test is now async as well
    //Arrange

    var _mockAreaRepository = new Mock<IAreaRepository>();
    _mockAreaRepository
        .Setup(x => x.AddArea(testArea));

    _mockAreaRepository
        .Setup(x => x.SaveChangesAsync())
        .ReturnsAsync(true); //<-- returns completed Task<bool> when invoked

    var _mockMapper = new Mock<IMapper>();
    _mockMapper
        .Setup(_ => _.Map<Area>(It.IsAny<AreaForCreationDto>()))
        .Returns(testArea);
    _mockMapper
        .Setup(_ => _.Map<AreaDto>(It.IsAny<Area>()))
        .Returns(testAreaDto);

    var _mockLogger = new Mock<ILogger<AreasController>>();
    var _sut = new AreasController(_mockAreaRepository.Object, _mockLogger.Object, _mockMapper.Object);

    // Act
    var result = await _sut.CreateArea(testAreaForCreationDto);//<-- await 

    // Assert
    Assert.NotNull(result);
    var objectResult = Assert.IsType<CreatedAtRouteResult>(result);
    var model = Assert.IsAssignableFrom<AreaDto>(objectResult.Value);
    var areaDescription = model.Description;
    Assert.Equal("Test Area For Creation", areaDescription);
}

ASP.Net Web API控制器单元测试POST

1 个答案: