ASP.NET Core 项目实战（Swagger配置）

二级标题

1. nuGet 添加 Swagge
   2.项目目录 右键-》属性-》生成-》输出 勾选xml 文档
   3.Program.cs 文件中配置

var ApiName = "XXX.API";
builder.Services.AddSwaggerGen(c =>
{
    c.SwaggerDoc("v1", new Microsoft.OpenApi.Models.OpenApiInfo
    {
        Version = "V1",
        Title = $"{ApiName} 接口文档——Netcore 8.0",
        Description = $"{ApiName} HTTP API V1",
    });
    c.OrderActionsBy(o => o.RelativePath);
    // 为 Swagger JSON and UI设置xml文档注释路径
    var basePath = Path.GetDirectoryName(AppContext.BaseDirectory);
    var xmlFile = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml";
    var xmlPath = Path.Combine(basePath, xmlFile);
    c.IncludeXmlComments(xmlPath);
});
// 数据库依赖注入
builder.Services.AddDbContext<AppDbContext>(options =>
{
    options.UseSqlServer(builder.Configuration["DbContext:ConnectionString"]);
});
// 实现依赖注入
builder.Services.AddTransient<ITouristRouteRepository, TouristRouteRepository>();

app.UseSwaggerUI(c =>
{
    c.SwaggerEndpoint($"/swagger/v1/swagger.json", "WebApi.Core V1");
    //路径配置，设置为空，表示直接在根域名（localhost:8001）访问该文件,注意localhost:8001/swagger是访问不到的，去launchSettings.json把launchUrl去掉，如果你想换一个路径，直接写名字即可，比如直接写
    c.RoutePrefix = "doc";
    c.RoutePrefix = string.Empty;
});

数据配置

1.appsettings.json

"DbContext": {
  "ConnectionString": "server=数据库地址;Database=数据库名;User Id=用户名;Password=密码;Encrypt=False;"
},
"Authentication": {
  "SecretKey": "suibianzifuchaun",
  "Issuer": "xxx.com",
  "Audience": "xxx.com"
}