返回 IActionResult 的单元测试控制器方法

Question

我正在构建 ASP.NET Core WebAPI，并尝试为控制器编写单元测试。 我发现的大多数示例都来自较旧的 WebAPI/WebAPI2 平台，似乎与新的 Core 控制器无关。

我的控制器方法正在返回

IActionResults

。 然而，

IActionResult

对象只有一个

ExecuteResultAsync()

方法，需要控制器上下文。 我手动实例化控制器，因此此实例中的控制器上下文为 null，这会在调用

ExecuteResultAsync

时导致异常。 本质上，这让我走上了一条非常棘手的道路来成功完成这些单元测试，而且非常混乱。我想知道必须有一种更简单/正确的方法来测试 API 控制器。

此外，我的控制器没有使用异步/等待（如果这有影响的话）。

我想要实现的目标的简单示例：

控制器方法：

[HttpGet(Name = "GetOrdersRoute")]
public IActionResult GetOrders([FromQuery]int page = 0)
{
     try
     {
        var query = _repository.GetAll().ToList();

        int totalCount = query.Count;
        int totalPages = (int)Math.Ceiling((double)totalCount / pageSize) - 1;
        var orders = query.Skip(pageSize * page).Take(pageSize);

        return Ok(new
        {
           TotalCount = totalCount,
           TotalPages = totalPages,

           Orders = orders
        });
     }
     catch (Exception ex)
     {
        return BadRequest(ex);
     }
}

单元测试：

[Fact]
public void GetOrders_WithOrdersInRepo_ReturnsOk()
{
     // arrange
     var controller = new OrdersController(new MockRepository());

     // act
     IActionResult result = controller.GetOrders();

     // assert
     Assert.Equal(HttpStatusCode.OK, ????);
}

Answer 1

假设类似

public IActionResult GetOrders() {
    var orders = repository.All();
    return Ok(orders);
}

本例中的控制器返回一个

OkObjectResult

类。

将结果转换为您在方法中返回的类型，并对其执行断言

[Fact]
public void GetOrders_WithOrdersInRepo_ReturnsOk() {
    // arrange
    var controller = new OrdersController(new MockRepository());

    // act
    var result = controller.GetOrders();
    var okResult = result as OkObjectResult;

    // assert
    Assert.IsNotNull(okResult);
    Assert.AreEqual(200, okResult.StatusCode);
}

Answer 2

您还可以做一些很酷的事情，例如：

    var result = await controller.GetOrders();//
    var okResult = result as ObjectResult;

    // assert
    Assert.NotNull(okResult);
    Assert.True(okResult is OkObjectResult);
    Assert.IsType<TheTypeYouAreExpecting>(okResult.Value);
    Assert.Equal(StatusCodes.Status200OK, okResult.StatusCode);

谢谢

Answer 3

其他答案建议转换为

ObjectResult

，但只有在返回

OkObjectResult

\

NotFoundObjectResult

\ 等时才有效。但服务器可以返回源自

NotFound

的

OkResult

\

StatusCodeResult

。

例如：

public class SampleController : ControllerBase
{
    public async Task<IActionResult> FooAsync(int? id)
    {
        if (id == 0)
        {
            // returned "NotFoundResult" base type "StatusCodeResult"
            return NotFound();
        }

        if (id == 1)
        {
            // returned "StatusCodeResult" base type "StatusCodeResult"
            return StatusCode(StatusCodes.Status415UnsupportedMediaType);
        }

        // returned "OkObjectResult" base type "ObjectResult"
        return new OkObjectResult("some message");
    }
}

我查看了所有这些方法的实现，发现它们都是继承自

IStatusCodeActionResult

接口。看起来这是包含

StatusCode

:

的最基本类型

private SampleController _sampleController = new SampleController();

[Theory]
[InlineData(0, StatusCodes.Status404NotFound)]
[InlineData(1, StatusCodes.Status415UnsupportedMediaType)]
[InlineData(2, StatusCodes.Status200OK)]
public async Task Foo_ResponseTest(int id, int expectedCode)
{
    var actionResult = await _sampleController.FooAsync(id);
    var statusCodeResult = (IStatusCodeActionResult)actionResult;
    Assert.Equal(expectedCode, statusCodeResult.StatusCode);
}

Answer 4

这样做的一个好方法是这样的：

[Fact]
public void GetOrders_WithOrdersInRepo_ReturnsOk() {
    // arrange
    var controller = new OrdersController(new MockRepository());

    // act
    var result = controller.GetOrders();

    // assert
    var okResult = Assert.IsType<OkObjectResult>(result);
    Assert.IsNotNull(okResult);
    Assert.AreEqual(200, okResult.StatusCode);
}

Answer 5

您还可以使用 ActionResult 类作为控制器结果（假设您的类型为 Orders）。 在这种情况下，你可以使用这样的东西：

[ProducesResponseType(typeof(Orders), StatusCodes.Status200OK)]
public ActionResult<Orders> GetOrders()
{
    return service.GetOrders();
}

现在在单元测试中你有：

Assert.IsInstanceOf<Orders>(result.Value);

此外，这是 Microsoft 的建议 - https://learn.microsoft.com/en-us/aspnet/core/web-api/action-return-types?view=aspnetcore-2.2#actionresultt-type

不幸的是，我不知道为什么使用 Ok 方法

return Ok(service.GetOrders());

没有正确映射它。

Answer 6

public async Task CallRxData_ReturnsHttpNotFound_ForInvalidJobNum_ReturnsStoredRxOrder()
{
    var scanInController = new ScanInController(_logger, _scanInService);
    var okResult = await scanInController.CallRxData(rxOrderRequest);
    var notFoundResult = await scanInController.CallRxData(invalidRxOrderRequest);
    var okResultWithScanInCheckFalse = await scanInController.CallRxData(rxOrderRequest);
    var okResultWithEmptyAelAntiFakeDatas = await scanInController.CallRxData(rxOrderRequest);
    // Assert
    Assert.That(okResult, Is.TypeOf<OkObjectResult>());
    Assert.That(notFoundResult, Is.TypeOf<NotFoundObjectResult>());
    Assert.IsFalse(((okResultWithScanInCheckFalse as ObjectResult).Value as RxOrder).IsSecurity);`enter code here`
}

Answer 7

对于任何登陆这里试图弄清楚如何打开已通过

ActionResult

 返回的 

OkObjectResult

的人

给定被测控制器方法：

public ActionResult<MyPoco> MyEndpoint()
{
   return Ok(new MyPoco());
}

请注意，在再次转换为

Result

实例之前，您需要将

OkObjectResult

属性转换为

Foo

：

// Unit Test
var actionResult = sut.MyEndpoint();
var myPoco = (actionResult.Result as OkObjectResult).Value as MyPoco;
// Can now Assert on myPoco