本文是“项目框架构建”系列之6，本文介绍如何编写通用主机基础类。

1.为了构建通用主机，我们先创建主机接口IAppHost接口

接口需要有配置项，我们定义为HostConfiguration，比如我们希望用户可以设定他的工作目录，就可以放在这里

接口需要有加载的.json的应用程序配置IConfiguration对象
接口还需要有服务管理器IServiceProvider对象
以及接口需要有日志管理ILoggerManager对象

2.构建主机，需要执行方法，所以我们添加了Build()和Run()两个方法
Build()方法是为了生成主机，这是必要方法。
Run()方法是为了启动应用程序，但这并不是必要的，因为主机生成后，您本身可以随时随地去启动你的程序。

3.生命周期以及事件

像主机这种底层结构，为了兼顾扩展性，我们需要提供周期的事件，以便让用户在启动的时候进行参与。

本程序抛砖引玉，提供了4个事件：
HostConfiguring：正在配置IConfiguration中，您可以继续加入其它初始化工作，如加载其它的.json文件
HostConfigurationInitialized：主机的配置已完成且抽象接口IConfiguration已构建
HostServicesInitializing：主机正在构建服务中，您可以继续加入其它服务一起构建
HostReady：主机构建完成已准备就绪

4.扩展依赖注入

为了防止重复添加服务，我们还需要扩展新增一些方法，用于防止重复添加服务。

5.扩展appsettings.cs文件的内容更改

程序运行后，有时可能需要在运行中修改appsettings.json中的配置，但IConfiguration本身不带有这种功能，所以我们需要自行编写扩展

6.编写主机接口IAppHost的抽象实现

我们是通用框架项目，所以需要提供一个抽象的基础实现，依据之前的设计，我们实现它的方法、事件、属性。

我们限定构造函数

程序初始化，初始化应用程序配置以及基础服务

编写Build()方法实现主机的生成

由于Run()函数不是必须的，所以我们把它定义为虚方法

 

下面通过编写事件的虚方法，以便子类能够参与过程

最后，附上完整的主机项目结构图：

也许各位朋友会想要源码，不要慌，等系列文章差不多了后，会开放源码下载。现在也没多少代码，没啥看头的。

下面附上IAppHost的具体实现：

