6

排队长介绍...

我有一个资源定义在

http://my-awesome-product.com/api/widgets/3

它表示一个id3 的小部件。在 Web API 中，我将定义一个控制器来提供该资源，如下所示：

public class WidgetsController : ApiController
{
    public Widget Get(int id)
    {
        return new Widget(...);
    }
}

现在，Widget该类可能非常大，并且想要节省从数据库到 Web 服务器以及从 Web 服务器到客户端的带宽，我创建了几个 DTO 类，其中包含有限数量的整体Widget. 例如：

public class WidgetSummary
{
    public int Id { get; set; }
    public string Code { get; set; }
    public string Description { get; set; }
    public decimal Price { get; set; }
}

public class FullWidgetForEditing
{
    public int Id { get; set; }
    public string Code { get; set; }
    public string Description { get; set; }
    public decimal Weight { get; set; }
    public decimal Price { get; set; }
    public Color Color { get; set; }
    public decimal Width { get; set; }
    public decimal Height { get; set; }
    public decimal Depth { get; set; }
}

public class WidgetForDropDownList
{
    public int Id { get; set; }
    public string Code { get; set; }
}

使用这些Widget表示，客户端将请求在系统中所有 sWidgetSummary的摘要网格上显示，它会请求在特定的编辑页面上，并且它会请求在订单的下拉列表中使用形式。WidgetFullWidgetForEditingWidgetWidgetForDropDownList

根据我对 REST 的理解，要访问 aWidget应该有一个 URL，因为它是一个资源，无论其表示形式如何，并且客户端应指定Accept带有媒体类型参数的标头以检索Widget其不同形式，例如my-awesome-product.type=widgetsummary、my-awesome-product.type=fullwidgetforediting和my-awesome-product.type=widgetfordropdownlist.

我可以通过检查请求的标头在 Web API 中实现这一点，如下所示：

public class WidgetsController : ApiController
{
    public object Get(int id)
    {
        if (Request.Headers.Accept.Any(x => x.Parameters.Any(y => y.Name == "my-awesome-product.type" && y.Value == "widgetsummary")))
        {
            return new WidgetSummary(...);
        }
        else if (Request.Headers.Accept.Any(x => x.Parameters.Any(y => y.Name == "my-awesome-product.type" && y.Value == "fullwidgetforediting")))
        {
            return new FullWidgetForEditing(...);
        }
        else if (Request.Headers.Accept.Any(x => x.Parameters.Any(y => y.Name == "my-awesome-product.type" && y.Value == "widgetfordropdownlist")))
        {
            return new WidgetForDropDownList(...);
        }

        throw new HttpResponseException(HttpStatusCode.NotAcceptable);
    }
}

但是，随着类型数量的增加，这会很快变得混乱，并使单元测试变得更加困难。我真正想做的是以下几点：

public class WidgetsController : ApiController
{
    [HttpGet(MediaType = "my-awesome-product.type", MediaTypeValue = "widgetsummary")]
    public WidgetSummary GetWidgetSummary(int id)
    {
        return new WidgetSummary();
    }

    [HttpGet(MediaType = "my-awesome-product.type", MediaTypeValue = "fullwidgetforediting")]
    public FullWidgetForEditing GetFullWidgetForEditing(int id)
    {
        return new FullWidgetForEditing();
    }

    [HttpGet(MediaType = "my-awesome-product.type", MediaTypeValue = "widgetfordropdownlist")]
    public WidgetForDropDownList GetWidgetForDropDownList(int id)
    {
        return new WidgetForDropDownList();
    }
}

并根据媒体类型将 Web API 路由到特定的操作方法。我调查了覆盖ApiControllerActionSelector，但是，我开始为该属性提取大量现有代码，因为我真的想要默认动作选择，但是在不明确的动作的情况下，我想根据媒体类型过滤动作列表. 我真的希望它是非侵入式的，以便我可以在需要时在同一个控制器中混合约定路由、标准属性路由（在 Web API v2 中）和这个假设的属性路由。

提问时间：目前是否可以使用 Web API 实现这样的路由策略？我是否必须完全重新实现ApiControllerActionSelector才能实现这一点（然后确保我的重新实现保持最新）？

4

1 回答 1

2

所以这是你需要思考的问题。这真的是三种表示形式，还是三种不同的资源？如果您决定缓存这些表示，URI 是否足以识别缓存的表示，或者您是否还需要改变接受标头？

如果您接受它们的差异足以成为资源，那么它们应该由不同的 URL 标识。如果您决定在回复中使用超链接，您是否不希望能够独立于“widgeteditform”指向“widgetsummary”？

当您想要支持仅能够支持特定媒体类型的不同客户端设备时，通常需要多种表示形式。例如，设备 A 获得 Rep1，设备 B 获得 Rep2。您很少希望设备 A 同时访问设备 A 和 Rep1 和 Rep2。

只是我的想法...

于 2013-08-26T12:35:20.203 回答