作者:mobiledu2502924751 | 来源:互联网 | 2023-12-09 19:33
本文介绍了使用.NetCoreWebApi生成Swagger接口文档的方法,并详细说明了Swagger的定义和功能。通过使用Swagger,可以实现接口和服务的可视化,方便测试人员进行接口测试。同时,还提供了Github链接和具体的步骤,包括创建WebApi工程、引入swagger的包、配置XML文档文件和跨域处理。通过本文,读者可以了解到如何使用Swagger生成接口文档,并加深对Swagger的理解。
1. Swagger是什么?
Swagger 是一个规范和完整的框架,用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。总体目标是使客户端和文件系统作为服务器以同样的速度来更新。文件的方法,参数和模型紧密集成到服务器端的代码,允许API来始终保持同步。Swagger 让部署管理和使用功能强大的API从未如此简单。
2.Swagger可以干什么?
a.接口,服务可视化,非常清晰,好用
b.做接口测试,方便测试人员使用
Github:https://github.com/wuyabusi/swagger.git
第一步:创建WebApi工程
第二步:引入swagger的包
第三步:打开解决方案属性-->生成,勾选XML文档文件,保存
第四步:在Startup.cs的ConfigureServices中添加配置
public void ConfigureServices(IServiceCollection services)
{
//配置跨域处理
services.AddCors(optiOns=>
{
options.AddPolicy("any", builder =>
{
builder.AllowAnyOrigin() //允许任何来源的主机访问
.AllowAnyMethod()
.AllowAnyHeader()
.AllowCredentials();//指定处理COOKIE
});
});
//配置Swagger
services.AddSwaggerGen(c =>
{
c.SwaggerDoc("v1", new Info
{
Version = "v1",
Title = "接口文档",
Description = "RESTful API for TwBusManagement"
});
var basePath = PlatformServices.Default.Application.ApplicationBasePath;
var xmlPath = Path.Combine(basePath, "TextApi.xml");//和上面图片中xml地址相同
c.IncludeXmlComments(xmlPath);
//
});
services.AddMvc();
}
第五步.在Configure中添加配置
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage();
}
app.UseStaticFiles(); //静态文件服务
app.UseSwagger();
app.UseSwaggerUI(c =>
{
c.SwaggerEndpoint("/swagger/v1/swagger.json", "TwBusManagement API V1");
//c.ShowExtensions();
});
app.UseMvc();
}
第六步.在Properties下的launchSettings.json的文件中修改初始页面
然后运行就可以
如有问题,欢迎指正