quartznet

This release aims to modernize targeted platforms and used dependencies.

The System.Configuration.ConfigurationManager reference from non-framework builds. This means
using App.config's <quartz> section as Quartz configuration source is only supported on .NET Framework builds. This
change was made to reduce legacy dependencies and to make Quartz more compatible with modern .NET.

The netcoreapp3.1 target has been removed from DI and hosting integration packages which makes NET 6 the lowest supported
modern runtime version for those packages.

What's Changed

• Remove netcoreapp3.1 support and trim dependencies by @lahma in https://github.com/quartznet/quartznet/pull/2507
• Remove System.Configuration.ConfigurationManager package reference by @lahma in https://github.com/quartznet/quartznet/pull/2513

Full Changelog: https://github.com/quartznet/quartznet/compare/v3.12.0...v3.13.0

This release aims to alleviate some problems that have been present then Quartz's own global singletons clash
with DI containers singleton concept when DI container is being torn down during testing. Now both scheduler repository
and DB connection manager are scoped inside DI container and share container's lifetime.

If you want to have multiple service collections sharing same global state, you should manually register IDbConnectionManager
and ISchedulerRepository to DI as singletons pointing to global object instances.

// add globals before AddQuartz to get old behavior
services.AddSingleton<IDbConnectionManager>(DBConnectionManager.Instance);
services.AddSingleton<ISchedulerRepository>(SchedulerRepository.Instance);

services.AddQuartz(...)

What's Changed

• Upgrade System.Text.Json to 8.0.4 by @lahma in https://github.com/quartznet/quartznet/pull/2466
• Add trigger serializers for Newtonsoft based serializer by @lahma in https://github.com/quartznet/quartznet/pull/2480
• Make scheduler registration cleanup more robust during shutdown by @lahma in https://github.com/quartznet/quartznet/pull/2498
• Change scheduler repository to be singleton scoped under MS DI integration by @lahma in https://github.com/quartznet/quartznet/pull/2502
• Change DB connection manager to be singleton scoped under MS DI integration by @lahma in https://github.com/quartznet/quartznet/pull/2504

Full Changelog: https://github.com/quartznet/quartznet/compare/v3.11.0...v3.12.0

What's Changed

• Don't create intermediate MemoryStream in SystemTextJsonObjectSerializer by @lahma in https://github.com/quartznet/quartznet/pull/2418
• Fix postgres testing and STJ dictionary serialization by @lahma in https://github.com/quartznet/quartznet/pull/2437
• Add support for DbDataSource by @Hawxy in https://github.com/quartznet/quartznet/pull/2439
• Fix issues with STJ serializer by @VilleHakli in https://github.com/quartznet/quartznet/pull/2434
• Fix DirtyFlagMap enumerator behaviors by @lahma in https://github.com/quartznet/quartznet/pull/2445
• Update Build actions to use checkout/@v4 & cache/@v4 by @jafin in https://github.com/quartznet/quartznet/pull/2451
• Allow Microsoft SQL Server database initialization scripts to be configured to not delete existing tables by @jafin in https://github.com/quartznet/quartznet/pull/2449
• Improve binary to JSON migration support and documentation by @lahma in https://github.com/quartznet/quartznet/pull/2458

New Contributors

• @Hawxy made their first contribution in https://github.com/quartznet/quartznet/pull/2439

Full Changelog: https://github.com/quartznet/quartznet/compare/v3.10.0...v3.11.0

This release adds support for using System.Text.Json as serializer for JSON payloads stored in database via new integration package Quartz.Serialization.SystemTextJson. Please note that there might be small incompatibilities between Newtonsoft and STJ (de)serialization. If you are using only strings as data values, there should be no compatibility issues. Using the new integration package is ideal for new greenfield projects.

What's Changed

• Upgrade vulnerable Npgsql by @lahma in https://github.com/quartznet/quartznet/pull/2363
• Fix NativeJob crashing when working directory parameter missing by @viebrix in https://github.com/quartznet/quartznet/pull/2407
• Change NativeJob to use RuntimeInformation.IsOSPlatform instead of env var by @lahma in https://github.com/quartznet/quartznet/pull/2411
• Use newtonsoft as preferred JSON serializer type alias by @lahma in https://github.com/quartznet/quartznet/pull/2412
• Add support for System.Text.Json serializer by @lahma in https://github.com/quartznet/quartznet/pull/2416

New Contributors

• @viebrix made their first contribution in https://github.com/quartznet/quartznet/pull/2407

Full Changelog: https://github.com/quartznet/quartznet/compare/v3.9.0...v3.10.0

