.NET 7 中的 HostApplicationBuilder

.NET 7 Preview 3 引入的 HostApplicationBuilder

Intro

在 .NET 6 中,ASP.NET Core 引入了 Minimal API,对于简单的应用使用 Minimal API 我们可以使用非常精简的代码来实现我们的 API,在 .NET 7 Preview 3 中,引入了一个 HostApplicationBuilder ,我们使用普通的 Host 也可以使用 Minimal API 的方式来配置 Host 的 Logging/Configuration/Services等,下面我们来看一下如何使用吧

Sample

首先为可能不熟悉 Minimal API 使用的童鞋看一下 Minimal API 的简单使用:

var builder = WebApplication.CreateBuilder(args);builder.Logging.AddJsonConsole(options =>
{options.JsonWriterOptions = new JsonWriterOptions{// https://docs.microsoft.com/en-us/dotnet/standard/serialization/system-text-json-character-encoding?WT.mc_id=DT-MVP-5004222Encoder = JavaScriptEncoder.UnsafeRelaxedJsonEscaping};
});builder.Services.AddDbContextPool<SparkTodoDbContext>(options => options.UseInMemoryDatabase("SparkTodo"));var app = builder.Build();app.Map("/health", ()=> "Healthy");await app.RunAsync();

Minimal API 中的 Logging/Configuration/Services 相对来说更为简单一些,更多可以参考之前的一个 Todo 示例:Minimal API Todo Sample

HostApplicationBuilder 使得我们也可以使用这样的配置方式,示例如下:

var builder = Host.CreateApplicationBuilder();builder.Logging.AddJsonConsole(config =>
{config.UseUtcTimestamp = true;config.TimestampFormat = "yyyy-MM-dd HH:mm:ss.fff";config.JsonWriterOptions = new System.Text.Json.JsonWriterOptions(){Encoder = System.Text.Encodings.Web.JavaScriptEncoder.UnsafeRelaxedJsonEscaping,Indented = true};
});builder.Configuration.AddJsonFile("env.json", true);builder.Services.AddHostedService<TestHostedService>();var host = builder.Build();
await host.StartAsync();

上面的 TestHostedService 是一个简单的每秒输出一下当前时间的后台任务, 使用 .NET 6 引入的 PeriodicTimer,实现如下:

private sealed class TestHostedService : BackgroundService
{protected async override Task ExecuteAsync(CancellationToken stoppingToken){using var timer = new PeriodicTimer(TimeSpan.FromSeconds(1));while (await timer.WaitForNextTickAsync(stoppingToken)){Console.WriteLine($"{DateTime.Now}");}}
}

示例运行效果如下:

4f12be9516d008fdcd88854e432e5fd1.png

Inside

内部是怎么实现的呢?我们可以使用 Host.CreateApplicationBuilder() 也可以使用 new HostApplicationBuilder() 来创建

在创建的时候我们可以指定一个 HostApplicationBuilderSettings 来初始化 Host 的一些配置

Host.CreateApplicationBuilder() 实现如下:

public static HostApplicationBuilder CreateApplicationBuilder() => new HostApplicationBuilder();public static HostApplicationBuilder CreateApplicationBuilder(string[]? args) => new HostApplicationBuilder(args);

Host.CreateApplicationBuilder()Host.CreateDefaultBuilder() 的行为保持一致,也会加载默认 DOTNET_ 环境变量作为 Host Configuration 以及加载 appsettings.json 环境变量、 注册 Logging 等,详细可以参考:https://github.com/dotnet/runtime/blob/0e84780fd2280166cd82374c770177613527f06b/src/libraries/Microsoft.Extensions.Hosting/src/HostingHostBuilderExtensions.cs

HostApplicationBuilder 有三个构造方法

public sealed class HostApplicationBuilder
{private readonly HostBuilderContext _hostBuilderContext;private readonly ServiceCollection _serviceCollection = new();private Func<IServiceProvider> _createServiceProvider;private Action<object> _configureContainer = _ => { };private HostBuilderAdapter? _hostBuilderAdapter;private IServiceProvider? _appServices;private bool _hostBuilt;public HostApplicationBuilder(): this(args: null){}public HostApplicationBuilder(string[]? args): this(new HostApplicationBuilderSettings { Args = args }){}public HostApplicationBuilder(HostApplicationBuilderSettings? settings){// ...}
}

由于代码过多,这里不贴太多具体实现的代码,感兴趣的可以看源码实现 https://github.com/dotnet/runtime/blob/main/src/libraries/Microsoft.Extensions.Hosting/src/HostApplicationBuilder.cs

可以看到上面的代码中,会有一个 HostApplicationBuilderSettings 来决定 Host 的构建行为,我们来看一下它的源码

public sealed class HostApplicationBuilderSettings
{public bool DisableDefaults { get; set; }public string[]? Args { get; set; }public ConfigurationManager? Configuration { get; set; }public string? EnvironmentName { get; set; }public string? ApplicationName { get; set; }public string? ContentRootPath { get; set; }
}

除了 HostingEnvironment 相关的参数之外,增加了 DisableDefault/Args/Configuration 三个参数

  • DisableDefaults 前面我们提到 Host.CreateApplicationBuilder 会和 Host.CreateDefaultBuilder 的行为保持一致,这样提供了一个可以禁用默认配置的选项

  • Args 是从命令行获取到的参数,会作为默认的一个配置源,当然只有 DisableDefaultsfalse 时才会生效

  • Configuration 使得我们可以使用一个已有的配置信息

构造方法里的主要实现如下:

settings ??= new HostApplicationBuilderSettings();
Configuration = settings.Configuration ?? new ConfigurationManager();if (!settings.DisableDefaults)
{HostingHostBuilderExtensions.ApplyDefaultHostConfiguration(Configuration, settings.Args);
}// HostApplicationBuilderSettings override all other config sources.
List<KeyValuePair<string, string?>>? optionList = null;
if (settings.ApplicationName is not null)
{optionList ??= new List<KeyValuePair<string, string?>>();optionList.Add(new KeyValuePair<string, string?>(HostDefaults.ApplicationKey, settings.ApplicationName));
}
if (settings.EnvironmentName is not null)
{optionList ??= new List<KeyValuePair<string, string?>>();optionList.Add(new KeyValuePair<string, string?>(HostDefaults.EnvironmentKey, settings.EnvironmentName));
}
if (settings.ContentRootPath is not null)
{optionList ??= new List<KeyValuePair<string, string?>>();optionList.Add(new KeyValuePair<string, string?>(HostDefaults.ContentRootKey, settings.ContentRootPath));
}
if (optionList is not null)
{Configuration.AddInMemoryCollection(optionList);
}(HostingEnvironment hostingEnvironment, PhysicalFileProvider physicalFileProvider) = HostBuilder.CreateHostingEnvironment(Configuration);Configuration.SetFileProvider(physicalFileProvider);_hostBuilderContext = new HostBuilderContext(new Dictionary<object, object>())
{HostingEnvironment = hostingEnvironment,Configuration = Configuration,
};Environment = hostingEnvironment;HostBuilder.PopulateServiceCollection(Services,_hostBuilderContext,hostingEnvironment,physicalFileProvider,Configuration,() => _appServices!);Logging = new LoggingBuilder(Services);ServiceProviderOptions? serviceProviderOptions = null;if (!settings.DisableDefaults)
{HostingHostBuilderExtensions.ApplyDefaultAppConfiguration(_hostBuilderContext, Configuration, settings.Args);HostingHostBuilderExtensions.AddDefaultServices(_hostBuilderContext, Services);serviceProviderOptions = HostingHostBuilderExtensions.CreateDefaultServiceProviderOptions(_hostBuilderContext);
}_createServiceProvider = () =>
{_configureContainer(Services);return serviceProviderOptions is null ? Services.BuildServiceProvider() : Services.BuildServiceProvider(serviceProviderOptions);
};

从这里可以比较清晰的看得出来前面 HostApplicationBuilderSettings 中的参数的使用了

More

在新版本 Minimal API 中的 WebApplicationBuilder 内部也使用了 HostApplicationBuilder 来重构之前的实现,感兴趣的童鞋可以看一下 https://github.com/dotnet/aspnetcore/blob/main/src/DefaultBuilder/src/WebApplicationBuilder.cs

9204cd009bce36fdaedef612ac6f4dc4.png

更多细节可以参考文末给出的源码链接

References

  • https://github.com/dotnet/runtime/blob/main/src/libraries/Microsoft.Extensions.Hosting/src/HostApplicationBuilder.cs

  • https://github.com/dotnet/runtime/blob/main/src/libraries/Microsoft.Extensions.Hosting/src/HostApplicationBuilderSettings.cs

  • https://github.com/dotnet/runtime/blob/main/src/libraries/Microsoft.Extensions.Hosting/src/Host.cs

  • https://github.com/dotnet/runtime/blob/0e84780fd2280166cd82374c770177613527f06b/src/libraries/Microsoft.Extensions.Hosting/src/HostingHostBuilderExtensions.cs

  • https://github.com/dotnet/runtime/blob/9299bc47f060b822807a88f729b5c1944104417a/src/libraries/Microsoft.Extensions.Hosting/src/HostBuilder.cs

  • https://github.com/dotnet/aspnetcore/blob/main/src/DefaultBuilder/src/WebApplicationBuilder.cs

  • https://github.com/WeihanLi/SamplesInPractice/blob/master/net7Sample/Net7Sample/HostApplicationBuilderSample.cs

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/288163.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

SQL Server 2008 R2 Developer Edition图文安装教程

本文主要以截图的方式,详细说明SQL Server 2008 R2 Developer Edition的安装过程。 1、双击安装包中的setup.exe,如下图,点击“安装”→“全新安装或现有安装添加功能”。 2、点击“确定”。 3、点击“下一步”。

新款ATM恶意软件Alice 可对抗动态分析 但目前需要物理接触主机

趋势科技&#xff08;Trend Micro&#xff09;安全公司的研究人员警告称&#xff0c;新发现的恶意软件家族主要针对ATM机&#xff08;自动取款机&#xff09;&#xff0c;唯一目的就是要掏空ATM机保险箱里的现金。 alice软件是什么 这款恶意软件被称为“Alice”&#xff0c;是迄…

(下)python3 selenium3 从框架实现代码学习selenium让你事半功倍

上一篇博文简要 在上一篇博文中已得知&#xff1a;使用 execute 向远程服务器发送请求会通过 webdriver 与浏览器交互&#xff0c;且发送已定义的命令常量可获得一些相关信息。 其中 execute 方法实现已经在上一篇博文中有实现说明。并且在我们已经知道 webdriver基类&#x…

【空间数据库技术】ArcSDE 10.1安装配置与企业级地理空间数据库的建立及连接

1、工具: (1)ArcGIS Desktop 10.1 (2)SQL Server 2008 R2 (3)ArcSDE 10.1 2、安装过程 (1)ArcGIS Desktop 10.1的安装 请参照:ArcGIS 10.2 Desktop完全破解图文安装教程 (2)SQL Server 2008 R2的安装 请参照:SQL Server 2008 R2 Developer Edition图文安装教…

点对点 客户端-服务器 聊天程序

服务器&#xff0c;客户端都是父进程、子进程分别负责发送、接收字符串。 另外使用了信号函数来发送和接收处理信号&#xff0c;比如当子进程结束时&#xff0c;传递一个信号给父进程&#xff0c;然后父进程会执行信号处理函数。 服务器端&#xff1a; 1 #include<stdio.h&g…

C# 使用压缩流和 Brotli

如前所述&#xff0c;流的一个特性是可以将它们链接起来。为了压缩流&#xff0c;只需要创建 DeflateStream&#xff0c;并给构造函数传递另一个流(在这个例子中&#xff0c;是写入文件的outputStream)&#xff0c;使用 CompressionMode. Compress 表示压缩。使用 Write方法或其…

高考610考哪个计算机学校,2019年高考成绩610分_615分左右能报考上什么学校 文科理科大学名单推荐...

一眨眼&#xff0c;高考已经结束一段时间了&#xff1b;早晨猛地一睁眼&#xff0c;还在抱怨妈妈怎么不叫你起床&#xff0c;才突然发现今天你已经不用去学校了,这场全国性的考试高考已经结束了&#xff1b;高考这个城门攻破之后&#xff0c;还有大把壁垒再等你去攻克&#xff…

Power的力量

ZD至顶网服务器频道 08月26日 新闻消息&#xff08;文/董培欣&#xff09;&#xff1a;谈到企业级服务器市场&#xff0c;人们首先想到的会是x86 E5、E7系列的CPU产品&#xff0c;IBM在企业级市场推出的Power Systems服务器产品很少会被用户了解。可是在今年春天举行的OpenPOWE…

C#语法糖系列 —— 第三篇:聊聊闭包的底层玩法

有朋友好奇为什么将 闭包 归于语法糖&#xff0c;这里简单声明下&#xff0c;C# 中的所有闭包最终都会归结于 类 和 方法&#xff0c;为什么这么说&#xff0c;因为 C# 的基因就已经决定了&#xff0c;如果大家了解 CLR 的话应该知道&#xff0c; C#中的类最终都会用 MethodTab…

空间数据库Spatial Tools的使用

工具下载:http://www.sharpgis.net/page/SQL-Server-2008-Spatial-Tools 该工具为绿色版,点击即可使用。 1、导入Shapefile数据 双击“Shape2Sql.exe”,打开界面如下: 2、查询空间数据 双击打开“SqlSpatial.exe”

自定义View 进度条

1.在values下面新建一个attrs.xml&#xff0c;现在里面定义我们的自定义属性&#xff0c; <?xml version"1.0" encoding"utf-8"?> <resources><declare-styleable name"RoundProgressBar"><attr name"roundColor&qu…

python图形绘制库turtle中文开发文档及示例大全【最详细、连结果图都有,gif格式的!】

前言 本文参考&#xff1a;Python库官方文档 本文例子摘抄自Python库官方文档&#xff0c;为了方便讲解&#xff0c;个人进行了修改&#xff0c;并且相关函数说明不完全参照文档&#xff0c;在结果处贴出了执行结果&#xff0c;不方便用jpg等图片作为展示的用了gif格式图片进行…

oracle 事务_从Oracle到PG-PostgreSQL的MVCC机制简介

作者&#xff1a;甘植恳-AkenPostgreSQL和Oracle、MySQL等RDBMS一样&#xff0c;都有自己的并发控制机制。而并发控制的目的是为了在多个事务同时运行时保持事务ACID属性。MVCC即Multi-version concurrence control首字母缩写&#xff0c;MVCC会为每个数据更改操作创建数据块或…

【Microstation】不能从对话框中装载/创建类型为 ‘HTML‘,id =41510001 的对话框条目,该对话框为: “文本编辑器 - 字处理器“,GCSDIALOG 已装载。

在Win7上安装MicroStation V8i简体中文版,在添加文字图层的时候,点击出现提示“不能从对话框中装载/创建类型为 HTML,id =41510001 的对话框条目,该对话框为: "文本编辑器 - 字处理器",GCSDIALOG 已装载。”,问题出在Win7对该软件的兼容性上。 MS软件提供了三种…

fastdfs 一个group内实现按照不同的项目,指定路径存储.

为什么80%的码农都做不了架构师&#xff1f;>>> 环境介绍: 1: 公司目前有5个项目 A B C D E 日后可能会有所增加. 2: 使用fastdfs存储这5各项目的文件,要求各各项目的文件分开存储,也就是每个项目的文件存储到一个固定的位置. 3: 三台机器ip地址分配如下 tracker…

一个WPF开发的打印对话框-PrintDialogX

今天五月一号&#xff0c;大家玩的开心哦。1. 介绍今天介绍一个WPF开发的打印对话框开源项目-PrintDialogX[1]&#xff0c;该开源项目由《WPF开源项目&#xff1a;AIStudio.Wpf.AClient》[2]作者推荐。欢迎使用 PrintDialogX, 这是一个开源项目。免费用于商业用途。用于 C# 的自…

这一新的可视化方法教你优雅地探索相关性

一个古老的诅咒一直萦绕着数据分析&#xff1a;我们用来改进模型的变量越多&#xff0c;那么我们需要的数据就会出现指数级的增长。不过&#xff0c;我们通过关注重要的变量就可以避免欠拟合以及降低收集大量数据的需求。减少输入变量的一种方法是鉴别其对输出变量的影响。变量…

【新手宝典】一篇博文带萌新建站并了解建站体系流程和对萌新友好的便捷方式,这篇博文很有可能是你的启蒙文

前言 本片博文主要面向于还没接触过web开发的萌新&#xff0c;以及想知道整体流程并且完成建站的萌新&#xff1b;如果你是个大佬&#xff0c;就没必要看下去了。 本篇博文没有难啃的骨头&#xff0c;请各位萌新放心食用。 本篇博文采用通俗易懂的方式讲解&#xff0c;轻松并…

MicroStation V8i简体中文版中文字体乱码解决办法

Bentley (奔特力)是一家软件研发公司,其核心业务是满足负责建造和管理全球基础设施,包括公路、桥梁、机场、摩天大楼、工业厂房和电厂以及公用事业网络等领域专业人士的需求。Bentley 在基础设施资产的整个生命周期内针对不同的职业,包括工程师、建筑师、规划师、承包商、…

惠普ProDesk行业专用台式机U盘不识别解决办法

惠普ProDesk行业专用台式机在使用的过程当中&#xff0c;老出现插入U盘不识别的问题&#xff0c;总是需要在重启的过程中插入U盘才能使用U盘&#xff0c;解决办法是&#xff1a;&#xff08;1&#xff09;打开设备管理器&#xff0c;如下图所示&#xff1a;&#xff08;2&#…