.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、点击“下一步”。

计算机应用基础851,最新2020秋广东开放大学计算机应用基础本科上传资料作业2文档(2页)-原创力文档...

Sheet2sheet1姓名迟春艳宋灵辉任慧霞张玉鹏李卫东付祖荣焦中明杨丹妍张积盛王继锋王永隆陶春光刘炳光吕秀涛赵业绵齐晓鹏王晶晶张秀双姜殿琴车延波闫少林李安娜盖玉艳王建东于玲云周琳娜王瑞欣学生成绩表期中成绩期末成绩总成绩籍贯陕西江西河北山东湖南广东上海辽宁北京湖北山…

复利计算评价博客

评价&#xff1a; 201406114202 蔡彩虹&#xff08;1&#xff09; http://www.cnblogs.com/caicaihong/p/5393335.html 201406114207 甘佳萍&#xff08;2&#xff09; http://www.cnblogs.com/gjpg/p/5393501.html 201406114239 赖文亮&#xff08;3&#xff09; http://www.c…

地理模块化施工的优点_模块化建筑适合学校的6个原因

原标题&#xff1a;模块化建筑适合学校的6个原因我们正处于模块化建筑的新时代&#xff0c;学校建筑能从这种创新和有效的建筑方法中受益。最先进的工厂制造——减少制造时间; 提高施工质量; 更具环境可持续性; 减少现场工作和干扰学校的正常作息; 同时在项目期间提供更好的健康…

新款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…

剑指offer之翻转单词顺序

1 题目 输入一个英文橘子&#xff0c;翻转句子中的单词顺序&#xff0c;但是单词内字符串的顺序不变&#xff0c;简单起见&#xff0c;标点符号和普通字符字母一样处理&#xff0c;例如输入字符串"I am a student.",则输出"student. a am I" 2 思路 先…

【空间数据库技术】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…

PHP中的include、include_once、require、require_once

include、include_once()、require、require_once() 作用&#xff1a; 通过 include 或 require 语句&#xff0c;可以将 PHP 文件的内容插入另一个 PHP 文件&#xff08;在服务器执行它之前&#xff09;&#xff0c;减少代码的重复。 区别&#xff1a; 当要加载的文件不存在时…

(创建模式 上)设计模式——工厂、抽象工厂 C++/Python3实现

简介 设计模式是为了解决一些出现的问题设计的解决方案。是长时间经验的总结&#xff0c;是根据不同问题从而提出并且实践出来的解决办法。使用不同的设计模式可以解决不同的问题。 设计模式可以分为三种大类别&#xff1a;分别是创建型模式、结构型模式、行为型模式。 在开发…

剑指offer之左旋转字符串

1 题目 字符串的左旋转操作是把字符串前面的若干字符转移到字符串尾部&#xff0c;比如字符串abcdef和数字2,函数返回左旋转得到的结果是cdefgab 2 思路 先反转字符串所有&#xff0c;通过数字n找到的边界 ,然后再反转字符串部分左边和部分右边。 3 代码实现 #include <s…

如何科学的组织React组件样式

React的组件式开发&#xff0c;让我们可以利用其Component Model&#xff0c;专注于单个组件的逻辑开发&#xff0c;其中还包括组织组件的样式。先声明&#xff0c;本文并不是webpack配置教程&#xff0c;不会介绍详细的配置过程&#xff0c;假设你们已经用过了css-loader styl…

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”

IBM与博世合作打造轻松的工业物联网

计算业巨头c公司和物联网技术提供商博世集团&#xff08;Bosch Group&#xff09;宣布达成合作&#xff0c;让客户的开发和运营团队更轻松地管理物联网设备。 作为合作的一部分&#xff0c;博世将在IBM Bluemix云计算服务中提供Bosch物联网套件&#xff0c;并与IBM Watson物联网…

自定义View 进度条

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