mirror of https://github.com/ppy/osu
671 lines
26 KiB
C#
671 lines
26 KiB
C#
// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
|
||
// See the LICENCE file in the repository root for full licence text.
|
||
|
||
using System;
|
||
using System.Collections.Generic;
|
||
using System.IO;
|
||
using System.Linq;
|
||
using System.Threading;
|
||
using System.Threading.Tasks;
|
||
using Humanizer;
|
||
using JetBrains.Annotations;
|
||
using Microsoft.EntityFrameworkCore;
|
||
using osu.Framework;
|
||
using osu.Framework.Extensions;
|
||
using osu.Framework.Extensions.IEnumerableExtensions;
|
||
using osu.Framework.Logging;
|
||
using osu.Framework.Platform;
|
||
using osu.Framework.Threading;
|
||
using osu.Game.IO;
|
||
using osu.Game.IO.Archives;
|
||
using osu.Game.IPC;
|
||
using osu.Game.Overlays.Notifications;
|
||
using osu.Game.Utils;
|
||
using SharpCompress.Common;
|
||
using FileInfo = osu.Game.IO.FileInfo;
|
||
|
||
namespace osu.Game.Database
|
||
{
|
||
/// <summary>
|
||
/// Encapsulates a model store class to give it import functionality.
|
||
/// Adds cross-functionality with <see cref="FileStore"/> to give access to the central file store for the provided model.
|
||
/// </summary>
|
||
/// <typeparam name="TModel">The model type.</typeparam>
|
||
/// <typeparam name="TFileModel">The associated file join type.</typeparam>
|
||
public abstract class ArchiveModelManager<TModel, TFileModel> : ICanAcceptFiles, IModelManager<TModel>
|
||
where TModel : class, IHasFiles<TFileModel>, IHasPrimaryKey, ISoftDelete
|
||
where TFileModel : INamedFileInfo, new()
|
||
{
|
||
private const int import_queue_request_concurrency = 1;
|
||
|
||
/// <summary>
|
||
/// A singleton scheduler shared by all <see cref="ArchiveModelManager{TModel,TFileModel}"/>.
|
||
/// </summary>
|
||
/// <remarks>
|
||
/// This scheduler generally performs IO and CPU intensive work so concurrency is limited harshly.
|
||
/// It is mainly being used as a queue mechanism for large imports.
|
||
/// </remarks>
|
||
private static readonly ThreadedTaskScheduler import_scheduler = new ThreadedTaskScheduler(import_queue_request_concurrency, nameof(ArchiveModelManager<TModel, TFileModel>));
|
||
|
||
/// <summary>
|
||
/// Set an endpoint for notifications to be posted to.
|
||
/// </summary>
|
||
public Action<Notification> PostNotification { protected get; set; }
|
||
|
||
/// <summary>
|
||
/// Fired when a new <typeparamref name="TModel"/> becomes available in the database.
|
||
/// This is not guaranteed to run on the update thread.
|
||
/// </summary>
|
||
public event Action<TModel> ItemAdded;
|
||
|
||
/// <summary>
|
||
/// Fired when a <typeparamref name="TModel"/> is removed from the database.
|
||
/// This is not guaranteed to run on the update thread.
|
||
/// </summary>
|
||
public event Action<TModel> ItemRemoved;
|
||
|
||
public virtual string[] HandledExtensions => new[] { ".zip" };
|
||
|
||
public virtual bool SupportsImportFromStable => RuntimeInfo.IsDesktop;
|
||
|
||
protected readonly FileStore Files;
|
||
|
||
protected readonly IDatabaseContextFactory ContextFactory;
|
||
|
||
protected readonly MutableDatabaseBackedStore<TModel> ModelStore;
|
||
|
||
// ReSharper disable once NotAccessedField.Local (we should keep a reference to this so it is not finalised)
|
||
private ArchiveImportIPCChannel ipc;
|
||
|
||
protected ArchiveModelManager(Storage storage, IDatabaseContextFactory contextFactory, MutableDatabaseBackedStoreWithFileIncludes<TModel, TFileModel> modelStore, IIpcHost importHost = null)
|
||
{
|
||
ContextFactory = contextFactory;
|
||
|
||
ModelStore = modelStore;
|
||
ModelStore.ItemAdded += item => handleEvent(() => ItemAdded?.Invoke(item));
|
||
ModelStore.ItemRemoved += s => handleEvent(() => ItemRemoved?.Invoke(s));
|
||
|
||
Files = new FileStore(contextFactory, storage);
|
||
|
||
if (importHost != null)
|
||
ipc = new ArchiveImportIPCChannel(importHost, this);
|
||
|
||
ModelStore.Cleanup();
|
||
}
|
||
|
||
/// <summary>
|
||
/// Import one or more <typeparamref name="TModel"/> items from filesystem <paramref name="paths"/>.
|
||
/// This will post notifications tracking progress.
|
||
/// </summary>
|
||
/// <param name="paths">One or more archive locations on disk.</param>
|
||
public Task Import(params string[] paths)
|
||
{
|
||
var notification = new ProgressNotification { State = ProgressNotificationState.Active };
|
||
|
||
PostNotification?.Invoke(notification);
|
||
|
||
return Import(notification, paths);
|
||
}
|
||
|
||
protected async Task<IEnumerable<TModel>> Import(ProgressNotification notification, params string[] paths)
|
||
{
|
||
notification.Progress = 0;
|
||
notification.Text = $"{HumanisedModelName.Humanize(LetterCasing.Title)} import is initialising...";
|
||
|
||
int current = 0;
|
||
|
||
var imported = new List<TModel>();
|
||
|
||
await Task.WhenAll(paths.Select(async path =>
|
||
{
|
||
notification.CancellationToken.ThrowIfCancellationRequested();
|
||
|
||
try
|
||
{
|
||
var model = await Import(path, notification.CancellationToken);
|
||
|
||
lock (imported)
|
||
{
|
||
if (model != null)
|
||
imported.Add(model);
|
||
current++;
|
||
|
||
notification.Text = $"Imported {current} of {paths.Length} {HumanisedModelName}s";
|
||
notification.Progress = (float)current / paths.Length;
|
||
}
|
||
}
|
||
catch (TaskCanceledException)
|
||
{
|
||
throw;
|
||
}
|
||
catch (Exception e)
|
||
{
|
||
Logger.Error(e, $@"Could not import ({Path.GetFileName(path)})", LoggingTarget.Database);
|
||
}
|
||
}));
|
||
|
||
if (imported.Count == 0)
|
||
{
|
||
notification.Text = $"{HumanisedModelName.Humanize(LetterCasing.Title)} import failed!";
|
||
notification.State = ProgressNotificationState.Cancelled;
|
||
}
|
||
else
|
||
{
|
||
notification.CompletionText = imported.Count == 1
|
||
? $"Imported {imported.First()}!"
|
||
: $"Imported {imported.Count} {HumanisedModelName}s!";
|
||
|
||
if (imported.Count > 0 && PresentImport != null)
|
||
{
|
||
notification.CompletionText += " Click to view.";
|
||
notification.CompletionClickAction = () =>
|
||
{
|
||
PresentImport?.Invoke(imported);
|
||
return true;
|
||
};
|
||
}
|
||
|
||
notification.State = ProgressNotificationState.Completed;
|
||
}
|
||
|
||
return imported;
|
||
}
|
||
|
||
/// <summary>
|
||
/// Import one <typeparamref name="TModel"/> from the filesystem and delete the file on success.
|
||
/// </summary>
|
||
/// <param name="path">The archive location on disk.</param>
|
||
/// <param name="cancellationToken">An optional cancellation token.</param>
|
||
/// <returns>The imported model, if successful.</returns>
|
||
public async Task<TModel> Import(string path, CancellationToken cancellationToken = default)
|
||
{
|
||
cancellationToken.ThrowIfCancellationRequested();
|
||
|
||
TModel import;
|
||
using (ArchiveReader reader = getReaderFrom(path))
|
||
import = await Import(reader, cancellationToken);
|
||
|
||
// We may or may not want to delete the file depending on where it is stored.
|
||
// e.g. reconstructing/repairing database with items from default storage.
|
||
// Also, not always a single file, i.e. for LegacyFilesystemReader
|
||
// TODO: Add a check to prevent files from storage to be deleted.
|
||
try
|
||
{
|
||
if (import != null && File.Exists(path) && ShouldDeleteArchive(path))
|
||
File.Delete(path);
|
||
}
|
||
catch (Exception e)
|
||
{
|
||
LogForModel(import, $@"Could not delete original file after import ({Path.GetFileName(path)})", e);
|
||
}
|
||
|
||
return import;
|
||
}
|
||
|
||
/// <summary>
|
||
/// Fired when the user requests to view the resulting import.
|
||
/// </summary>
|
||
public Action<IEnumerable<TModel>> PresentImport;
|
||
|
||
/// <summary>
|
||
/// Import an item from an <see cref="ArchiveReader"/>.
|
||
/// </summary>
|
||
/// <param name="archive">The archive to be imported.</param>
|
||
/// <param name="cancellationToken">An optional cancellation token.</param>
|
||
public Task<TModel> Import(ArchiveReader archive, CancellationToken cancellationToken = default)
|
||
{
|
||
cancellationToken.ThrowIfCancellationRequested();
|
||
|
||
TModel model = null;
|
||
|
||
try
|
||
{
|
||
model = CreateModel(archive);
|
||
|
||
if (model == null) return Task.FromResult<TModel>(null);
|
||
|
||
model.Hash = computeHash(archive);
|
||
}
|
||
catch (TaskCanceledException)
|
||
{
|
||
throw;
|
||
}
|
||
catch (Exception e)
|
||
{
|
||
LogForModel(model, $"Model creation of {archive.Name} failed.", e);
|
||
return null;
|
||
}
|
||
|
||
return Import(model, archive, cancellationToken);
|
||
}
|
||
|
||
/// <summary>
|
||
/// Any file extensions which should be included in hash creation.
|
||
/// Generally should include all file types which determine the file's uniqueness.
|
||
/// Large files should be avoided if possible.
|
||
/// </summary>
|
||
protected abstract string[] HashableFileTypes { get; }
|
||
|
||
protected static void LogForModel(TModel model, string message, Exception e = null)
|
||
{
|
||
string prefix = $"[{(model?.Hash ?? "?????").Substring(0, 5)}]";
|
||
|
||
if (e != null)
|
||
Logger.Error(e, $"{prefix} {message}", LoggingTarget.Database);
|
||
else
|
||
Logger.Log($"{prefix} {message}", LoggingTarget.Database);
|
||
}
|
||
|
||
/// <summary>
|
||
/// Create a SHA-2 hash from the provided archive based on file content of all files matching <see cref="HashableFileTypes"/>.
|
||
/// </summary>
|
||
private string computeHash(ArchiveReader reader)
|
||
{
|
||
// for now, concatenate all .osu files in the set to create a unique hash.
|
||
MemoryStream hashable = new MemoryStream();
|
||
|
||
foreach (string file in reader.Filenames.Where(f => HashableFileTypes.Any(f.EndsWith)))
|
||
{
|
||
using (Stream s = reader.GetStream(file))
|
||
s.CopyTo(hashable);
|
||
}
|
||
|
||
return hashable.Length > 0 ? hashable.ComputeSHA2Hash() : null;
|
||
}
|
||
|
||
/// <summary>
|
||
/// Import an item from a <typeparamref name="TModel"/>.
|
||
/// </summary>
|
||
/// <param name="item">The model to be imported.</param>
|
||
/// <param name="archive">An optional archive to use for model population.</param>
|
||
/// <param name="cancellationToken">An optional cancellation token.</param>
|
||
public async Task<TModel> Import(TModel item, ArchiveReader archive = null, CancellationToken cancellationToken = default) => await Task.Factory.StartNew(async () =>
|
||
{
|
||
cancellationToken.ThrowIfCancellationRequested();
|
||
|
||
delayEvents();
|
||
|
||
void rollback()
|
||
{
|
||
if (!Delete(item))
|
||
{
|
||
// We may have not yet added the model to the underlying table, but should still clean up files.
|
||
LogForModel(item, "Dereferencing files for incomplete import.");
|
||
Files.Dereference(item.Files.Select(f => f.FileInfo).ToArray());
|
||
}
|
||
}
|
||
|
||
try
|
||
{
|
||
LogForModel(item, "Beginning import...");
|
||
|
||
item.Files = archive != null ? createFileInfos(archive, Files) : new List<TFileModel>();
|
||
|
||
await Populate(item, archive, cancellationToken);
|
||
|
||
using (var write = ContextFactory.GetForWrite()) // used to share a context for full import. keep in mind this will block all writes.
|
||
{
|
||
try
|
||
{
|
||
if (!write.IsTransactionLeader) throw new InvalidOperationException($"Ensure there is no parent transaction so errors can correctly be handled by {this}");
|
||
|
||
var existing = CheckForExisting(item);
|
||
|
||
if (existing != null)
|
||
{
|
||
if (CanUndelete(existing, item))
|
||
{
|
||
Undelete(existing);
|
||
LogForModel(item, $"Found existing {HumanisedModelName} for {item} (ID {existing.ID}) – skipping import.");
|
||
// existing item will be used; rollback new import and exit early.
|
||
rollback();
|
||
flushEvents(true);
|
||
return existing;
|
||
}
|
||
|
||
Delete(existing);
|
||
ModelStore.PurgeDeletable(s => s.ID == existing.ID);
|
||
}
|
||
|
||
PreImport(item);
|
||
|
||
// import to store
|
||
ModelStore.Add(item);
|
||
}
|
||
catch (Exception e)
|
||
{
|
||
write.Errors.Add(e);
|
||
throw;
|
||
}
|
||
}
|
||
|
||
LogForModel(item, "Import successfully completed!");
|
||
}
|
||
catch (Exception e)
|
||
{
|
||
if (!(e is TaskCanceledException))
|
||
LogForModel(item, "Database import or population failed and has been rolled back.", e);
|
||
|
||
rollback();
|
||
flushEvents(false);
|
||
throw;
|
||
}
|
||
|
||
flushEvents(true);
|
||
return item;
|
||
}, cancellationToken, TaskCreationOptions.HideScheduler, import_scheduler).Unwrap();
|
||
|
||
/// <summary>
|
||
/// Perform an update of the specified item.
|
||
/// TODO: Support file changes.
|
||
/// </summary>
|
||
/// <param name="item">The item to update.</param>
|
||
public void Update(TModel item) => ModelStore.Update(item);
|
||
|
||
/// <summary>
|
||
/// Delete an item from the manager.
|
||
/// Is a no-op for already deleted items.
|
||
/// </summary>
|
||
/// <param name="item">The item to delete.</param>
|
||
/// <returns>false if no operation was performed</returns>
|
||
public bool Delete(TModel item)
|
||
{
|
||
using (ContextFactory.GetForWrite())
|
||
{
|
||
// re-fetch the model on the import context.
|
||
var foundModel = queryModel().Include(s => s.Files).ThenInclude(f => f.FileInfo).FirstOrDefault(s => s.ID == item.ID);
|
||
|
||
if (foundModel == null || foundModel.DeletePending) return false;
|
||
|
||
if (ModelStore.Delete(foundModel))
|
||
Files.Dereference(foundModel.Files.Select(f => f.FileInfo).ToArray());
|
||
return true;
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// Delete multiple items.
|
||
/// This will post notifications tracking progress.
|
||
/// </summary>
|
||
public void Delete(List<TModel> items, bool silent = false)
|
||
{
|
||
if (items.Count == 0) return;
|
||
|
||
var notification = new ProgressNotification
|
||
{
|
||
Progress = 0,
|
||
Text = $"Preparing to delete all {HumanisedModelName}s...",
|
||
CompletionText = $"Deleted all {HumanisedModelName}s!",
|
||
State = ProgressNotificationState.Active,
|
||
};
|
||
|
||
if (!silent)
|
||
PostNotification?.Invoke(notification);
|
||
|
||
int i = 0;
|
||
|
||
foreach (var b in items)
|
||
{
|
||
if (notification.State == ProgressNotificationState.Cancelled)
|
||
// user requested abort
|
||
return;
|
||
|
||
notification.Text = $"Deleting {HumanisedModelName}s ({++i} of {items.Count})";
|
||
|
||
Delete(b);
|
||
|
||
notification.Progress = (float)i / items.Count;
|
||
}
|
||
|
||
notification.State = ProgressNotificationState.Completed;
|
||
}
|
||
|
||
/// <summary>
|
||
/// Restore multiple items that were previously deleted.
|
||
/// This will post notifications tracking progress.
|
||
/// </summary>
|
||
public void Undelete(List<TModel> items, bool silent = false)
|
||
{
|
||
if (!items.Any()) return;
|
||
|
||
var notification = new ProgressNotification
|
||
{
|
||
CompletionText = "Restored all deleted items!",
|
||
Progress = 0,
|
||
State = ProgressNotificationState.Active,
|
||
};
|
||
|
||
if (!silent)
|
||
PostNotification?.Invoke(notification);
|
||
|
||
int i = 0;
|
||
|
||
foreach (var item in items)
|
||
{
|
||
if (notification.State == ProgressNotificationState.Cancelled)
|
||
// user requested abort
|
||
return;
|
||
|
||
notification.Text = $"Restoring ({++i} of {items.Count})";
|
||
|
||
Undelete(item);
|
||
|
||
notification.Progress = (float)i / items.Count;
|
||
}
|
||
|
||
notification.State = ProgressNotificationState.Completed;
|
||
}
|
||
|
||
/// <summary>
|
||
/// Restore an item that was previously deleted. Is a no-op if the item is not in a deleted state, or has its protected flag set.
|
||
/// </summary>
|
||
/// <param name="item">The item to restore</param>
|
||
public void Undelete(TModel item)
|
||
{
|
||
using (var usage = ContextFactory.GetForWrite())
|
||
{
|
||
usage.Context.ChangeTracker.AutoDetectChangesEnabled = false;
|
||
|
||
if (!ModelStore.Undelete(item)) return;
|
||
|
||
Files.Reference(item.Files.Select(f => f.FileInfo).ToArray());
|
||
|
||
usage.Context.ChangeTracker.AutoDetectChangesEnabled = true;
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// Create all required <see cref="FileInfo"/>s for the provided archive, adding them to the global file store.
|
||
/// </summary>
|
||
private List<TFileModel> createFileInfos(ArchiveReader reader, FileStore files)
|
||
{
|
||
var fileInfos = new List<TFileModel>();
|
||
|
||
string prefix = reader.Filenames.GetCommonPrefix();
|
||
if (!(prefix.EndsWith("/") || prefix.EndsWith("\\")))
|
||
prefix = string.Empty;
|
||
|
||
// import files to manager
|
||
foreach (string file in reader.Filenames)
|
||
{
|
||
using (Stream s = reader.GetStream(file))
|
||
{
|
||
fileInfos.Add(new TFileModel
|
||
{
|
||
Filename = file.Substring(prefix.Length).ToStandardisedPath(),
|
||
FileInfo = files.Add(s)
|
||
});
|
||
}
|
||
}
|
||
|
||
return fileInfos;
|
||
}
|
||
|
||
#region osu-stable import
|
||
|
||
/// <summary>
|
||
/// Set a storage with access to an osu-stable install for import purposes.
|
||
/// </summary>
|
||
public Func<Storage> GetStableStorage { private get; set; }
|
||
|
||
/// <summary>
|
||
/// Denotes whether an osu-stable installation is present to perform automated imports from.
|
||
/// </summary>
|
||
public bool StableInstallationAvailable => GetStableStorage?.Invoke() != null;
|
||
|
||
/// <summary>
|
||
/// The relative path from osu-stable's data directory to import items from.
|
||
/// </summary>
|
||
protected virtual string ImportFromStablePath => null;
|
||
|
||
/// <summary>
|
||
/// Select paths to import from stable. Default implementation iterates all directories in <see cref="ImportFromStablePath"/>.
|
||
/// </summary>
|
||
protected virtual IEnumerable<string> GetStableImportPaths(Storage stableStoage) => stableStoage.GetDirectories(ImportFromStablePath);
|
||
|
||
/// <summary>
|
||
/// Whether this specified path should be removed after successful import.
|
||
/// </summary>
|
||
/// <param name="path">The path for consideration. May be a file or a directory.</param>
|
||
/// <returns>Whether to perform deletion.</returns>
|
||
protected virtual bool ShouldDeleteArchive(string path) => false;
|
||
|
||
/// <summary>
|
||
/// This is a temporary method and will likely be replaced by a full-fledged (and more correctly placed) migration process in the future.
|
||
/// </summary>
|
||
public Task ImportFromStableAsync()
|
||
{
|
||
var stable = GetStableStorage?.Invoke();
|
||
|
||
if (stable == null)
|
||
{
|
||
Logger.Log("No osu!stable installation available!", LoggingTarget.Information, LogLevel.Error);
|
||
return Task.CompletedTask;
|
||
}
|
||
|
||
if (!stable.ExistsDirectory(ImportFromStablePath))
|
||
{
|
||
// This handles situations like when the user does not have a Skins folder
|
||
Logger.Log($"No {ImportFromStablePath} folder available in osu!stable installation", LoggingTarget.Information, LogLevel.Error);
|
||
return Task.CompletedTask;
|
||
}
|
||
|
||
return Task.Run(async () => await Import(GetStableImportPaths(GetStableStorage()).Select(f => stable.GetFullPath(f)).ToArray()));
|
||
}
|
||
|
||
#endregion
|
||
|
||
/// <summary>
|
||
/// Create a barebones model from the provided archive.
|
||
/// Actual expensive population should be done in <see cref="Populate"/>; this should just prepare for duplicate checking.
|
||
/// </summary>
|
||
/// <param name="archive">The archive to create the model for.</param>
|
||
/// <returns>A model populated with minimal information. Returning a null will abort importing silently.</returns>
|
||
protected abstract TModel CreateModel(ArchiveReader archive);
|
||
|
||
/// <summary>
|
||
/// Populate the provided model completely from the given archive.
|
||
/// After this method, the model should be in a state ready to commit to a store.
|
||
/// </summary>
|
||
/// <param name="model">The model to populate.</param>
|
||
/// <param name="archive">The archive to use as a reference for population. May be null.</param>
|
||
/// <param name="cancellationToken">An optional cancellation token.</param>
|
||
protected virtual Task Populate(TModel model, [CanBeNull] ArchiveReader archive, CancellationToken cancellationToken = default) => Task.CompletedTask;
|
||
|
||
/// <summary>
|
||
/// Perform any final actions before the import to database executes.
|
||
/// </summary>
|
||
/// <param name="model">The model prepared for import.</param>
|
||
protected virtual void PreImport(TModel model)
|
||
{
|
||
}
|
||
|
||
/// <summary>
|
||
/// Check whether an existing model already exists for a new import item.
|
||
/// </summary>
|
||
/// <param name="model">The new model proposed for import.</param>
|
||
/// <returns>An existing model which matches the criteria to skip importing, else null.</returns>
|
||
protected TModel CheckForExisting(TModel model) => model.Hash == null ? null : ModelStore.ConsumableItems.FirstOrDefault(b => b.Hash == model.Hash);
|
||
|
||
/// <summary>
|
||
/// After an existing <typeparamref name="TModel"/> is found during an import process, the default behaviour is to restore the existing
|
||
/// item and skip the import. This method allows changing that behaviour.
|
||
/// </summary>
|
||
/// <param name="existing">The existing model.</param>
|
||
/// <param name="import">The newly imported model.</param>
|
||
/// <returns>Whether the existing model should be restored and used. Returning false will delete the existing and force a re-import.</returns>
|
||
protected virtual bool CanUndelete(TModel existing, TModel import) => true;
|
||
|
||
private DbSet<TModel> queryModel() => ContextFactory.Get().Set<TModel>();
|
||
|
||
protected virtual string HumanisedModelName => $"{typeof(TModel).Name.Replace("Info", "").ToLower()}";
|
||
|
||
/// <summary>
|
||
/// Creates an <see cref="ArchiveReader"/> from a valid storage path.
|
||
/// </summary>
|
||
/// <param name="path">A file or folder path resolving the archive content.</param>
|
||
/// <returns>A reader giving access to the archive's content.</returns>
|
||
private ArchiveReader getReaderFrom(string path)
|
||
{
|
||
if (ZipUtils.IsZipArchive(path))
|
||
return new ZipArchiveReader(File.Open(path, FileMode.Open, FileAccess.Read, FileShare.Read), Path.GetFileName(path));
|
||
if (Directory.Exists(path))
|
||
return new LegacyDirectoryArchiveReader(path);
|
||
if (File.Exists(path))
|
||
return new LegacyFileArchiveReader(path);
|
||
|
||
throw new InvalidFormatException($"{path} is not a valid archive");
|
||
}
|
||
|
||
#region Event handling / delaying
|
||
|
||
private readonly List<Action> queuedEvents = new List<Action>();
|
||
|
||
/// <summary>
|
||
/// Allows delaying of outwards events until an operation is confirmed (at a database level).
|
||
/// </summary>
|
||
private bool delayingEvents;
|
||
|
||
/// <summary>
|
||
/// Begin delaying outwards events.
|
||
/// </summary>
|
||
private void delayEvents() => delayingEvents = true;
|
||
|
||
/// <summary>
|
||
/// Flush delayed events and disable delaying.
|
||
/// </summary>
|
||
/// <param name="perform">Whether the flushed events should be performed.</param>
|
||
private void flushEvents(bool perform)
|
||
{
|
||
Action[] events;
|
||
|
||
lock (queuedEvents)
|
||
{
|
||
events = queuedEvents.ToArray();
|
||
queuedEvents.Clear();
|
||
}
|
||
|
||
if (perform)
|
||
{
|
||
foreach (var a in events)
|
||
a.Invoke();
|
||
}
|
||
|
||
delayingEvents = false;
|
||
}
|
||
|
||
private void handleEvent(Action a)
|
||
{
|
||
if (delayingEvents)
|
||
{
|
||
lock (queuedEvents)
|
||
queuedEvents.Add(a);
|
||
}
|
||
else
|
||
a.Invoke();
|
||
}
|
||
|
||
#endregion
|
||
}
|
||
}
|