苏州建设局网站实名制,做网站的公司倒闭,wordpress 徽标,官网建设需求此博客是基于 asp.net core web api(.net core3.1)框架进行操作的。
一、安装Swagger包
在 NuGet程序包管理中安装下面的两个包#xff1a;
swagger包#xff1a;Swashbuckle.AspNetCore
swagger包过滤器#xff1a;Swashbuckle.AspNetCore.Filters 二、swagger注册
在…此博客是基于 asp.net core web api(.net core3.1)框架进行操作的。
一、安装Swagger包
在 NuGet程序包管理中安装下面的两个包
swagger包Swashbuckle.AspNetCore
swagger包过滤器Swashbuckle.AspNetCore.Filters 二、swagger注册
在 Startup.cs文件的 ConfigureServices方法中进行 swagger注册。
#region swagger注入
services.AddSwaggerGen(c
{#region 添加文档信息 c.SwaggerDoc(v1, new OpenApiInfo{Title aspNetCURD,Version v1,Description RESTful API});#endregion#region 添加 Controller注释var xmlFile ${Assembly.GetExecutingAssembly().GetName().Name}.xml; // 获取 项目名 .xml 的文件var xmlPath Path.Combine(AppContext.BaseDirectory, xmlFile); // 文件 pathc.IncludeXmlComments(xmlPath); // 添加 Controller注释#endregion#region 添加 swagger小锁 不需要授权的可以不要小锁var openApiSecurity new OpenApiSecurityScheme{Description JWT认证授权使用直接在下框中输入Bearer {token}注意两者之间是一个空格\,Name Authorization, //jwt 默认参数名称In ParameterLocation.Header, //jwt默认存放Authorization信息的位置请求头Type SecuritySchemeType.ApiKey};c.AddSecurityDefinition(oauth2, openApiSecurity);c.OperationFilterAddResponseHeadersFilter();c.OperationFilterAppendAuthorizeToSummaryOperationFilter();c.OperationFilterSecurityRequirementsOperationFilter();#endregion});
#endregion 三、swagger 注入管道
在 app.UseRouting() 之后app.UseEndpoints() 之前将swagger注入管道。
app.UseRouting();#region swagger管道注入
// 启用Swagger中间件
app.UseSwagger();// 配置SwaggerUI
app.UseSwaggerUI(c
{c.SwaggerEndpoint(/swagger/v1/swagger.json, aspNetCURD);c.RoutePrefix string.Empty; //路由前缀设置为空
});
#endregion 四、在项目的属性中添加 .xml路径
打开项目的属性找到 生成/输出在 XML文档文件路径 处配置上 xml路径。
XML文档文件路径为项目名称 .xml 五、最后效果
1没有使用授权小锁时 2使用了授权小锁后 #若有错误或不足欢迎大佬斧正。