Quartz.Serialization.Newtonsoft

Quartz.Serialization.Newtonsoft

Quartz.Serialization.Newtonsoft serializes what a Quartz.NET ADO.NET job store persists — job data maps, calendars and trigger state — with Json.NET.

System.Text.Json serialization is built into the core Quartz package and is the default, so reach for this one when what is already in your database was written by Json.NET, or when your job data depends on how Json.NET handles it. It is the successor to Quartz 3's Quartz.Serialization.Json.

Installation

dotnet add package Quartz.Serialization.Newtonsoft

Usage

builder.Services.AddQuartz(q => q.UsePersistentStore(store =>
{
    store.UseSqlServer(connectionString);
    store.Configure(options => options.StoreJobDataAsStrings = true);
    store.UseNewtonsoftJsonSerializer();
}));

The same UseNewtonsoftJsonSerializer call configures a store built without a host, and the flat key quartz.serializer.type = newtonsoft selects it from configuration.

StoreJobDataAsStrings is worth setting whichever serializer you use: it keeps job data out of the serializer altogether, which is what avoids surprises when a persisted type later changes shape.

Documentation

https://www.quartz-scheduler.net/documentation/quartz-4.x/packages/json-serialization.html