zoukankan html css js c++ java

Core3.0使用Swagger接口文档

前言

此方法为百度搜索结果，原文链接找不到了

步骤

1.引用Nuget

Swashbuckle.AspNetCore

2.Startup.cs配置

            //注册swagger服务,定义1个或者多个swagger文档
            services.AddSwaggerGen(s =>
            {
                //设置swagger文档相关信息
                s.SwaggerDoc("v1", new OpenApiInfo
                {
                    Title = "NoteWebApi文档",
                    Description = "Note随记备忘录接口文档",
                    Version = "v1.0"
                });

                //获取xml注释文件的目录
                var xmlFile = $"{System.Reflection.Assembly.GetExecutingAssembly().GetName().Name}.xml";
                var xmlPath = System.IO.Path.Combine(AppContext.BaseDirectory, xmlFile);
                // 启用xml注释
                s.IncludeXmlComments(xmlPath);
            });

            //启用swagger中间件
            app.UseSwagger();
            //启用SwaggerUI中间件（htlm css js等），定义swagger json 入口
            app.UseSwaggerUI(s =>
            {
                s.SwaggerEndpoint("/swagger/v1/swagger.json", "NoteWebapi文档v1");
                //要在应用的根 (http://localhost:&lt;port&gt;/) 处提供 Swagger UI，请将 RoutePrefix 属性设置为空字符串：
                //s.RoutePrefix = string.Empty;
            });