如何修改框架的默认 Web API 路由？

Question

如果 URL 中没有提供任何操作，Web API 似乎有一个内置的默认逻辑来使用 HTTP 动词作为操作名称。例如，我有这条路线：

        config.Routes.MapHttpRoute(
            name: "DefaultApiController",
            routeTemplate: "api/{controller}"
        );

这是我的行动：

    public IEnumerable<Conference> Get()
    {
        ...
    }

    [ActionName("current")]
    public IEnumerable<Conference> GetCurrent()
    {
        ...
    }

当我使用 GET 动词转到 ~/Conferences 时，它会将您带到“Get()”操作。如果使用 POST 动词，它会将您带到“Post([FromBody]Conference value)”动作......等等。但是当您尝试转到 ~/Conferences/GetCurrent 时会发生冲突（即使我在顶部有 [ActionName("current")]）：

找到多个与请求匹配的操作： System.Collections.Generic.IEnumerable1[MyApp.Models.Conference] Get() on type MyApp.Api.ConferencesController System.Collections.Generic.IEnumerable1[MyApp.Models.Conference] MyApp.Api.ConferencesController 类型上的 GetCurrent()

这意味着框架使用 StartsWith 而不是 Equal 来确定默认操作。在将动词与动作匹配时，它也会忽略 ActionName 属性。

我的问题是如何使框架的默认操作与动词完全匹配，而不是使用 StartsWith 逻辑？ GET 动词应该只匹配 Get() 动作，而不是 Get()、GetCurrent() GetPast() 等（尤其是当它忽略 ActionName 属性时）。

编辑 为简单起见，我只在上面展示了我的一条路线。我认为如果我显示所有仍在草稿中的路线可能会有所帮助。我正在尝试获得一个完全正常工作的 REST API，同时仍然为添加我自己的自定义操作留出空间：

    public static void Register(HttpConfiguration config)
    {
        config.Routes.MapHttpRoute(
            name: "DefaultApiControllerActionId",
            routeTemplate: "api/{controller}/{action}/{id}",
            defaults: null,
            constraints: new { action = @"^[a-zA-Z]+$", id = @"^\d+$" } // action must start with character
        );

        config.Routes.MapHttpRoute(
            name: "DefaultApiControllerActionName",
            routeTemplate: "api/{controller}/{action}/{name}",
            defaults: null,
            constraints: new { action = @"^[a-zA-Z]+$", name = @"^[a-zA-Z]+$" } // action and name must start with character
        );

        config.Routes.MapHttpRoute(
            name: "DefaultApiControllerId",
            routeTemplate: "api/{controller}/{id}",
            defaults: null,
            constraints: new { id = @"^\d+$" } // id must be all digits
        );

        config.Routes.MapHttpRoute(
            name: "DefaultApiControllerAction",
            routeTemplate: "api/{controller}/{action}",
            defaults: null,
            constraints: new { action = @"^[a-zA-Z]+$" } // action must start with character
        );

        config.Routes.MapHttpRoute(
            name: "DefaultApiController",
            routeTemplate: "api/{controller}"
        );

更新 添加 HTTP 动词约束似乎有所帮助：

        config.Routes.MapHttpRoute(
            name: "DefaultApiControllerGet",
            routeTemplate: "api/{controller}",
            defaults: new { action = "Get" },
            constraints: new { httpMethod = new HttpMethodConstraint(HttpMethod.Get) }
        );

        config.Routes.MapHttpRoute(
            name: "DefaultApiControllerPost",
            routeTemplate: "api/{controller}",
            defaults: new { action = "Post" },
            constraints: new { httpMethod = new HttpMethodConstraint(HttpMethod.Post) }
        );

        config.Routes.MapHttpRoute(
            name: "DefaultApiControllerPut",
            routeTemplate: "api/{controller}",
            defaults: new { action = "Put" },
            constraints: new { httpMethod = new HttpMethodConstraint(HttpMethod.Put) }
        );

        config.Routes.MapHttpRoute(
            name: "DefaultApiControllerDelete",
            routeTemplate: "api/{controller}",
            defaults: new { action = "Delete" },
            constraints: new { httpMethod = new HttpMethodConstraint(HttpMethod.Delete) }
        );

Answer 1

编辑：由于您对问题做了很大的修改，我需要更改回复：

简而言之 - 这永远不会在 Web API 中开箱即用，因为它会默认调度操作：

1. 如果 {action} 是路由数据的一部分，则基于操作名称
2. 基于 HTTP 动词

但是，这两种方法不能在单个控制器中混合使用，因此您将无法使用单个控制器中的两种方法来调度操作（这是您尝试做的）。

您有三种方法可以解决此问题：

1. 重做您的资源，以便您有单独的资源用于动作名称调度和基于动词的调度（这远非理想）

2. 为每个嵌套路由手动注册路由。这样你就可以继续通过 HTTP 动词进行调度，但路由清楚地指向一个特定的操作。您可以使用 AttributeRouting (https://github.com/mccalltd/AttributeRouting) 之类的东西来简化它。缺点显然是你最终 - 有效 - 每个动作一个路线

3. 实现一个新的IActionSelector，它允许您在单个控制器中混合基于动词和基于动作名称的调度。这是最“低级”的解决方案，但看起来与您想要做的完全一样。我上周发布了一个演练 - http://www.strathweb.com/2013/01/magical-web-api-action-selector-http-verb-and-action-name-dispatching-in-a-single-controller/