In the previous post I’ve written about why I think the ability to schedule tasks for later execution is a fundamental technical feature, but also a must have from business’ point of view. We are passed the whys, so let’s get to the hows. The answer is simple - Hangfire. I’ve written about it here, here and here, so yeah, you guessed it, I like it. Hangfire is an amazing library. It has shown it’s value in my pet project (cookit.pl) and in a huge ERP system that we are building at work, where we replaced Quartz.NET with it and never looked back.

Why do I like it so much?

1. Scheduling

It enables:

  • to fire(enqueue) and forget a job:
	BackgroundJob.Enqueue(() => Console.WriteLine("Simple!"));`
  • to schedule a one time job using a cron expression
	BackgroundJob.Schedule(() => Console.WriteLine("Reliable!"), TimeSpan.FromDays(7));
  • and to schedule a recurring job also with a cron expression
	RecurringJob.AddOrUpdate(() => Console.WriteLine("Transparent!"), Cron.Daily)

A side note: Cron expressions allow to express almost any time span, and using them is a standard in most task scheduling cases (Quartz.NET, Unix, TeamCity to name a few). There is a good Wikipedia page explaining the syntax. Think of them as regular expressions for time.

I personally fell in love with the simplicity of this API, and especially with the fact that it takes a function to execute, not an object. Although this examples are simple lambdas Hangfire allows to schedule executing methods on almost any objects, but this is a topic for another post. Probably the next one:)

2. Persistence

The key point in procrastinating tasks is to not do them now, but to have certainty that they will be executed. That is why persisting jobs in a database is a key feature. And Hangfire has a hand of stores to persist in:

And configuring any of them is as simple as scheduling a job:

JobStorage.Current = new SqlServerStorage("HangfireConnectionString")

3. Job execution

Persisting a job in a database gives the possibility for another process to execute it. And Hangfire does just that. Of course the process executing the job has to have all the assemblies needed to execute the code, but this is just another argument for not having everything jammed into one project. Hangfire can be hosted by a:

  • console application
  • Windows service
  • IIS website

And configuring it is as easy as scheduling a job:

GlobalConfiguration.Configuration.UseSqlServerStorage("HangfireConnectionString");
using (var server = new BackgroundJobServer())
{
    Console.WriteLine("Hangfire Server started. Press any key to exit...");
    Console.ReadKey();
}

4. Monitoring

For me the ability to have a graphic interface to see current jobs, queues, errors and processing servers was a must-have when choosing a library for a simple reason - I needed it and didn’t want to write it myself. And Hangfire has just that:

The dashboard is fully served be Hangfire (there is no need to add any CSS or JavaScript files) and configuring it is a one liner extension on OWIN IAppBuilder:

	app.UseHangfireDashboard();

This was a glimpse of what this library can do. It’s not always bells and whistles, but I’ve never regretted choosing it can’t imagine working without the ability to schedule tasks. In the next post - a better look into jobs.

Hi, I'm Szymon Warda. I write code, design IT systems, write this blog, tweet and speak at conferences. If You want to know more go here, or follow me: