- A+
自从.NET 6 开始,微软对应用的入口文件进行了调整,移除了 Main 方法和 Startup 文件,使用顶级语句的写法,将应用初始化的相关配置和操作全部集中在 Program.cs 文件中,如下:
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(); builder.Services.AddSwaggerGen(); var app = builder.Build(); // Configure the HTTP request pipeline. if (app.Environment.IsDevelopment()) { app.UseSwagger(); app.UseSwaggerUI(); } app.UseAuthorization(); app.MapControllers(); app.Run();
关于顶级语句语法的规范,大家可以通过官方文档了解一下:顶级语句。这种改变怎么说呢,我自己是挺不习惯的,虽然这种方式更加简洁,但是过于简洁也容易让人一脸懵,还是觉得之前的Startup文件的方式根据逻辑清晰一点,也更能做到关注点分离。
.NET 6 下应用的构建有了一些区别,不再直接使用原来的 Host 进行配置构建,而是通过 WebApplication 的静态方法构建 WebApplicationBuilder 来对主机进行配置,其实内部是 BootstrapHostBuilder 来进行的,调用 BootstrapHostBuilder 的相关配置方法时,只是将委托保存起来,之后还是通过 HostingBuilder 来进行配置。
调用 Builder 生成 WebApplication 对象时,还是以前配置主机的那些操作,传递给 WebApplication 的也是 IHost 对象。
而最终调用 WebApplication 对象的 Run 方法启动应用时,也是调用了主机的 StartAsync 方法,只是进行了一层包装,微软团队这样处理的好处暂时还不能很好得体会到。但总的来说改变也不大,虽然没了Startup类,但整体框架的基本模型并没有改变,之前能够在 Startup 中拿到的东西,在现在的入口文件中依旧可以拿到,我们依旧可以自由地控制整个请求管道,把握整体应用生命周期行为。
以下是 WebApplicationBuilder 对象 builder 张包含的几个关键实例
// builder 中可以获取到的几个关键实例 // 依赖注入容器 IServiceCollection service = builder.Services; // 配置 IConfiguration configuration = builder.Configuration; // 日志 ILoggingBuilder loggingBuilder = builder.Logging; // 主机 IHostBuilder host = builder.Host; IWebHostBuilder webHost = builder.WebHost; // 环境 IWebHostEnvironment env = builder.Environment;
现在的依赖注入配置,直接通过 builder.services进行配置即可
// 依赖注入,相当于 Startup 中的ConfigureService方法 builder.Services.AddControllers(); // Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle builder.Services.AddEndpointsApiExplorer(); builder.Services.AddSwaggerGen();
日志驱动配置:
// 日志提供程序配置,相当于之前主机中的 hostBuilder.ConfigureLogging builder.Logging.AddConsole().AddDebug();
以下是 WebApplication 对象 app 中包含的几个关键实例
// app 中包含的几个关键实例 // 环境 IWebHostEnvironment enviroment = app.Environment; // 配置 IConfiguration config = app.Configuration; // 应用生命周期 IHostApplicationLifetime lifetime = app.Lifetime; // 日志记录器 ILogger logger = app.Logger; // 容器解析器 IServiceProvider serviceProvider = app.Services;
在执行完成 builder.Build(); 之后,应用已经初始化了依赖注入容器,所以我们可以通过 app.services获取我们需要的实例。
// 通过容器获取实例 var conf = app.Services.GetRequiredService<IConfiguration>();
当然,在 builder.Build(); 再通过builder.services 往容器中配置依赖注入关系是没有用的了,会抛出无效操作异常,因为容器已经创建,无法再修改。
根据顶级语句语法,顶级语句文件中存在隐式 using 指令, 但如果我们需要在 Program.cs 文件中额外引入一些命名空间也是可以的,using语句需要在文件的最前面,也可以定义方法或者类,只不过需要在顶级语句的后面,也可以使用异步方法。
参考文章:
ASP.NET Core 系列:
目录:ASP.NET Core 系列总结
上一篇:ASP.NET Core - IStartupFilter 与 IHostingStartup
下一篇:ASP.NET Core - 请求管道与中间件