语言运行时标准库JIT编译编译器【免费下载链接】runtime.NET is a cross-platform runtime for cloud, mobile, desktop, and IoT apps.项目地址https://gitcode.com/GitHub_Trending/runtime6/runtime点击查看免费下载导读本文围绕 .NET runtime 仓库中Microsoft.Extensions.Hosting.Abstractions程序集对应 NuGet 包Microsoft.Extensions.Hosting.Abstractions的官方包说明文档展开系统讲解 .NET 应用托管Hosting抽象层的核心设计BackgroundService基类与IHostedService接口如何承载后台任务IHostBuilder与IHost如何完成配置—装配—启动—停止的完整生命周期以及应用环境信息与生命周期通知Lifetime的获取方式。读者学完后将能独立基于这些抽象编写可长期运行、可优雅关停的 Worker 服务并理解 ASP.NET Core 等应用模型为何建立在托管之上。一、包定位托管抽象的最小公约数Microsoft.Extensions.Hosting.Abstractions是 .NET 托管体系的抽象层其源码位于仓库 src/libraries/Microsoft.Extensions.Hosting.Abstractions/src。包说明文档PACKAGE.md给出的定位十分明确它包含用于将用户代码托管在应用程序中的抽象核心职责是封装应用的资源与生命周期功能包括依赖注入Dependency Injection通过IServiceCollection/IServiceProvider完成服务装配与解析日志Logging通过ILoggingBuilder等类型接入日志体系配置Configuration通过IConfiguration抽象统一管理各类配置源启动、停止与通知获取Starting, stopping and obtaining notifications以宿主Host为单位编排应用的启动与关闭流程并通过生命周期事件通知外部。同时该包也被用于接线建立在托管之上的特定应用模型例如 ASP.NET Core——即文档中所说的This package is also used to wire up specific application models like ASP.NET Core that are built on top of hosting.这意味着抽象层与具体应用模型解耦任何应用控制台、服务、Web都可以共享同一套托管语义。二、核心功能全景根据 PACKAGE.md 的Key Features该包提供三大类能力提供BackgroundService基类与IHostedService接口用于实现 Worker 服务长期运行的后台任务提供用于配置并启动/停止宿主的接口即IHostBuilder、IHost及其配套扩展方法提供获取环境设置的类型如应用名称ApplicationName、内容根路径ContentRootPath等环境信息。下文将逐一展开并深入到仓库源码确认其实现细节。三、BackgroundService与IHostedServiceWorker 服务的两大支柱3.1 接口IHostedService托管服务的最小契约IHostedService定义了宿主管辖对象的最小契约源码位于 src/libraries/Microsoft.Extensions.Hosting.Abstractions/src/IHostedService.cspublic interface IHostedService { // 应用宿主准备好启动服务时触发cancellationToken 表示启动过程被中止 Task StartAsync(CancellationToken cancellationToken); // 应用宿主执行优雅关闭时触发cancellationToken 表示不再需要优雅关闭 Task StopAsync(CancellationToken cancellationToken); }它的关键语义是宿主的StartAsync会依次启动所有注册的IHostedService宿主的StopAsync会依次停止它们。任何希望跟随宿主生命周期运行的后台逻辑消息队列消费、定时任务、TCP 监听等都应实现该接口。3.2 基类BackgroundService一次实现ExecuteAsync即可直接实现IHostedService需要自行管理StartAsync/StopAsync与取消令牌绝大多数场景更推荐继承 BackgroundService.cs 中定义的抽象基类public abstract class BackgroundService : IHostedService, IDisposable { public virtual Task? ExecuteTask _executeTask; protected abstract Task ExecuteAsync(CancellationToken stoppingToken); public virtual Task StartAsync(CancellationToken cancellationToken) { /* ... */ } public virtual async Task StopAsync(CancellationToken cancellationToken) { /* ... */ } public virtual void Dispose() { /* ... */ } }基类把IHostedService的样板代码全部接管子类只需覆写ExecuteAsync。从源码可以清晰看到它的内部工作方式StartAsync调用CancellationTokenSource.CreateLinkedTokenSource(cancellationToken)创建链接触发令牌将传入的取消令牌与内部停止令牌关联随后通过Task.Run(() ExecuteAsync(stoppingToken), CancellationToken.None)异步启动后台执行并把任务存入_executeTask字段方法始终返回Task.CompletedTask——注释明确指出Any result from ExecuteAsync will be handled by the Host即ExecuteAsync中的异常由宿主统一处理避免启动流程被阻塞。StopAsync若从未调用过StartAsync_executeTask null则直接返回否则调用_stoppingCts!.Cancel()向正在运行的ExecuteAsync发送停止信号然后等待_executeTask完成。在 .NET 目标框架下使用_executeTask.WaitAsync(cancellationToken)实现等它结束或超时中止并指定ConfigureAwaitOptions.SuppressThrowing吞掉取消引发的异常在非 .NET 框架下则退化为Task.WhenAny(_executeTask, tcs.Task)的实现。Dispose取消_stoppingCts确保资源被释放。典型实现如下——一个每 5 秒输出一次日志的 Workerpublic sealed class TimedWorker : BackgroundService { private readonly ILoggerTimedWorker _logger; public TimedWorker(ILoggerTimedWorker logger) _logger logger; protected override async Task ExecuteAsync(CancellationToken stoppingToken) { while (!stoppingToken.IsCancellationRequested) { _logger.LogInformation(Worker running at: {time}, DateTimeOffset.Now); await Task.Delay(TimeSpan.FromSeconds(5), stoppingToken); } } }这里stoppingToken正是BackgroundService.StopAsync中_stoppingCts.Cancel()触发的那个令牌优雅关闭时循环会在延迟结束后退出。3.3 细粒度生命周期钩子IHostedLifecycleService如果需要在启动/停止前后插入额外逻辑IHostedLifecycleService提供了四个钩子源码见 src/libraries/Microsoft.Extensions.Hosting.Abstractions/src/IHostedLifecycleService.cspublic interface IHostedLifecycleService : IHostedService { Task StartingAsync(CancellationToken cancellationToken); // StartAsync 之前 Task StartedAsync(CancellationToken cancellationToken); // StartAsync 之后 Task StoppingAsync(CancellationToken cancellationToken); // StopAsync 之前 Task StoppedAsync(CancellationToken cancellationToken); // StopAsync 之后 }它继承自IHostedService宿主在遍历托管服务时会先检查服务是否实现了该接口从而提供更细的生命周期编排能力。四、宿主的配置、构建与启停IHostBuilder与IHost4.1IHostBuilder程序初始化抽象IHostBuilder.cs 定义了宿主构建抽象全部方法均返回IHostBuilder自身以支持链式调用方法职责Properties宿主构建过程中组件间共享状态的中央存储IDictionaryobject, objectConfigureHostConfiguration(ActionIConfigurationBuilder)配置宿主自身的配置用于初始化IHostEnvironment可多次调用结果累加ConfigureAppConfiguration(ActionHostBuilderContext, IConfigurationBuilder)配置应用与后续构建流程的配置结果可通过HostBuilderContext.Configuration与IHost.Services访问可多次调用结果累加ConfigureServices(ActionHostBuilderContext, IServiceCollection)向容器添加服务用于构造IServiceProvider可多次调用结果累加UseServiceProviderFactoryTContainerBuilder(IServiceProviderFactoryTContainerBuilder)替换默认的IServiceProvider工厂如接入 Autofac 等第三方容器UseServiceProviderFactoryTContainerBuilder(FuncHostBuilderContext, IServiceProviderFactoryTContainerBuilder)基于上下文的工厂重载默认实现抛NotSupportedException需要时由具体构建器覆写ConfigureContainerTContainerBuilder(ActionHostBuilderContext, TContainerBuilder)配置已实例化的依赖容器可多次调用结果累加Build()执行初始化动作构建宿主只能调用一次返回IHost4.2IHost程序抽象与运行扩展构建完成后得到 IHost.cspublic interface IHost : IDisposable { IServiceProvider Services { get; } // 程序配置的服务容器 Task StartAsync(CancellationToken cancellationToken default); // 启动所有 IHostedService Task StopAsync(CancellationToken cancellationToken default); // 优雅停止 }与之配套的 HostingAbstractionsHostExtensions.cs 提供了常用扩展Start()同步启动StartAsync().GetAwaiter().GetResult()StopAsync(TimeSpan timeout)带超时的优雅停止超时后允许终止剩余活动连接WaitForShutdown()/WaitForShutdownAsync(token)阻塞直到 CtrlC 或 SIGTERM 触发关闭内部从Services解析IHostApplicationLifetime将外部令牌注册到StopApplication()并等待ApplicationStopping信号后执行一次无取消令牌的StopAsync避免误触发强制中断Run()/RunAsync(token)StartAsync后WaitForShutdownAsync无论正常退出还是异常finally中都会释放宿主优先走IAsyncDisposable否则Dispose。一个最小控制台宿主示例using Microsoft.Extensions.DependencyInjection; using Microsoft.Extensions.Hosting; using IHost host Host.CreateDefaultBuilder(args) // Host 在 Microsoft.Extensions.Hosting 包中 .ConfigureServices(services services.AddHostedServiceTimedWorker()) .Build(); await host.RunAsync();五、环境设置IHostEnvironment与常用常量5.1IHostEnvironmentIHostEnvironment.cs 提供运行环境信息共四个属性public interface IHostEnvironment { string EnvironmentName { get; set; } // 环境名宿主自动从配置的 environment 键读取 string ApplicationName { get; set; } // 应用名宿主自动设为包含入口点的程序集名 string ContentRootPath { get; set; } // 应用内容文件所在目录的绝对路径 IFileProvider ContentRootFileProvider { get; set; } // 指向 ContentRootPath 的文件提供器 }5.2 常用环境名EnvironmentsEnvironments.cs 定义了三个约定俗成的环境名常量DevelopmentDevelopment可启用生产环境不应暴露的特性由于性能开销作用域校验scope validation与依赖校验仅在开发环境执行StagingStaging用于上线前验证应用变更ProductionProduction应配置为最大化安全、性能与健壮性。5.3 配置键常量HostDefaultsHostDefaults.cs 定义了宿主配置键ApplicationKey applicationName设置IHostEnvironment.ApplicationNameEnvironmentKey environment设置IHostEnvironment.EnvironmentNameContentRootKey contentRoot设置ContentRootPath与ContentRootFileProvider。这些常量说明环境名、应用名、内容根目录都可以通过宿主配置环境变量、命令行、配置文件等在启动阶段被覆盖。仓库中还提供 EnvironmentName.cs、HostEnvironmentEnvExtensions.cs 等辅助类型例如IsDevelopment()、IsProduction()这类环境判断扩展方法方便按环境差异化配置行为。六、生命周期通知IHostApplicationLifetime与IHostApplicationLifetime家族IHostApplicationLifetime.cs 允许消费方订阅应用生命周期事件接口注释明确说明它不打算被用户替换not intended to be user-replaceablepublic interface IHostApplicationLifetime { CancellationToken ApplicationStarted { get; } // 宿主完全启动、即将等待优雅关闭时触发 CancellationToken ApplicationStopping { get; } // 开始优雅关闭时触发仍有请求在途阻塞直到所有回调完成 CancellationToken ApplicationStopped { get; } // 优雅关闭完成时触发所有请求应已结束 void StopApplication(); // 请求终止当前应用 }典型用法在ApplicationStopping上注册回调执行关闭前的资源清理或调用StopApplication()主动请求进程退出。此外还有 IApplicationLifetime.cs旧的宿主生命周期接口与 IHostLifetime.cs负责监听外部关闭信号如 CtrlC/SIGTERM等配套抽象。七、托管服务的注册AddHostedService扩展ServiceCollectionHostedServiceExtensions.cs 提供IServiceCollection上的注册扩展services.AddHostedServiceTimedWorker(); // 按类型注册 services.AddHostedService(sp sp.GetRequiredServiceSomeService()); // 工厂方式注册源码实现细节值得注意内部通过services.TryAddEnumerable(ServiceDescriptor.SingletonIHostedService, THostedService())注册——只注册IHostedService这一抽象映射并不会把THostedService具体类型本身注册到容器注释明确提示If you want to register the actual type, you must do so separately需要时可单独services.AddSingletonSomeService()使用TryAddEnumerable意味着同一类型多次调用不会被重复注册保证宿主启动时每个服务只执行一次注册的托管服务以单例Singleton生命周期存在由宿主统一启停与释放泛型版本带有[DynamicallyAccessedMembers(DynamicallyAccessedMemberTypes.PublicConstructors)]特性配合裁剪Trimming与 AOT 场景保留公开构造函数便于依赖注入解析。八、现代托管入口IHostApplicationBuilder较新的托管体系还引入了 IHostApplicationBuilder.cs它把构建过程组织为可直接操作的对象集合适合在Microsoft.Extensions.Hosting等上层包中由Host.CreateApplicationBuilder()创建Properties构建期间共享状态ConfigurationIConfigurationManager可变配置集添加配置源会立即更新视图EnvironmentIHostEnvironment环境信息LoggingILoggingBuilder用于添加日志提供程序MetricsIMetricsBuilder启用指标并定向输出ServicesIServiceCollection组合用户与框架提供的服务ConfigureContainerTContainerBuilder(factory, configure)注入自定义容器工厂多次调用会替换先前存储的工厂与委托IServiceProvider在构建时才创建因此configure委托在所有服务注册完成后执行。九、包间关系与依赖方向PACKAGE.md 的Related Packages列出了与抽象层配套的包Microsoft.Extensions.Hosting通用宿主的实现包、Microsoft.Extensions.Configuration.Abstractions、Microsoft.Extensions.DependencyInjection.Abstractions、Microsoft.Extensions.Diagnostics.Abstractions、Microsoft.Extensions.FileProviders.Abstractions、Microsoft.Extensions.Logging.Abstractions。从仓库结构看这些依赖包均位于 src/libraries 下如 Microsoft.Extensions.Configuration.Abstractions、Microsoft.Extensions.DependencyInjection.Abstractions、Microsoft.Extensions.Logging.Abstractions它们为托管抽象提供配置、DI、日志等基础能力——抽象层只依赖这些Abstractions而非具体实现正是其可被任意应用模型复用的关键。更上层的实现位于 Microsoft.Extensions.Hosting 包如Host、HostBuilder、ConsoleLifetime等。十、实践建议与总结优先继承BackgroundService只需实现ExecuteAsync(CancellationToken stoppingToken)循环体务必检查stoppingToken.IsCancellationRequested并将令牌传给Task.Delay、ChannelReader.ReadAsync等可取消操作才能实现优雅停止。用IHostedLifecycleService处理前后置逻辑资源预热放在StartingAsync收尾清理放在StoppingAsync/StoppedAsync。借助IHostApplicationLifetime做全局通知在ApplicationStarted/ApplicationStopping上注册回调比在单个服务内自管状态更可靠。环境差异化配置通过HostDefaults.EnvironmentKeyenvironment配合Environments常量与IHostEnvironment扩展方法实现 Development/Staging/Production 三态隔离注意开发环境的依赖与作用域校验特性。宿主入口二选一经典IHostBuilder链式风格适合ConfigureAppConfiguration/ConfigureServices多次累加现代IHostApplicationBuilder适合直接操作Configuration/Services/Logging对象。理解注册语义AddHostedService只建立IHostedService映射具体类型需单独注册托管服务为单例由宿主统一管理生命周期。从抽象接口IHostedService、IHostBuilder、IHost到基类实现BackgroundService再到环境与生命周期通知IHostEnvironment、IHostApplicationLifetimeMicrosoft.Extensions.Hosting.Abstractions用最小的一组契约撑起了整个 .NET 托管生态。无论是写一个消息队列消费者还是构建 ASP.NET Core 应用理解这套抽象层都是深入 .NET 应用框架的必修课。赞分享语言运行时标准库JIT编译编译器【免费下载链接】runtime.NET is a cross-platform runtime for cloud, mobile, desktop, and IoT apps.项目地址https://gitcode.com/GitHub_Trending/runtime6/runtime点击查看免费下载相关推荐Temporal Worker Commands 机制深度解析基于 Nexus 的服务器到 Worker 命令通道Temporal Worker Commands 机制深度解析基于 Nexus 的服务器到 Worker 命令通道 Worker Commands 是 Tem后端工作流自动化任务调度Linera Controller 应用深度解析跨链 Worker 编排与分布式服务生命周期管理Linera Controller 应用深度解析跨链 Worker 编排与分布式服务生命周期管理 Controller 是 Linera 协议官方示例中用于区块链Web3Celery Loader 机制深度解析基于 celery.loaders.base 的配置加载、任务发现与生命周期钩子Celery Loader 机制深度解析基于 celery.loaders.base 的配置加载、任务发现与生命周期钩子 Celery 的 Loader加载任务调度后端消息队列创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考