ApiExplorer 无法识别自定义类型的路由属性

我有一个项目，我想在其中使用自定义类型的路由属性。 我将自定义类型作为查询参数的以下代码工作正常，并且帮助页面显示自定义类型。

// GET api/values?5,6
[Route("api/values")]
public string Get(IntegerListParameter ids)
{
    return "value";
}

WebApi.HelpPage 提供以下文档帮助：页面

如果我更改代码以使用路由属性，结果是我得到一个空的帮助页面。

// GET api/values/5,6
[Route("api/values/{ids}")]
public string Get(IntegerListParameter ids)
{
    return "value";
}

当我检查 HelpController.cs 中的代码时，我观察到 ApiExplorer.ApiDescriptions 返回 ApiDescriptions 的空集合

public ActionResult Index()
{
    ViewBag.DocumentationProvider = Configuration.Services.GetDocumentationProvider();
    Collection<ApiDescription> apiDescriptions = Configuration.Services.GetApiExplorer().ApiDescriptions;

    return View(apiDescriptions);
}

有什么方法可以让 ApiExplorer 将我的自定义类 IntegerListParameter 识别为属性路由？

你需要：

1. 为您的添加 HttpParameterBindingIntegerListParameter type
2. 将绑定标记为IValueProviderParameterBinding并实施ValueProviderFactories
3. 添加转换器IntegerListParameter并覆盖CanConvertFrom方法用于typeof(string)范围

完成这些操作后，ApiExplorer 中必须识别具有自定义类型 IntegerListParameter 的路由。

请参阅我的示例了解类型ObjectId:

public static class WebApiConfig
{
    public static void Register(HttpConfiguration config)
    {
        //...
        config.ParameterBindingRules.Insert(0, GetCustomParameterBinding);
        TypeDescriptor.AddAttributes(typeof(ObjectId), new TypeConverterAttribute(typeof(ObjectIdConverter)));
        //...
    }

    public static HttpParameterBinding GetCustomParameterBinding(HttpParameterDescriptor descriptor)
    {
        if (descriptor.ParameterType == typeof(ObjectId))
        {
            return new ObjectIdParameterBinding(descriptor);
        }
        // any other types, let the default parameter binding handle
        return null;
    }
}

public class ObjectIdParameterBinding : HttpParameterBinding, IValueProviderParameterBinding
{
    public ObjectIdParameterBinding(HttpParameterDescriptor desc)
        : base(desc)
    {
    }

    public override Task ExecuteBindingAsync(ModelMetadataProvider metadataProvider, HttpActionContext actionContext, CancellationToken cancellationToken)
    {
        try
        {
            SetValue(actionContext, new ObjectId(actionContext.ControllerContext.RouteData.Values[Descriptor.ParameterName] as string));
            return Task.CompletedTask;
        }
        catch (FormatException)
        {
            throw new BadRequestException("Invalid id format");
        }
    }

    public IEnumerable<ValueProviderFactory> ValueProviderFactories { get; } = new[] { new QueryStringValueProviderFactory() };
}

public class ObjectIdConverter : TypeConverter
{
    public override bool CanConvertFrom(ITypeDescriptorContext context, Type sourceType)
    {
        if (sourceType == typeof(string))
            return true;
        return base.CanConvertFrom(context, sourceType);
    }
}