Atc.Hosting 1.0.8

Atc.Hosting

Contains various classes and extensions methods for the hosting namespace, e.g. BackgroundServices

Why BackgroundServiceBase<T> instead of BackgroundService

BackgroundServiceBase extend the BackgroundService with features like:

• High-performance logging by using source-generated logging using ILogger
• Built-in retryies using Polly
• Error handling using logging instead of service crashing silently
• Configuration for:
  • Startup-Delay
  • Retry-Count
  • Repeat-Interval
• Simple to use

Using BackgroundServiceBase<T>

A sample reference implementation can be found in the sample project Atc.Hosting.TimeFile.Sample which shows an example of the service TimeFileWorker that uses BackgroundServiceBase.

Program.cs

In Program.cs the TimeFileWorker is wired up by using AddHostedService<T> as a normal BackgroundService.

Note: TimeFileWorker uses TimeFileWorkerOptions that implements IBackgroundServiceOptions.

var configuration = new ConfigurationBuilder()
    .SetBasePath(Directory.GetCurrentDirectory())
    .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
    .Build();

var host = Host
    .CreateDefaultBuilder(args)
    .ConfigureServices(services =>
    {
        services.AddSingleton<ITimeService, TimeService>();
        services.Configure<TimeFileWorkerOptions>(configuration.GetSection(TimeFileWorkerOptions.SectionName));
        services.AddHostedService<TimeFileWorker>();
    })
    .Build();

host.Run();

TimeFileWorker.cs

In this example TimeFileWorker, it inherits from BackgroundServiceBase. It shows an example of the only method DoWorkAsync which has to be implemented.

public class TimeFileWorker : BackgroundServiceBase<TimeFileWorker>
{
    private readonly TimeFileWorkerOptions workerOptions;
    private readonly ITimeService timeService;

    public TimeFileWorker(
        ILogger<TimeFileWorker> logger,
        IOptions<TimeFileWorkerOptions> workerOptions,
        ITimeService timeService)
        : base(
            logger,
            workerOptions.Value)
    {
        this.workerOptions = workerOptions.Value;
        this.timeService = timeService;
    }

    public override Task DoWorkAsync(
        CancellationToken stoppingToken)
    {
        Directory.CreateDirectory(workerOptions.OutputDirectory);

        var time = timeService.GetDateTime();

        var outFile = Path.Combine(
            workerOptions.OutputDirectory,
            $"{time:yyyy-MM-dd--HHmmss}.txt");

        return File.WriteAllTextAsync(outFile, ServiceName, stoppingToken);
    }
}

Requirements

• .NET 7 SDK

How to contribute

Contribution Guidelines

Coding Guidelines