Пользовательский ApiExplorer с ApiControllers на основе пространства имен

Я покажу вам, как это сделать. Этот код предназначен только для обучения. Здесь я не говорю о дизайне и лучших практиках, поэтому не стесняйтесь менять все, что хотите.

Ну, вы должны выполнить следующие шаги:

1) Создайте собственный ApiExplorer:

public class MyApiExplorer: ApiExplorer
{
    private readonly string _version;

    public MyApiExplorer(string version) : base(GlobalConfiguration.Configuration)
    {
        _version = version != null ? version.ToUpperInvariant() : "V1";

        foreach(var apiDescription in ApiDescriptions)
        {
            apiDescription.RelativePath = apiDescription.RelativePath.Replace("{version}", _version);
        }

    }

    public override bool ShouldExploreController(string controllerVariableValue, HttpControllerDescriptor controllerDescriptor,
        IHttpRoute route)
    {
        return controllerDescriptor.ControllerType.FullName.Contains(_version);
    }

}

а) В конструкторе _версия будет преобразована в верхний регистр (на всякий случай, если он будет передан как нижний регистр), но если он равен нулю, то по умолчанию будет использоваться V1. Затем измените относительный путь, чтобы показать конкретную версию вместо {версия}.

b) ShouldExploreController (короткими словами) решает, берется ли конкретный контроллер для отображения в документации. В этом случае мы будем показывать только те контроллеры, полное название которых содержит выбранную версию.

2) Перейдите в класс HelpController и измените метод Index следующим образом:

public ActionResult Index(string version)
{
    //...

    Configuration.Services.Replace(typeof(IApiExplorer), new MyApiExplorer(version));

    return View(Configuration.Services.GetApiExplorer().ApiDescriptions);
}

Мы заменяем текущий ApiExplorer своим собственным, чтобы он возвращался при вызове Configuration.Services.GetApiExplorer().

Теперь вы можете использовать это .../help?version=v1 или .../help?version=v2 или .../help?version=v3, и вы получите конкретную документацию по контроллеру API.

Оказалось, что ApiExplorer здесь ни при чем. Вместо этого вы должны изменить свой селектор контроллера на основе пространства имен:

NamespaceHttpControllerSelector : DefaultHttpControllerSelector
{
//...
    public override IDictionary<string, HttpControllerDescriptor> GetControllerMapping() 
    {
        var mapping = base.GetControllerMapping();
        mapping["User"] = new HttpControllerDescriptor
        {
            Configuration = _httpConfig,
            ControllerName = "User",
            ControllerType = typeof(UserController)
        };
        //...
        return mapping;
    }
    //...  }

То есть. После этого по умолчанию ApiExplorer найдет вам контроллеры и выберет все действия.

Недавно я столкнулся с похожей проблемой и решил ее следующим образом: 2 LOC:

public class VersionControllerSelector : IHttpControllerSelector

to

public class VersionControllerSelector : DefaultHttpControllerSelector

...а также...

public VersionControllerSelector(HttpConfiguration config)

to

public VersionControllerSelector(HttpConfiguration config) : base(config)