using System;
using System.IO;
using Xejen.Hosting.Extensions;
using Xejen.Logger;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Logging;namespace Xejen.Hosting
{/// <summary>/// <inheritdoc cref="IAppHost"/>基类 /// </summary>/// <creator>marc</creator>public abstract class AppHostBase : IAppHost{private readonly ILogger _logger;private readonly ILoggerManager _loggerManager;/// <inheritdoc cref="ILogger"/>protected ILogger Logger => _logger;/// <summary>/// 服务列表/// </summary>internal IServiceCollection Services;/// <inheritdoc cref="HostConfiguration"/>public HostConfiguration HostConfig { get; private set; }/// <inheritdoc/>public IConfiguration Configuration { get; private set; }/// <inheritdoc/>public IServiceProvider ServiceProvider { get; private set; }/// <inheritdoc/>public ILoggerManager LoggerManager => _loggerManager;/// <inheritdoc/>public event EventHandler<IConfigurationBuilder> HostConfiguring;/// <inheritdoc/>public event EventHandler<IConfiguration> HostConfigurationInitialized;/// <inheritdoc/>public event EventHandler<IServiceCollection> HostServicesInitializing;/// <inheritdoc/>public event EventHandler HostReady;/// <inheritdoc cref="AppHostBase"/>/// <param name="args">启动参数</param>/// <param name="loggerManager">采用的日志方式</param>protected AppHostBase(string[] args, ILoggerManager loggerManager) : this(loggerManager){HostConfig = HostConfiguration.Load(args);Initialize();}/// <summary>/// 将 ILoggerManager 添加到构造函数中/// </summary>/// <param name="loggerManager"><inheritdoc cref="ILoggerManager" path="/summary"/></param>private AppHostBase(ILoggerManager loggerManager){Check.NotNull(loggerManager, nameof(loggerManager));_loggerManager = loggerManager;_logger = _loggerManager.CreateLogger(typeof(AppHostBase));}/// <inheritdoc cref="AppHostBase"/>/// <param name="configuration"><inheritdoc cref="HostConfiguration" path="/summary"/></param>/// <param name="loggerManager"><inheritdoc cref="ILoggerManager" path="/summary"/></param>protected AppHostBase(HostConfiguration configuration, ILoggerManager loggerManager) : this(loggerManager){Check.NotNull(configuration, nameof(configuration));HostConfig = configuration;Initialize();}private void Initialize(){_logger.LogInformation($"应用程始启动，开始初始化");InitializeConfiguration(HostConfig.ConfigDirectory);InitializeServices();}/// <inheritdoc/>public IAppHost Build(){ConfigureServices(Services);ServiceProvider = Services.BuildServiceProvider();_logger.LogInformation($"服务初始化完毕，共 {Services.Count} 项服务");_logger.LogInformation($"程序初始化完毕");OnHostReady(this);return this;}/// <inheritdoc/>public virtual void Run() { }private void InitializeConfiguration(string configDirectory){_logger.LogInformation($"准备加载配置文件");if (string.IsNullOrEmpty(configDirectory)){configDirectory = AppDomain.CurrentDomain.BaseDirectory;}string appsettingFileName = HostConfig.DefaultSettingsFileName;if (!File.Exists(Path.Combine(configDirectory, appsettingFileName))){throw new FileNotFoundException($"未找到 {appsettingFileName} 文件，查找目录在：\r\n{configDirectory}");}var builder = new ConfigurationBuilder().SetBasePath(configDirectory).AddJsonFile(appsettingFileName, optional: true, reloadOnChange: true);ConfigureJsonFiles(builder);OnHostConfiguring(this, builder);Configuration = builder.Build();OnHostConfigurationInitialized(this, Configuration);_logger.LogInformation($"配置文件加载完成，工作目录： {configDirectory}");}/// <summary>/// 配置json文件，基类已自动完成<see langword="appsettings.json"/>文件的加载，您只需加载您其它的配置文件即可/// </summary>/// <param name="configuration">传入过来的<see cref="IConfigurationBuilder"/>接口对象</param>protected virtual void ConfigureJsonFiles(IConfigurationBuilder configuration){}/// <summary>/// 初始化基础服务/// </summary>private void InitializeServices(){_logger.LogInformation($"准备初始化服务");var services = new ServiceCollection();Services = services;// 添加服务// services.AddTransient<IService, ServiceImplementation>();// 添加主机服务：public class AppHostedService : IHostedService，该类要实现StartAsync以及StopAsync方法// services.AddHostedService<AppHostedService>();services.AddSingleton(_loggerManager);services.AddSingleton(Configuration);services.AddSingleton(HostConfig);OnHostServicesInitializing(this, services);}/// <summary>/// 配置服务，各子项目可以重写此方法来注册各项服务/// </summary>/// <param name="services">服务集合</param>protected virtual void ConfigureServices(IServiceCollection services){}/// <inheritdoc cref="HostConfiguring" path="/summary"/>/// <param name="sender"><inheritdoc cref="IAppHost" path="/summary"/></param>/// <param name="builder">用于构建应用程序配置的构建器</param>protected virtual void OnHostConfiguring(IAppHost sender, IConfigurationBuilder builder){HostConfiguring?.Invoke(sender, builder);}/// <inheritdoc cref="HostConfigurationInitialized" path="/summary"/>/// <param name="sender"><inheritdoc cref="IAppHost" path="/summary"/></param>/// <param name="builder">应用程序配置</param>protected virtual void OnHostConfigurationInitialized(IAppHost sender, IConfiguration builder){HostConfigurationInitialized?.Invoke(sender, builder);}/// <inheritdoc cref="HostServicesInitializing" path="/summary"/>/// <param name="sender"><inheritdoc cref="IAppHost" path="/summary"/></param>/// <param name="builder">服务列表</param>protected virtual void OnHostServicesInitializing(IAppHost sender, IServiceCollection builder){HostServicesInitializing?.Invoke(sender, builder);}/// <inheritdoc cref="HostReady" path="/summary"/>/// <param name="sender"><inheritdoc cref="IAppHost" path="/summary"/></param>protected virtual void OnHostReady(IAppHost sender){HostReady?.Invoke(sender, EventArgs.Empty);}}
}

祝您用餐愉快，下一篇我们将编写如何使用主机框架的实际应用，敬请期待

1-3-5 $ 3-5-5-4 带着田螺回四堡 3-5-2-4