不要在 Swashbuckle (Swagger) 中显示端点答案

【问题标题】：Don't show endpoints in Swashbuckle (Swagger)不要在 Swashbuckle (Swagger) 中显示端点
【发布时间】：2020-06-04 11:39:12
【问题描述】：

我在 SwaggerUI 中的显示端点有问题。例如

[ApiVersion("5.0")]
[RoutePrefix("mobile/v{version:apiVersion}/persons")]
public class LessonController : ApiController
{

 -------------------------------------

    [HttpGet]
    [Route("{personId}/groups/{groupId}/lessons/{lessonId}/lessonDetails")]
    public LessonDetailsModel LessonDetails(long personId, long groupId, long lessonId)
    {
       ----------------------------------

它的端点不显示，但如果我将 RoutePrefix 更改为

 [RoutePrefix("mobile/v{version:apiVersion}/persons1")]

端点秀

更新： SwaggerConfig

 GlobalConfiguration.Configuration
            .EnableSwagger("mobile/swagger/docs/{apiVersion}", c => {
                  c.MultipleApiVersions(
                    ResolveVersionSupportByRouteConstraint,
                    (vc) =>
                    {
                        vc.Version("v5.0", "Api version 5");
                        vc.Version("v4.0", "Api version 4");
           ------------------------------------------------------
                    });

                c.UseFullTypeNameInSchemaIds();
                c.ResolveConflictingActions(apiDescriptions => apiDescriptions.First());
                c.OperationFilter<RemoveVersionParameters>();
                c.OperationFilter<InjectCustomApiParameters>();
                c.DocumentFilter<SetVersionInPaths>();
                c.IncludeXmlComments(Path.ChangeExtension($"{Assembly.GetExecutingAssembly().GetName().CodeBase}", ".xml"));
            })
            .EnableSwaggerUi("mobile/swagger/ui/{*assetPath}", c => {
                c.DocumentTitle("Mobile Api Swagger");
                c.DisableValidator();
                c.EnableDiscoveryUrlSelector();
            });

【问题讨论】：

请向我们展示您的 Startup 的 ConfigureServices 和 Configure 方法的样子。请仅包含相关部分。
BTW here is a walkthrough 如何使用 Swashbuckle 实现版本控制
我是更新问题
嗯，这很有趣。 MultipleApiVersions 和 EnableDiscoveryUrlSelector calas 在那里...这个 v5.0 对我来说很奇怪，老实说，我没有在 API 版本中看到次要版本。您是否尝试过没有次要版本，所以只有主要版本？（v4 和 v5）
很遗憾，这并不影响显示，我发现只是改变RoutePrefix，可能IHttpControllerSelector表现不佳

标签： c# asp.net swagger swashbuckle .net-4.8

【解决方案1】：

我找到了解决问题的方法。我实现了 IApiExplorer。

public class VersionedApiExplorer : IApiExplorer
{
    private readonly IApiExplorer _innerApiExplorer;
    private readonly HttpConfiguration _configuration;
    private readonly Lazy<Collection<ApiDescription>> _apiDescriptions;
    private MethodInfo _apiDescriptionPopulator;

    public VersionedApiExplorer(IApiExplorer apiExplorer, HttpConfiguration configuration)
    {
        _innerApiExplorer = apiExplorer;
        _configuration = configuration;
        _apiDescriptions = new Lazy<Collection<ApiDescription>>(Init);
    }

    public Collection<ApiDescription> ApiDescriptions => _apiDescriptions.Value;

    private Collection<ApiDescription> Init()
    {
        var descriptions = _innerApiExplorer.ApiDescriptions;

        var controllerSelector = _configuration.Services.GetHttpControllerSelector();
        var controllerMappings = controllerSelector.GetControllerMapping();

        var flatRoutes = FlattenRoutes(_configuration.Routes).ToList();
        var result = new Collection<ApiDescription>();

        foreach (var description in descriptions)
        {
            result.Add(description);

            if (controllerMappings == null || !description.Route.Constraints.Any()) continue;
            var matchingRoutes = flatRoutes.Where(r =>
                r.RouteTemplate == description.Route.RouteTemplate && r != description.Route);

            foreach (var route in matchingRoutes)
                GetRouteDescriptions(route, result);
        }

        return result;
    }

    private void GetRouteDescriptions(IHttpRoute route, IReadOnlyCollection<ApiDescription> apiDescriptions)
    {
        if (route.DataTokens["actions"] is IEnumerable<HttpActionDescriptor> actionDescriptor &&
            actionDescriptor.Any())
            GetPopulateMethod().Invoke(_innerApiExplorer,
                new object[] {actionDescriptor.First(), route, route.RouteTemplate, apiDescriptions});
    }

    private MethodInfo GetPopulateMethod()
    {
        if (_apiDescriptionPopulator == null)
            _apiDescriptionPopulator = _innerApiExplorer.GetType()
                .GetMethods(BindingFlags.NonPublic | BindingFlags.Instance).FirstOrDefault(
                    m => m.Name == "PopulateActionDescriptions" && m.GetParameters().Length == 4);

        return _apiDescriptionPopulator;
    }

    public static IEnumerable<IHttpRoute> FlattenRoutes(IEnumerable<IHttpRoute> routes)
    {
        foreach (var route in routes)
        {
            switch (route)
            {
                case HttpRoute _:
                    yield return route;
                    break;
                case IReadOnlyCollection<IHttpRoute> subRoutes:
                {
                    foreach (var subRoute in FlattenRoutes(subRoutes))
                        yield return subRoute;
                    break;
                }
            }
        }
    }
}

【讨论】：