webapi版本控制

public class Startup
    {
        public static string VersionName = "api-version";
        /// <summary>
        /// Configures the application using the provided builder.
        /// </summary>
        /// <param name="builder">The current application builder.</param>
        public void Configuration( IAppBuilder builder )
        {
            // we only need to change the default constraint resolver for services that want urls with versioning like: ~/v{version}/{controller}
            var constraintResolver = new DefaultInlineConstraintResolver() { ConstraintMap = { ["apiVersion"] = typeof( ApiVersionRouteConstraint ) } };
            var configuration = new HttpConfiguration();
            var httpServer = new HttpServer( configuration );

            // reporting api versions will return the headers "api-supported-versions" and "api-deprecated-versions"
            configuration.AddApiVersioning( o => {
                o.ReportApiVersions = true;
                //采用header方式控制版本
                o.ApiVersionReader = new HeaderApiVersionReader(Startup.VersionName);
            } );
            configuration.MapHttpAttributeRoutes( constraintResolver );
            //集成swagger
            var apiExplorer = configuration.AddVersionedApiExplorer( o => o.GroupNameFormat = "‘v‘VVV" );
            configuration.EnableSwagger(
                            "{apiVersion}/swagger",
                            swagger =>
                            {
                                //多版本选择配置
                                swagger.MultipleApiVersions(
                                    ( apiDescription, version ) => apiDescription.GetGroupName() == version,
                                    info =>
                                    {
                                        foreach ( var group in apiExplorer.ApiDescriptions )
                                        {
                                            var description = "A sample application with Swagger, Swashbuckle, and API versioning.";

                                            if ( group.IsDeprecated )
                                            {
                                                description += " This API version has been deprecated.";
                                            }

                                            info.Version(group.Name, $"webapi文档 {group.ApiVersion}");
                                        }
                                    } );
                                //调试时添加版本参数
                                swagger.DocumentFilter<ReplaceQueryVersionFilter>();
                                //为版本参数设置默认值
                                swagger.OperationFilter<SwaggerDefaultValuesFilter>();
                                //载入xml
                                string xmlFile = XmlCommentsFilePath;
                                swagger.IncludeXmlComments(xmlFile);
                            } )
                         .EnableSwaggerUi( swagger => {
                             swagger.EnableDiscoveryUrlSelector();
                         });

            builder.UseWebApi( httpServer );
        }

        static string XmlCommentsFilePath
        {
            get
            {
                var basePath = System.AppDomain.CurrentDomain.RelativeSearchPath;
                var fileName = typeof( Startup ).GetTypeInfo().Assembly.GetName().Name + ".xml";
                return Path.Combine( basePath, fileName );
            }
        }

 /// <summary>
    /// 将query中的版本号参数更换为head请求方式
    /// </summary>
    public class ReplaceQueryVersionFilter : IDocumentFilter
    {
        public void Apply(SwaggerDocument swaggerDoc, SchemaRegistry schemaRegistry, IApiExplorer apiExplorer)
        {
            foreach (PathItem path in swaggerDoc.paths.Values)
            {
                var versionParam = path.get.parameters.FirstOrDefault(i => i.name == Startup.VersionName);
                if (versionParam != null)
                {
                    var index = path.get.parameters.IndexOf(versionParam);
                    path.get.parameters[index].@in = "header";
                }
            }
        }
    }

public class SwaggerDefaultValuesFilter : IOperationFilter
    {
        /// <summary>
        /// Applies the filter to the specified operation using the given context.
        /// </summary>
        /// <param name="operation">The operation to apply the filter to.</param>
        /// <param name="schemaRegistry">The API schema registry.</param>
        /// <param name="apiDescription">The API description being filtered.</param>
        public void Apply( Operation operation, SchemaRegistry schemaRegistry, ApiDescription apiDescription )
        {
            if ( operation.parameters == null )
            {
                return;
            }

            foreach ( var parameter in operation.parameters )
            {
                try
                {
                    var description = apiDescription.ParameterDescriptions.First(p => p.Name == parameter.name);

                    // REF: https://github.com/domaindrivendev/Swashbuckle/issues/1101
                    if (parameter.description == null)
                    {
                        parameter.description = description.Documentation;
                    }

                    // REF: https://github.com/domaindrivendev/Swashbuckle/issues/1089
                    // REF: https://github.com/domaindrivendev/Swashbuckle/pull/1090
                    if (parameter.@default == null)
                    {
                        parameter.@default = description.ParameterDescriptor.DefaultValue;
                    }
                }
                catch
                {

                }
            }
        }
    }