jellyfin/Emby.Server.Implementations/ScheduledTasks/Triggers/IntervalTrigger.cs

using System;
using System.Linq;
using System.Threading;
using MediaBrowser.Model.Tasks;
using Microsoft.Extensions.Logging;

namespace Emby.Server.Implementations.ScheduledTasks.Triggers;

/// <summary>
/// Represents a task trigger that runs repeatedly on an interval.
/// </summary>
public sealed class IntervalTrigger : ITaskTrigger, IDisposable
{
    private readonly TimeSpan _interval;
    private DateTime _lastStartDate;
    private Timer? _timer;
    private bool _disposed;

    /// <summary>
    /// Initializes a new instance of the <see cref="IntervalTrigger"/> class.
    /// </summary>
    /// <param name="interval">The interval.</param>
    /// <param name="taskOptions">The options of this task.</param>
    public IntervalTrigger(TimeSpan interval, TaskOptions taskOptions)
    {
        _interval = interval;
        TaskOptions = taskOptions;
    }

    /// <inheritdoc />
    public event EventHandler<EventArgs>? Triggered;

    /// <inheritdoc />
    public TaskOptions TaskOptions { get; }

    /// <inheritdoc />
    public void Start(TaskResult? lastResult, ILogger logger, string taskName, bool isApplicationStartup)
    {
        DisposeTimer();

        DateTime now = DateTime.UtcNow;
        DateTime triggerDate;

        if (lastResult is null)
        {
            // Task has never been completed before
            triggerDate = now.AddHours(1);
        }
        else
        {
            triggerDate = new[] { lastResult.EndTimeUtc, _lastStartDate, now.AddMinutes(1) }.Max().Add(_interval);
        }

        var dueTime = triggerDate - now;
        var maxDueTime = TimeSpan.FromDays(7);

        if (dueTime > maxDueTime)
        {
            dueTime = maxDueTime;
        }

        _timer = new Timer(_ => OnTriggered(), null, dueTime, TimeSpan.FromMilliseconds(-1));
    }

    /// <inheritdoc />
    public void Stop()
    {
        DisposeTimer();
    }

    /// <summary>
    /// Disposes the timer.
    /// </summary>
    private void DisposeTimer()
    {
        _timer?.Dispose();
        _timer = null;
    }

    /// <summary>
    /// Called when [triggered].
    /// </summary>
    private void OnTriggered()
    {
        DisposeTimer();

        if (Triggered is not null)
        {
            _lastStartDate = DateTime.UtcNow;
            Triggered(this, EventArgs.Empty);
        }
    }

    /// <inheritdoc />
    public void Dispose()
    {
        if (_disposed)
        {
            return;
        }

        DisposeTimer();

        _disposed = true;
    }
}