This is a simple library that makes it easy to schedule your services. You can schedule a service to run after a delay, or to keep running with some delay between runs.
There are three classes provided:
Inherits BackgroundService. This gives you the ability to toggle the service on or off.
Inherits ToggledService. This gives you the ability to schedule a single execution at a fixed or computed date after the program starts. This will only execute one time.
Inherits ScheduledService. This will execute forever by default, with a delay between executions. You can set the delay between executions in appsettings or compute it in code.
To implement this, have your service inherit ToggleService, ScheduledService, or RecurringService. The example below shows how to configure your service to run one minute after startup and keep running every minute.
{
"Services": {
"YourService": {
"Enabled": true,
"DelayBeforeExecution": "00:01:00.0",
"DelayBetweenExecutions": "00:01:00.0"
}
}public static IHostBuilder CreateHostBuilder(string[] args) => Host.CreateDefaultBuilder(args)
.ConfigureScheduledServices((host, services) =>
{
// schedules a service with no extension methods
services.Configure<YourServiceOptions>(context.Configuration.GetRequiredSection($"Services:{typeof(YourService).Name}"));
.AddSingleton<YourService>()
.AddHostedService(services => services.GetRequiredService<YourService>());
// schedules a service using provided extension methods
services.ConfigureScheduledService<YourService, YourServiceOptions>().AddHostedSingleton<YourService>();
// configuration of non-scheduled services can still use these extension methods
// this one will use Any:Path:Here:YourService
services.Configure<YourServiceOptions>(context.Configuration.GetCustomSection<YourService>("Any:Path:Here:"));
// this one will use Services:YourService
services.Configure<YourServiceOptions>(context.Configuration.GetServicesSection<YourService>());
});public class YourServiceOptions : IRecurringServiceOptions
{
// implement the interface, or inherit RecurringServiceOptions
public TimeSpan DelayBeforeExecution { get; set; }
public TimeSpan DelayBetweenExecutions { get; set; }
public bool Enabled { get; set; }
}public class YourService : RecurringService
{
public YourService(ILogger<YourService> logger, IOptions<YourServiceOptions> options) : base(logger, options)
{
}
protected override async Task ExecuteScheduledTaskAsync(CancellationToken cancellationToken)
{
// Errors will be logged. They will not crash the program,
// nor prevent recurring services from running again.
// To change this behaviour, override OnExecutionError.
}
protected override ValueTask<TimeSpan> GetDelayBeforeExecutionAsync(CancellationToken cancellationToken)
{
// Optionally you can compute the delay here.
// This controls when the service FIRST executes after the program starts.
// It overrides DelayBeforeExecution from the IConfiguration.
}
protected override ValueTask<TimeSpan> GetDelayBetweenExecutionAsync(CancellationToken cancellationToken)
{
// This controls the delay BETWEEN executions in a recurring service.
// It overrides DelayBetweenExecutions from the IConfiguration
}
}