What's Changed

• Fix Holiday Calendar with Nested Calendars sometimes crashing when resolving NextIncludedTime (#2270)
• Add WithDailyTimeIntervalSchedule overload with explicit interval and interval unit (#1152)
• Improve performance of DailyCalendar.GetNextIncludedTimeUtc (#2285)
• Add support for IAsyncDisposable jobs and MS DI resources (#2335)
• Make IJobWrapper public (#2313)

New Contributors

• @williamdenton made their first contribution in https://github.com/quartznet/quartznet/pull/2335

Full Changelog: https://github.com/quartznet/quartznet/compare/v3.8.1...v3.9.0

This release contains small bug fixes and now the NuGet packages have the much-touted package readmes.

What's Changed

• Add package README files by @lahma in https://github.com/quartznet/quartznet/pull/2199
• Fix handling of env var quartz.config (#2212) by @delta-emil in https://github.com/quartznet/quartznet/pull/2213
• Upgrade to NUKE 8 by @lahma in https://github.com/quartznet/quartznet/pull/2251
• Use configured type loader in scheduler factory init by @lahma in https://github.com/quartznet/quartznet/pull/2268

New Contributors

• @delta-emil made their first contribution in https://github.com/quartznet/quartznet/pull/2213

Full Changelog: https://github.com/quartznet/quartznet/compare/v3.8.0...v3.8.1

This most notably tries to improve Quartz API and metadata to handle NET 8 trimming capabilities better, but there's probably still issues to encounter. When using trimming one should use the strongly-typed MS DI integration and SchedulerBuilder APIs.

What's Changed

• Add Qodana scanning by @lahma in https://github.com/quartznet/quartznet/pull/2110
• Ensure that the DailyCalendar use the same TimeZone offset for all the checks by @kvpt in https://github.com/quartznet/quartznet/pull/2113
• Fix for JobDataMap, TryGetValue return false when key is null/doesn't exist by @jafin in https://github.com/quartznet/quartznet/pull/2125
• SendMailJob to throw JobExecutionException on BuildMessage construction failure due to missing mandatory params. by @jafin in https://github.com/quartznet/quartznet/pull/2126
• Backport test changes to ReschedulingTriggerShouldKeepOriginalNextFireTime from main to 3.x by @jafin in https://github.com/quartznet/quartznet/pull/2129
• JobInterruptMonitorPlugin should tolerate missing JobDataMapKeyAutoInterruptable by @lahma in https://github.com/quartznet/quartznet/pull/2191
• Add NET 8.0 targeting by @lahma in https://github.com/quartznet/quartznet/pull/2192
• Upgrade TimeZoneConverter to version 6.1.0 by @lahma in https://github.com/quartznet/quartznet/pull/2194
• Improve trimming compatibility by @lahma in https://github.com/quartznet/quartznet/pull/2195
• Support injecting dependencies to XMLSchedulingDataProcessorPlugin by @lahma in https://github.com/quartznet/quartznet/pull/2196
• Enable trimmed publish for ASP.NET Core example by @lahma in https://github.com/quartznet/quartznet/pull/2197

New Contributors

• @kvpt made their first contribution in https://github.com/quartznet/quartznet/pull/2113

Full Changelog: https://github.com/quartznet/quartznet/compare/v3.7.0...v3.8.0

This release has some work pointing people towards more sustainable API usage. Adding .NET 6.0 target for less dependencies.

What's Changed

• Improve custom job store DI registration API by @lahma in https://github.com/quartznet/quartznet/pull/2063
• Obsolete plain UseJsonSerializer() by @lahma in https://github.com/quartznet/quartznet/pull/2077
• Mark UseMicrosoftDependencyInjectionJobFactory() as obsolete, remove UseMicrosoftDependencyInjectionScopedJobFactory() by @lahma in https://github.com/quartznet/quartznet/pull/2085
• Change QuartzHostedService from internal to public by @rf-0 in https://github.com/quartznet/quartznet/pull/2090
• Remove enumerator usage in AcquireNextTriggers when getting timeTriggers min value by @lahma in https://github.com/quartznet/quartznet/pull/2092
• Make private and internal classes sealed by @lahma in https://github.com/quartznet/quartznet/pull/2098
• Add net6.0 target by @lahma in https://github.com/quartznet/quartznet/pull/2106

New Contributors

• @rf-0 made their first contribution in https://github.com/quartznet/quartznet/pull/2090

Full Changelog: https://github.com/quartznet/quartznet/compare/v3.6.3...v3.7.0

To celebrate my daughter's 8th birthday, let's have a maintenance release. This release brings important fix to scoped job dependency disposal which had regressed in 3.6.1 release.

What's Changed

• Run postgres integration tests as part of CI build by @lahma in https://github.com/quartznet/quartznet/pull/1935
• Change QuartzServiceCollectionExtensions namespace to Quartz.AspNetCore in Quartz.AspNetCore project by @romantitov in https://github.com/quartznet/quartznet/pull/1950
• Detect invalid CRON expression character trailing a '?' by @jafin in https://github.com/quartznet/quartznet/pull/1955
• ServiceCollectionSchedulerFactory.GetNamedConnectionString passes wrong value to base by @msa48 in https://github.com/quartznet/quartznet/pull/1960
• Extend object passed to DiagnosticListener.Start/EndActivity by @dima-zhemkov in https://github.com/quartznet/quartznet/pull/1995
• JobInterruptMonitor Plugin: Read MaxRunTime from MergedJobDataMap by @alanblack in https://github.com/quartznet/quartznet/pull/2004
• V3: return PersistJobDataAfterExecution flag in SelectJobDetail.fixed not… by @wuuer in https://github.com/quartznet/quartznet/pull/2014
• Fix persistence of extended properties when the trigger type is changed (v3) by @philr in https://github.com/quartznet/quartznet/pull/2040
• Fix disposing of MS DI job scopes by @lahma in https://github.com/quartznet/quartznet/pull/2059
• [3.x] Optimize reading blobs on SQL Server by @OronDF343 in https://github.com/quartznet/quartznet/pull/2061

New Contributors

• @romantitov made their first contribution in https://github.com/quartznet/quartznet/pull/1950
• @msa48 made their first contribution in https://github.com/quartznet/quartznet/pull/1960
• @dima-zhemkov made their first contribution in https://github.com/quartznet/quartznet/pull/1995
• @alanblack made their first contribution in https://github.com/quartznet/quartznet/pull/2004
• @OronDF343 made their first contribution in https://github.com/quartznet/quartznet/pull/2061

Full Changelog: https://github.com/quartznet/quartznet/compare/v3.6.2...v3.6.3

This is fix to a fix release, 3.6.1 introduced a regression to job selection logic when using persistent job store.

FIXES

• Fix SqlSelectJobDetail to include IS_NONCONCURRENT (#1927)

Full Changelog: https://github.com/quartznet/quartznet/compare/v3.6.1...v3.6.2

This bug fix release contains an important fix to anyone configuring jobs using job builder's DisallowConcurrentExecution()
without having the attribute DisallowConcurrentExecutionAttribute on type itself.

FIXES

• Add missing "disallow concurrency" materialization for jobs (#1923)
• Allow accessing the wrapped scoped job instance from job execution context (#1917)
• JobDiagnosticsWriter can throw error when writing context data (#1191)

New Contributors

• @IlyaVassyutovich made their first contribution in https://github.com/quartznet/quartznet/pull/1923
• @j0hannesdd made their first contribution in https://github.com/quartznet/quartznet/pull/1917

Full Changelog: https://github.com/quartznet/quartznet/compare/v3.6.0...v3.6.1

This release contains new API to reset errored trigger state in job store, some bug fixes and refinement of package dependencies/targets.

NEW FEATURES

• Add explicit netcoreapp3.1 and net6.0 targets to MS integration projects (#1879)
• Use IHostApplicationLifetime instead of IApplicationLifetime in >= netcoreapp3.1 Hosting targets (#1593)
• Add ResetTriggerFromErrorState functionality (#1904)

FIXES

• Fix named connection string resolution when using MS DI and its configuration system (#1839)
• Upgrade to System.Configuration.ConfigurationManager 6.0.1 to avoid vulnerable dependency chain (#1792)
• Fix configuration handling for custom DB provider (#1795)
• Add extra overloads for registering listeners (#1852)
• JobDataMap.TryGetGuidValue should return Guid instead of int (#1856)
• Upgrade to Newtonsoft.Json 13.0.1 (#1859)

Full Changelog: https://github.com/quartznet/quartznet/compare/v3.5.0...v3.6.0

NEW FEATURES

• Allow PersistJobDataAfterExecution and ConcurrentExecutionDisallowed to be explicitly set in JobBuilder and pulled up to IJobConfigurator (#1575)
• Add TryGet functions to JobDataMap and StringKeyDirtyFlagMap (#1592)
• Add UseMySqlConnector overload for DB configuration (#1621)
• Validate database schema during scheduler initialization (#1716)
• Support DataSource name configuration (#1710)
• Add UsePersistentStore<T> where T : IJobStore in DI Extension (#1715)

FIXES

• Make RAMJobStore.RemoveJobInternal return true even if job has no triggers (#1580)
• Configuration property quartz.jobStore.dbRetryInterval will be correctly set when constructing the Scheduler JobStore.
  • If you previously had configuration with the key quartz.scheduler.dbFailureRetryInterval please change to the above mentioned key.
• DailyCalendar doesn't include first and last millisecond of day in checks (#1665)
• StdSchedulerFactory and derived factories are not thread-safe (#1587)
• Change QuartzOptions to inherit from Dictionary<string, string?> instead of NameValueCollection to fix Microsoft.Extensions.Configuration 7 RC integration (#1748)

IMPROVEMENTS

• Reduce scheduler initialization logging noise (#1752)

New Contributors

• @Sobotkama made their first contribution in https://github.com/quartznet/quartznet/pull/1580
• @asherber made their first contribution in https://github.com/quartznet/quartznet/pull/1592
• @jcracknell made their first contribution in https://github.com/quartznet/quartznet/pull/1588
• @devbased made their first contribution in https://github.com/quartznet/quartznet/pull/1710

Full Changelog: https://github.com/quartznet/quartznet/compare/v3.4.0...v3.5.0

This release has Quartz jobs start executing only after application startup completes successfully, unless QuartzHostedServiceOptions are used to specify otherwise. By default, this prevents jobs from running while the application is still starting, and it alleviates the need to use arbitrary start delays to achieve the effect manually.

Quartz.OpenTelemetry.Instrumentation has been marked obsolete as there's official contrib project on OpenTelemetry project side.

FIXES

• Fix for job type loading after version change (#1286)
• Fix StartDelayed delaying the start of other hosted services (#1314)
• Set NextFireTime of the replaced trigger relative to the old trigger's StartTime if the old trigger's PreviousFireTime is null (#1519)
• Include InvertTimeRange property in DailyCalendar.Clone (#1522)
• QuartzHealthCheck never recovers after detecting failure (#1496)
• Microsoft DI integration does not working with Microsoft.Extensions.Hosting v7 preview (#1544)

IMPROVEMENTS

• Jobs now start executing after application startup completes successfully (#1432)
• Support strongly-typed configuration of IDbProvider (#1312)
• Add MSSQL Script compatible with SQL 2014 and 2012 (#1337)
• Added usage of DisallowConcurrentExecutionAttribute for interfaces (#1345)
• Multiple performance improvements (#1351, #1355, #1354, #1353, #1356, #1358)
• Increase precision of SimpleTriggerImpl to ticks. (#1360)
• Switch from FAKE to NUKE (#1413)
• QuartzHostedService now has jobs start after application startup (#1449)
• QuartzHostedServiceOptions can let jobs be started as part of application startup, as before this version (#1432)
• Add helper methods to setup Microsoft.Data.Sqlite (#1275)
• Quartz will scan job and trigger listeners from MS DI container automatically (#1561)

BREAKING CHANGES

• Quartz.OpenTelemetry.Instrumentation is now obsolete as there is contrib package OpenTelemetry.Instrumentation.Quartz on OT side
• .NET Framework minimum version is 4.6.2 (previously 4.6.1) (#1549)

NEW CONTRIBUTORS

• @zihotki made their first contribution in https://github.com/quartznet/quartznet/pull/1275
• @justmara made their first contribution in https://github.com/quartznet/quartznet/pull/1286
• @kolpav made their first contribution in https://github.com/quartznet/quartznet/pull/1298
• @Kuznetsov-Alexey made their first contribution in https://github.com/quartznet/quartznet/pull/1345
• @CodeDrop made their first contribution in https://github.com/quartznet/quartznet/pull/1465
• @Pifanjr made their first contribution in https://github.com/quartznet/quartznet/pull/1485
• @Strandinator made their first contribution in https://github.com/quartznet/quartznet/pull/1513
• @aschuhde made their first contribution in https://github.com/quartznet/quartznet/pull/1519
• @qzavyer made their first contribution in https://github.com/quartznet/quartznet/pull/1522
• @marceloceccon made their first contribution in https://github.com/quartznet/quartznet/pull/1534
• @Suchiman made their first contribution in https://github.com/quartznet/quartznet/pull/1535
• @bencyoung-Fignum made their first contribution in https://github.com/quartznet/quartznet/pull/1497

Full Changelog: https://github.com/quartznet/quartznet/compare/v3.3.3...v3.4.0

This is a maintenance release mostly fixing some smaller bugs and improving DI API story.

FIXES

• Lock 'TRIGGER_ACCESS' attempt to return by: de9325af-3e1c-4ae9-a99b-24be994b75f4 -- but not owner! (#1236)
• ScheduleJob shorthand: Job name should match trigger name by default (#1211)
• CronTriggerImpl.WillFireOn returns wrong result when TimeZone is specified (#1187)
• Race condition in DI scheduler listener initialization (#1117)
• JobRunShell handle Job CancellationToken (#1183)
• Restore System.Data.SqlClient support on .NET Core (#1181)

IMPROVEMENTS

• Replace static loggers with instance-based (#1264)
• Expose more configuration options via programmatic APIs (#1263)
• Add ConfigureScope extension point to MicrosoftDependencyInjectionJobFactory (#1189)
• Update StdAdoConstants.cs (#1186)
• Use custom InstantiateType for all instantiations in StdSchedulerFactory (#1185)
• Add support for the ISchedulerFactory.StartDelayed in the QuartzHostedService (#1166)
• Remove SimpleThreadPool from examples? (#1230)

This release returns the possibility to resolve jobs from Microsoft DI container. Now container is checked first and if not found then
ActivatorUtilities is used to construct the type with constructor injection support. Now both AllowDefaultConstructor and CreateScope have
been obsoleted as behavior is now either via DI construction or ActivatorUtilities and scope is always created to prevent resource leaks / double disposal.

Also a problem with host name resolution under WSL2 scenario was fixed.

FIXES

• Try resolving jobs from service provider before resorting to ActivatorUtilities (#1159)
• Can't get hostname on WSL2+docker host network (#1158)

This release fixes assembly signing problem introduced in 3.3.

FIXES

• Remove PublicSign property from csproj (#1155)

This release addresses problems with using Quartz with .NET Full Framework lower than 4.7.2. ValueTask loading
could fail due the dependencies brought with activity source support. Now activity sources are only supported when
using .NET Framework >= 4.7.2 and netstandard >= 2.0. This also raises requirement the same way for package
Quartz.OpenTelemetry.Instrumentation.

This release also improves trigger acquisition performance when using persistent job store, mostly by reducing network round-trips.
The semaphore implementations were also re-written to gain more performance.

Also some bug fixes included, thanks to all contributors!

GitHub Issues

BREAKING CHANGES

• Activity source listener is not longer part of net461 build, only net472
• Quartz.AspNetCore integration package minimum .NET Core version is now 3.1 for HealthChecks support

NEW FEATURES

• Separate build configuration for .NET Framework 4.7.2
• OpenTelemetry integration upgraded to target OpenTelemetry 1.0.0-rc1.1
• Ported JobInterruptMonitorPlugin from Java version which allows automatic interrupt calls for registered jobs (#1110)
• Rewrite semaphore implementations (#1115)
• UsingJobData now has Guid and char overloads (#1141)
• Add a regular AddJob(Type) (#1090)

FIXES

• Jobs not firing after upgrade to 3.2.x (from 3.0.7) on Microsoft Server 2008 R2 (#1083)
• Jobs are not fired (#1072)
• MicrosoftDependencyInjectionJobFactory does not inject job properties for scoped jobs (#1106)
• XSD schema no longer requires defining durable element if you just want to define recover (#1128)
• Stack trace logging fixed in case of reporting invalid lock acquire (#1133)
• Disposable job is disposed twice when using UseMicrosoftDependencyInjectionScopedJobFactory (#1120)
• QuartzHostedService.StopAsync throws NullReferenceException if StartAsync hasn't been run (#1123)

This release is a maintenance release with couple of bug fixes. The most important fix for this release is that
now Quartz distinguishes between external code task cancellation (say HttpClient) and job cancellation triggered by using
the Quartz API's Interrupt method. Earlier Quartz incorrectly considered also other OperationCanceledExceptions as clean instead of being errors.

FIXES

• JobRunShell silently handles OperationCanceledException which is not correct in terms of job retry handling (#1064)
• Handled exceptions thrown while retrieving the misfired trigger (#1040)
• FileScanJob is faling after upgrading from 3.0.7 to 3.2.3 (#1027)
• JobBuilder.UsingJobData(string key, string value) should be JobBuilder.UsingJobData(string key, string? value) (#1025)

This release addresses issue with Autofac integration and adds new integration package Quartz.OpenTracing to allow
integration with OpenTracing.

NEW FEATURE

• Add Quartz.OpenTracing support (#1006)
• Add UseZeroSizeThreadPool to configuration (#1003)

FIXES

• Xamarin Android can't get scheduler (#1008)
• Autofac job factory registration fails (#1011)