WebAPI HelpPage支持area

开篇：对于WebApi研究不是很深，刚开始使用，记录自己的解决思路，有更好的处理方式或发现我对WebApi理解有不对的地方恳请指正，谢谢！

环境：WebAPI服务、HelpPage，API路由：“api/{controller}/{action}”，服务与helpPage运行正常，帮助文档页面所有API地址遵循路由格式

问题描述：当两个area下出现同名的controller/action时，生成的帮助文档页面API地址会一模一样，请求出错

解决思路：将路由定义为“api/{area}/{controller}/{action}”，已区分不同的area，但测试后发现HelpPage页面生成的API地址中“{area}”部分无法替换为正确的名称，尝试良久，终于解决，将解决过程列出如下：

1.WebApiConfig 修改api路由如下

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

2.修改helpPage下的ApiDescriptionExtensions，在GetFriendlyId中加入如下处理

public static string GetFriendlyId(this ApiDescription description)
        {
            //获取controller的fullname
            string controllerFullName = description.ActionDescriptor.ControllerDescriptor.ControllerType.FullName;
            //匹配areaName
            string areaName = Regex.Match(controllerFullName, @"Area.([^,]+).C").Groups[1].ToString().Replace(".","");
            if (string.IsNullOrEmpty(areaName))
            {
                //若不是areas下的controller,将路由格式中的{area}去掉
                description.RelativePath = description.RelativePath.Replace("{area}/", "");
            }
            else
            {
                //若是areas下的controller,将路由格式中的{area}替换为真实areaname
                description.RelativePath = description.RelativePath.Replace("{area}", areaName);
            }
}

3.HelpController下的API  action调整

public ActionResult Api(string apiId)
        {
            if (!String.IsNullOrEmpty(apiId))
            {
                HelpPageApiModel apiModel = Configuration.GetHelpPageApiModel(apiId);
                if (apiModel != null)
                {
                    //防止生成帮助文档时将area作为了Uri参数
                    foreach (var item in apiModel.UriParameters)
                    {
                        if (item.Name.Equals("area"))
                        {
                            apiModel.UriParameters.Remove(item);
                            break;
                        }
                    }

                    return View(apiModel);
                }
            }

            return View(ErrorViewName);
        }

至此修改完成，运行后在help页面，API地址显示正常，TestAPI测试通过

另外，看到有人使用RoutePrefix和Route等路由新特性处理的，没试过，有时间再研究一下

题外：运行WebAPI后直接显示Help页面

routes.MapRoute(
                name: "Default",
                url: "{controller}/{action}/{id}",
                defaults: new { controller = "Help", action = "Index", id = UrlParameter.Optional },
                namespaces: new string[] { "HelpController命名空间" }
            ).DataTokens.Add("Area","HelpPage");