同一个 HttpVerb 的多个操作

Question

我有一个具有以下操作的 Web API 控制器：

    [HttpPut]
    public string Put(int id, JObject data)

    [HttpPut, ActionName("Lock")]
    public bool Lock(int id)

    [HttpPut, ActionName("Unlock")]
    public bool Unlock(int id)

并映射了以下路线：

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

当我提出以下请求时，一切都会按预期进行：

PUT /api/items/Lock/5
PUT /api/items/Unlock/5

但是当我尝试向以下方面提出请求时：

PUT /api/items/5

我得到以下异常：

Multiple actions were found that match the request:
    Put(int id, JObject data)
    Lock(int id)
    Unlock(int id)

我尝试将空操作名称添加到默认路由，但没有帮助：

[HttpPut, ActionName("")]
public string Put(int id, JObject data)

有什么想法可以将默认 RESTful 路由与自定义操作名称结合起来吗？

编辑：路由机制不会因控制器的选择而混淆。它对在单个控制器上选择 action 感到困惑。我需要的是在未指定任何操作时匹配默认操作。希望能澄清一些事情。

Answer 1

这是来自默认操作选择器ApiControllerActionSelector 的预期错误。您基本上拥有三个对应于 HTTP Put 动词的操作方法。还要记住，默认动作选择器考虑简单动作参数类型，它们都是原始 .NET 类型，众所周知的简单类型（System.String，System.DateTime，System.Decimal，System.Guid，System.DateTimeOffset，@987654331 @) 和底层简单类型（例如：Nullable<System.Int32>）。

作为您的问题的解决方案，我将为以下控制器创建两个控制器：

public class FooController : ApiController { 

    public string Put(int id, JObject data)
}

public class FooRPCController : ApiController { 

    [HttpPut]
    public bool Lock(int id)

    [HttpPut]
    public bool Unlock(int id)
}

路线如下所示：

routes.MapHttpRoute(
    name: "ApiAction",
    routeTemplate: "api/Foo/{action}/{id}",
    defaults: new { controller = "FooRPC" }
);

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

另一方面（与您的主题不完全相关），我有三篇关于动作选择的博文，尤其是复杂类型参数。我鼓励您查看它们，因为它们可能会为您提供更多视角：

• Complex Type Action Parameters and Controller Action Selection with ASP.NET Web API
• Complex Type Action Parameters with ComplexTypeAwareActionSelector in ASP.NET Web API - Part 1
• Complex Type Action Parameters with ComplexTypeAwareActionSelector in ASP.NET Web API - Part 2

Answer 2

在Giscard Biamby 的帮助下，我找到了this answer，它为我指明了正确的方向。最终，为了解决这个特定问题，我这样做了：

routes.MapHttpRoute(
    name: "ApiPut", 
    routeTemplate: "api/{controller}/{id}",
    defaults: new { action = "Put" }, 
    constraints: new { httpMethod = new HttpMethodConstraint("Put") }
);

感谢@GiscardBiamby

Answer 3

首先，删除[HttpPut, ActionName("")]，然后修改你的路由到这个

config.Routes.MapHttpRoute(
    name: "Api",
    routeTemplate: "api/{controller}/{id}",
    defaults: new { id = RouteParameter.Optional },
    constraints: new { id = @"^[0-9]+$" }
    );