sharee.bike-App/TINKLib/ViewModel/PollingUpdateTaskManager.cs

using System;
using System.Threading.Tasks;
using Serilog;
using TINK.Settings;

namespace TINK.ViewModel
{
	/// <summary>
	/// Performs a periodic update.
	/// </summary>
	public class PollingUpdateTaskManager : IPollingUpdateTaskManager
	{
		/// <summary> Action which performs an update.</summary>
		private Action UpdateAction { get; }

		/// <summary> Reference on the current polling task</summary>
		private PollingUpdateTask UpdateTask { get; set; }

		/// <summary>
		/// Gets or sets polling parameters.
		/// </summary>
		private PollingParameters PollingParameters { get; set; }

		/// <summary> Prevents an invalid instance to be created. </summary>
		private PollingUpdateTaskManager()
		{ }

		/// <summary>Constructs a update manager object. </summary>
		/// <param name="p_oGetChildName">Name of the child class. For logging purposes.</param>
		/// <param name="updateAction"></param>
		public PollingUpdateTaskManager(
			Action updateAction)
		{
			UpdateAction = updateAction ?? throw new ArgumentException(
				$"Can not construct {GetType().Name}- obect. Argument {nameof(updateAction)} must not be null.");
		}

		/// <summary>
		/// Invoked when page is shown. 
		/// Actuates and awaits the first update process and starts a task wich actuate the subseqent update tasks.
		/// </summary>
		/// <param name="pollingParameters">Parametes holding polling periode, if null last parameters are used if available.</param>
		public async Task StartUpdateAyncPeridically(PollingParameters pollingParameters = null)
		{
			if (UpdateTask != null)
			{
				Log.Error($"Call to stop periodic update task missed in context {GetType().Name} at {DateTime.Now}.");

				// Call of StopUpdatePeriodically missed. 
				// Terminate running polling update task before starting a new one
				await UpdateTask.Terminate();
			}

			if (pollingParameters != null)
			{
				// Backup polling parameter for purposee of restart.
				PollingParameters = pollingParameters;
			}

			if (PollingParameters == null)
			{
				// No polling parameters avaialable.
				Log.Error($"Can not start polling. No parameters available.");
				return;
			}


			if (!PollingParameters.IsActivated)
			{
				// Automatic supdate is switched off.
				Log.ForContext<PollingUpdateTask>().Debug($"Automatic update is off, context {GetType().Name} at {DateTime.Now}.");
				return;
			}

			UpdateTask = new PollingUpdateTask(
				UpdateAction,
				PollingParameters.Periode);
		}

		/// <summary>
		/// Invoked when pages is closed/ hidden. 
		/// Stops update process.
		/// </summary>
		public async Task StopUpdatePeridically()
		{
			if (UpdateTask == null)
			{
				// Nothing to do if there is no update task pending.
				return;
			}

			await UpdateTask.Terminate();

			UpdateTask = null;
		}
	}
}