SimpleRecurringJobs

SimpleRecurringJobs is a C# library designed for very easily running recurring jobs in your applications, where each job should run once per trigger regardless of how many instances of your application is running.

Dependencies

SimpleRecurringJobs is designed for work with .NET Core apps, and make use of the following Microsoft packages:

• Microsoft.Extensions.DependencyInjection.Abstractions
• Microsoft.Extensions.Hosting.Abstractions
• Microsoft.Extensions.Logging.Abstractions

Additional packages are required depending on what extra functionality you need.

Samples

See SimpleJob for a simple job that executes with a given interval.

Jobs

IIntervalJob

Interval jobs run at certain intervals, disregarding the clock. Suitable for jobs that do not need to be run at specific times.

public class SimpleJob : IIntervalJob { public string Id { get; } = "SimpleJob"; public TimeSpan Interval { get; } = TimeSpan.FromSeconds(5); public TriggerCountMode Mode { get; } = TriggerCountMode.CountSinceLastTrigger; public async Task Execute(CancellationToken cancellationToken) { // todo: Do stuff! } }

ICronJob

Cron jobs run according to a cron expression. This requires the package SimpleRecurringJobs.Cron which has a dependency on the third-party package Cronos.

.AddCronScheduler() must be called in the builder callback in AddSimpleRecurringJobs(...). E.g.:

sc.AddSimpleRecurringJobs( b => b.UseInMemoryJobStore().AddCronScheduler().WithJob<SimpleCronJob>() );