HttpClientStudy/HttpClientStudy.WebClient/Program.cs

using System.Diagnostics;

using HttpClientStudy.Core.Utilities;

using Microsoft.OpenApi.Models;

//启动WebApi程序
AppUtility.StartWebApiProject();

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.

builder.Services.AddControllers();
// Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle
builder.Services.AddEndpointsApiExplorer();
//配置Swagger
builder.Services.AddSwaggerGen(setup =>
{
    #region 定义Swagger文档
    //name参数即为SwaggerUI中SwaggerEndpoint方法参数中的{documentName}
    //两者必须保持一致，否则异常
    setup.SwaggerDoc(name: "v1", new Microsoft.OpenApi.Models.OpenApiInfo { Title = "HttpClient学习", Version = "第1版" });
    #endregion

    #region 包含xml注释
    var xmlCommentFiles = System.IO.Directory.GetFiles(AppDomain.CurrentDomain.BaseDirectory, "HttpClientStudy.*.xml", System.IO.SearchOption.TopDirectoryOnly);
    foreach (var xmlFile in xmlCommentFiles)
    {
        //includeControllerXmlComments参数：是否启用控制器上的xml注释
        setup.IncludeXmlComments(filePath: xmlFile, includeControllerXmlComments: true);

        setup.UseInlineDefinitionsForEnums();
    }
    #endregion

    /*
    #region 放置接口Auth授权按钮

    setup.AddSecurityDefinition("Bearer", new OpenApiSecurityScheme
    {
        Description = "请输入带有Bearer的Token：Bearer {Token}",

        //jwt默认的参数名称
        Name = "Authorization",

        //jwt默认存放 Authorization 信息的位置：此处为请求头中
        In = ParameterLocation.Header,

        //验证类型：此处使用Api Key
        Type = SecuritySchemeType.ApiKey
    });
    
    #endregion

    #region 指定方案应用范围
    setup.AddSecurityRequirement(new OpenApiSecurityRequirement
    {
        {
            new OpenApiSecurityScheme
            {
                Reference = new OpenApiReference
                {
                    Id = "Bearer",
                    Type = ReferenceType.SecurityScheme
                }
            },
            new List<string>()
        }
    });
    #endregion
    */

    //启用数据注解
    setup.EnableAnnotations();
});

var app = builder.Build();

// Configure the HTTP request pipeline.
app.UseSwagger();
app.UseSwaggerUI(setup =>
{
    setup.EnableDeepLinking();
    setup.DisplayRequestDuration();
    setup.ShowCommonExtensions();
    setup.ShowExtensions();
    setup.EnableFilter();
});

app.UseAuthorization();

app.MapControllers();

#region 退出时，关闭WebAPI进程
/*
 * 1、退出执行机制，本身不太可靠，只有正常退出时才执行。
 * 2、正常退出，比如 ctl+c 操作
 * 3、非正常退出：比如 程序崩溃、内存泄漏、关闭进程，特别是调试WebAPI时，如果启动时打开了浏览器，则关闭浏览器时退出属于异常退出。
 */

// 获取 IHostApplicationLifetime 实例
var applicationLifetime = app.Services.GetRequiredService<IHostApplicationLifetime>();

// 注册应用程序停止事件：关闭WebApi
applicationLifetime.ApplicationStopping.Register(() =>
{
    //注意：在 Visual Studio 2022 预览版中，执行时异常；正式版中正常。应该是预案版的Bug
    AppUtility.ExitWebApiProject();
});

applicationLifetime.ApplicationStopped.Register(() =>
{
    Console.WriteLine("程序已停止");
});

#endregion

//默认Swagger页
app.Map("/", async context =>
{
    context.Response.Redirect($"{context.Request.PathBase}/swagger/index.html");

    await Task.CompletedTask;
});

app.Run();