向ASP.NET Web API Controller添加显式操作路由

时间:2014-01-16 02:10:00

标签: c# asp.net asp.net-mvc rest asp.net-web-api

我有一个带有ApiController的ASP.NET Web API项目,它为User端点提供了以下操作:

GET /api/User
POST /api/User
DELETE /api/user

我想提供以下端点:

GET /api/user/metrics

但是,当我像这样定义控制器动作时:

[HttpGet]
public HttpResponseMessage Metrics()
{
    return null;
}

我收到Multiple actions were found that match the request错误消息。

我理解这违反了“纯”REST API的定义,但这就是我想要的方法。我想我必须通过映射HTTP路由来解决这个问题,但是我尝试了一些路由而且我无法让它工作。我的路线应该是什么样的?

2 个答案:

答案 0 :(得分:19)

默认路由不包含操作。

routes.MapHttpRoute(
    name: "API Default",
    routeTemplate: "api/{controller}/{id}",
    defaults: new { id = RouteParameter.Optional }
);

它根据路径中的控制器,HTTP谓词和参数或缺少参数来选择操作。因此,它找到了正确的控制器并寻找没有参数的GET动作。它找到了两个。

您应该添加包含该操作的其他路线。这可以通过Kiran提到的基于属性的路由或基于约定的路由来完成。对于基于约定的路由,路由通常放在Application_start() WebApiConfig.cs方法中。更具体的路线在一般路线之前,所以你的路线看起来像这样:

config.Routes.MapHttpRoute(
                name: "ApiWithAction",
                routeTemplate: "api/{controller}/{action}/{id}",
                defaults: new { id = RouteParameter.Optional }
            );

 config.Routes.MapHttpRoute(
            name: "DefaultApi",
            routeTemplate: "api/{controller}/{id}",
            defaults: new { id = RouteParameter.Optional }
        );

答案 1 :(得分:17)

如果您使用的是Web API 2,我建议使用属性路由,这样可以使这些场景更容易体验。

您可以继续使用默认的常规路由来处理大多数情况,但可以在需要的位置使用属性路由,就像在当前场景中一样。

以下示例演示了类似的情况:

http://aspnet.codeplex.com/SourceControl/latest#Samples/WebApi/WebApiAttributeRoutingSample/WebApiAttributeRoutingSample/Controllers/Api/CustomersController.cs