返回 IHttpActionResult vs IEnumerable<Item> vs IQueryable<Item>

Question

在 ASP.NET Web API 2 中，以下有什么区别？

public async Task<IEnumerable<MyItem>> GetMyItems()
{
    //... code ..., var myItems = await ...
    return myItems;
}

和

public async Task<IQueryable<MyItem>> GetMyItems()
{
    //... code ..., var myItems = await ...
    return myItems;
}

和

public async Task<IHttpActionResult> GetMyItems()
{
    //... code ..., var myItems = await ...
    return Ok(myItems);
}

我应该返回IHttpActionResult 还是IEnumerable<MyItem> / IQueryable<MyItem> ？

Answer 1

我会在 IEnumerable 和 IHttpActionResult 之间进行选择，你可以用它们做几乎相同的事情，只是方式略有不同。 IQueryable 通常用于较低级别的数据访问任务和延迟执行 sql 查询，因此我会将其封装在您的数据访问类中，而不是通过 web api 公开它。

这是来自http://www.asp.net/web-api/overview/web-api-routing-and-actions/action-results的摘要：

IHttpActionResult

IHttpActionResult 接口是在 Web API 2 中引入的。本质上，它定义了一个 HttpResponseMessage 工厂。以下是使用 IHttpActionResult 接口的一些优点（相对于 HttpResponseMessage 类）：

• 简化对控制器的单元测试。
• 将用于创建 HTTP 响应的通用逻辑移到单独的类中。
• 通过隐藏构造响应的低级细节，使控制器操作的意图更加清晰。

IEnumerable

对于所有其他返回类型，Web API 使用媒体格式化程序来序列化返回值。 Web API 将序列化值写入响应正文。响应状态码为 200（OK）。

public class ProductsController : ApiController
{
    public IEnumerable<Product> Get()
    {
        return GetAllProductsFromDB();
    }
}

这种方法的一个缺点是不能直接返回错误代码，例如 404。但是，对于错误代码，您可以抛出 HttpResponseException。了解更多信息。

Answer 2

您应该返回IHttpActionResult，因为您可以更具体地针对客户。您可以创建更多用户友好的 Web 应用程序。基本上你可以针对不同的情况返回不同的 HTML 状态信息。

例如：

public async Task<IHttpActionResult> GetMyItems()
{
    if(!authorized)
        return Unauthorized();
    if(myItems.Count == 0)
        return NotFound();
    //... code ..., var myItems = await ...
    return Ok(myItems);
}

IEnumerable和IQueryable只会将您的数据解析为输出格式，您将没有正确的方法来处理异常。这是最重要的区别。