Aicrosoft.Extensions.Hosting 1.0.0

How to use Aicrosoft.Extensions.Hosting

通用主机，加入了一些简易的扩展，比如字符串处理，自动模块注入等。还能避免引入多个MS的包。只用这一个就好了（不用再次引入MS的Hosting） A general-purpose host, adding some simple extensions, such as string processing, automatic module injection, etc. It can also avoid introducing multiple MS packages. Just use this one (no need to introduce MS Hosting again)

该模块主要用于基于Console的程序，基于Web的反而用不上了。

How to use

1. add pakcage NLog.Extensions.Logging
2. add nlog.config
3. chanage the program code and add extesion of host

Program.cs file

<details> <summary>The Application start</summary>

using Aicrosoft.Logging;
using Microsoft.Extensions.Hosting;
using NLogAIApp;

var start = Environment.TickCount64;
var logger = LogHelper.GetCurrentClassLogger();
logger.Trace($"Loggger was created TimeElapsed:{Environment.TickCount64 - start} ms");

try
{
    start = Environment.TickCount64;
    logger.Trace($"Begin Build Host Envirment ...");
    using IHost host = Host.CreateDefaultBuilder(args)
        .AddAppServices()
        .Build();
    logger.Trace($"End Build. TimeElapsed:{Environment.TickCount64 - start} ms");
    await host.RunAsync();
    return 0;
}
catch (Exception ex)
{
    logger.Error(ex, "Build and run IHost has a exception");
    return -9;
}
finally
{
    LogHelper.Shutdown();
}

</details>

Startup.cs file

<details> <summary>The Application's Startup classs </summary>

using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;
using Microsoft.Extensions.Options;
using NLogAIApp.Options;
using NLogAIApp.Services;
using System.Text;

namespace NLogAIApp;

public class Startup : HostedService
{
    private readonly IHelloWorldService helloWorldService;
    private readonly TasksOption tasksSetting;

    public Startup(
        IHostApplicationLifetime appLifetime, ILoggerFactory loggerFactory, IServiceProvider serviceProvider
        , IHelloWorldService helloService
        , IOptions<TasksOption> options
        ) : base(appLifetime, loggerFactory, serviceProvider)
    {
        helloWorldService = helloService;
        tasksSetting = options.Value;
        Logger.LogDebug($"setting json value is :{tasksSetting.ToJson()}");
    }
   

    public override async Task StartAsync(CancellationToken cancellationToken)
    {
        Logger.LogDebug("1. StartAsync has been called.");

        Console.WriteLine();
        Console.WriteLine("-------> LOGGING DEBUG TESTING BEGIN <--------");
        await helloWorldService.SayHelloAsync();
        Console.WriteLine("-------> LOGGING DEBUG TESTING END <--------");
        Console.WriteLine();

        Console.WriteLine($"------------Configuration demo--------------------");
        var cfg = ServiceProvider.GetRequiredService<IConfiguration>();
        var val1 = cfg.GetValue<int>("Tasks:Interval");
        Console.WriteLine($"cfg.GetValue<int>(\"Tasks:Interval\") = {val1}");
        Console.WriteLine($"-------------------------------------------------");


        //It's stop the application.
        AppLifetime.StopApplication();
    }

    public override async Task StopAsync(CancellationToken cancellationToken)
    {
        Logger.LogDebug("4. StopAsync has been called.");
        await Task.CompletedTask;
        //await _appLifetime.ShutdownAsync();
        return;
    }

}

</details>

ConfigureExtensions.cs file

<details> <summary>The Application's Host Extensions </summary>

using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using NLog.Extensions.Logging;
using NLogAIApp.Options;

namespace NLogAIApp;

internal static class ConfigureExtensions
{

    public static IHostBuilder AddAppServices(this IHostBuilder hostBuilder)
    {
        hostBuilder
            .AddAppSetting()
            .AddServices()
            .AddNLog()
            //.UseAop()
            //.UseAopDI()
            .AddHostedService<Startup>()
            ;

        return hostBuilder;
    }


    /// <summary>
    /// config.json register
    /// </summary>
    /// <param name="hostBuilder"></param>
    public static IHostBuilder AddAppSetting(this IHostBuilder hostBuilder)
    {
        hostBuilder
            //.ConfigureAppConfiguration((hostContext, configuration) =>
            //{
            //    //configuration.Sources.Clear(); //在CreateDefaultBuilder(args)时如果有参数会被清除
            //    //configuration.AddCommandLine(args);
            //    var env = hostContext.HostingEnvironment;
            //    configuration
            //        .AddJsonFile("./appsettings.json")
            //        .AddJsonFile($"./appsettings.{env.EnvironmentName}.json", true, true);
            //})
            .ConfigureServices((hostContext, services) =>
            {
                var config = hostContext.Configuration;
                services.Configure<TasksOption>(config.GetSection(TasksOption.SectionName));

                // 可以直接取得上面配置的值
                var tasksOption = config.GetSection(TasksOption.SectionName).Get<TasksOption>();

            });

        return hostBuilder;
    }

}

</details>