通过NuGet package管理器或者命令行安装
PM> install-package NSwag.AspNetCore
using NJsonSchema;
using NSwag.AspNetCore;
using System.Reflection;
public void ConfigureServices(IServiceCollection services)
{
services.AddMvc();
//注册NSwag服务
services.AddSwaggerDocument(config =>
{
config.Version = "v1";
config.Title = "My API";
config.Description = "API description";
});
}
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
app.UseMvc();
//配置Swagger UI
app.UseSwaggerUi3(config =>
{
config.DocExpansion = "list";
config.SwaggerUiRoute = "/swagger";
});
//生成Swagger JSON文件
app.UseSwagger(config =>
{
config.PostProcess = document =>
{
document.Info.Version = "v1";
document.Info.Title = "My API";
document.Info.Description = "API description";
};
});
}
这将在每次构建时自动运行NSwag生成器,生成JSON文件和C#控制器代码。
以上是如何使用ASP.NET和NSwag在一次构建中生成模型和控制器的示例,可以根据具体的需求进行相应的修改和调整。