asp.net-mvc – 在MVC WebApi中的方法如何映射到http动词？

WebAPI匹配语义
WebAPI中的(默认路由)使用的匹配语义相当简单。

>它匹配动作的名称与动词(verb = GET？查找以“get”开头的方法名称)
>如果一个参数被传递，api寻找一个带有参数的动作

因此，在您的代码示例中，没有参数的GET请求与没有参数的Get *()函数匹配。 Get包含和ID寻找Get ***(int id)。

例子
虽然匹配的语义很简单，但它对MVC开发人员(至少是开发人员)造成了一些混乱。让我们看一些例子：

奇怪的名称 – 你的get方法可以命名任何东西，只要它以“get”开头。所以在widget控制器的情况下，你可以命名你的函数GetStrawberry()，它仍然会匹配。把匹配想象为：methodname.StartsWith(“Get”)

多个匹配方法 – 如果有两个没有参数的Get方法会发生什么？ GetStrawberry()和GetOrange()。最好的我可以告诉，函数定义第一(文件的顶部)在你的代码中赢得…奇怪。这有副作用，使一些方法在您的控制器不可达(至少与默认路由)….陌生人。

该怎么办？
那么，WebAPI是新的和共识仍然合并。社区似乎在达到REST原则相当多。然而，不是每个API都可以或应该是RESTful，有些更自然地表示为RPC样式。 REST&什么人称为REST似乎是quite a bit of confusion，well at least to Roy Fielding的来源。

作为一个实用主义者，我怀疑许多API将是70％的RESTful，有一些微小的RPC风格方法。首先，控制器增殖单独(给定webapi绑定方法)将驱动开发人员bonkers。第二，WebAPI真的没有一个内置的方式来创建api路径的嵌套结构(意思是：/ api / controller /很容易，但/ api / CATEGORY / Sub-Category / Controller是可行的，但是痛苦)。

从我的角度来看，我很想看到webAPI文件夹结构控制默认的API路径…意思如果我在我的UI项目中创建一个类别文件夹，那么/ api / Category将是默认路径(parallel to this MVC article)。

我做了什么？
所以，我有几个要求：(1)能够在大多数情况下使用restful语法，(2)有一些“命名空间”控制器分隔(认为子文件夹)，(3)能够调用额外的rpc-当需要时。实现这些要求归结于聪明的路由。

// SEE NOTE AT END ABOUT DataToken change from RC to RTM

Route r;
r = routes.MaphttpRoute( name          : "Category1",routeTemplate : "api/Category1/{Controller}/{iD}",defaults      : new { id = RouteParameter.optional } );
r.DataTokens["Namespaces"] = new String[] {" UI.Controllers.Category1"};

r = routes.MaphttpRoute( name          : "Category2",routeTemplate : "api/Category2/{Controller}/{iD}",defaults      : new { id = RouteParameter.optional } );
r.DataTokens["Namespaces"] = new String[] {" UI.Controllers.Category2"};

routes.MaphttpRoute(     name          : "ApiAllowingBL",routeTemplate : "api/{Controller}/{action}/{iD}",defaults      : new { id = RouteParameter.optional } );

routes.MaphttpRoute(     name          : "DefaultApi",routeTemplate : "api/{Controller}/{iD}",defaults      : new { id = RouteParameter.optional } );

>前两个路由创建“子文件夹”路由。我需要为每个子文件夹创建一个路由，但我限于自己的主要类别，所以我最终只有3-10。注意这些路由如何添加Namespace数据令牌，以限制搜索特定路由的类。这很好地对应于在向UI项目添加文件夹时的典型命名空间设置。
>第三个路由允许调用特定的方法名(如传统的mvC)。由于网络API不包含网址中的操作名称，因此很容易分辨出哪些呼叫需要此路由。
>最后一个路由条目是默认的web api路由。这捕获任何类，特别是我的’子文件夹’之外的类。

另一种说法
我的解决方案归结到分离控制器多一点/ api / XXXX没有得到太拥挤。

>我在我的UI项目中创建一个文件夹(让我们说Category1)，并将api控制器放在该文件夹中。
> Visual studio自然地基于文件夹设置类命名空间。因此，Category1文件夹中的Widget1获取一个默认的UI.Category1.Widget1命名空间。
>当然，我想要api URL反映文件夹结构(/ api / Category1 / Widget)。你看到的第一个映射完成了，通过硬编码/ api / Category1到路由，然后命名空间令牌限制将搜索匹配控制器的类。

r.AddRouteToken("Namespaces",new String[] {"UI.Controllers.Category1"});

private static Route AddRouteToken(this Route r,String key,String[] values) {
  //change from RC to RTM ...datatokens is null
if (r.DataTokens == null) {
       r.DataTokens = new RouteValueDictionary();
    }
    r.DataTokens[key] = values;
    return r;
}

private static IhttpRoute MaphttpRoute(this httpRouteCollection routes,String name,String routeTemplate,object defaults,object consTraints,String[] namespaCETokens)
{   
    httpRouteValueDictionary    defaultsDictionary      = new httpRouteValueDictionary(defaults);
    httpRouteValueDictionary    consTraintsDictionary   = new httpRouteValueDictionary(consTraints);
    IDictionary<String,object> tokens                  = new Dictionary<String,object>();
                                tokens.Add("Namespaces",namespaCETokens);

    IhttpRoute route = routes.CreateRoute(routeTemplate,defaultsDictionary,consTraintsDictionary,dataTokens: tokens,handler:null);
    routes.Add(name,routE);

    return route;
}