osu/osu.Game/Database/LegacyExporter.cs

133 lines
6.2 KiB
C#
Raw Normal View History

2022-11-17 14:38:24 +00:00
// 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;
2022-11-18 16:02:35 +00:00
using System.IO;
2022-11-17 14:38:24 +00:00
using System.Linq;
using System.Threading;
2022-11-17 14:38:24 +00:00
using System.Threading.Tasks;
using osu.Framework.Platform;
using osu.Game.Extensions;
using osu.Game.Overlays.Notifications;
using osu.Game.Utils;
2022-11-17 14:38:24 +00:00
using Realms;
namespace osu.Game.Database
{
/// <summary>
/// Handles exporting models to files for sharing / consumption outside the game.
2022-11-17 14:38:24 +00:00
/// </summary>
public abstract class LegacyExporter<TModel>
where TModel : RealmObject, IHasNamedFiles, IHasGuidPrimaryKey
2022-11-17 14:38:24 +00:00
{
/// <summary>
/// Max length of filename (including extension).
/// </summary>
/// <remarks>
/// <para>
/// The filename limit for most OSs is 255. This actual usable length is smaller because <see cref="Storage.CreateFileSafely(string)"/> adds an additional "_<see cref="Guid"/>" to the end of the path.
/// </para>
/// <para>
/// For more information see <see href="https://www.ibm.com/docs/en/spectrum-protect/8.1.9?topic=parameters-file-specification-syntax">file specification syntax</see>, <seealso href="https://en.wikipedia.org/wiki/Comparison_of_file_systems#Limits">file systems limitations</seealso>
/// </para>
/// </remarks>
public const int MAX_FILENAME_LENGTH = 255 - (32 + 4 + 2 + 5); //max path - (Guid + Guid "D" format chars + Storage.CreateFileSafely chars + account for ' (99)' suffix)
2022-11-17 14:38:24 +00:00
/// <summary>
/// The file extension for exports (including the leading '.').
/// </summary>
protected abstract string FileExtension { get; }
protected readonly Storage UserFileStorage;
private readonly Storage exportStorage;
2022-11-17 14:38:24 +00:00
public Action<Notification>? PostNotification { get; set; }
protected LegacyExporter(Storage storage)
2022-11-17 14:38:24 +00:00
{
exportStorage = storage.GetStorageForDirectory(@"exports");
2022-11-17 14:38:24 +00:00
UserFileStorage = storage.GetStorageForDirectory(@"files");
}
/// <summary>
/// Returns the baseline name of the file to which the <paramref name="item"/> will be exported.
/// </summary>
/// <remarks>
/// The name of the file will be run through <see cref="ModelExtensions.GetValidFilename"/> to eliminate characters
/// which are not permitted by various filesystems.
/// </remarks>
/// <param name="item">The item being exported.</param>
protected virtual string GetFilename(TModel item) => item.GetDisplayString();
2022-11-21 10:04:05 +00:00
/// <summary>
2023-05-06 14:53:35 +00:00
/// Exports a model to the default export location.
/// This will create a notification tracking the progress of the export, visible to the user.
2022-11-21 10:04:05 +00:00
/// </summary>
2023-05-06 14:53:35 +00:00
/// <param name="model">The model to export.</param>
/// <param name="cancellationToken">A cancellation token.</param>
public async Task ExportAsync(Live<TModel> model, CancellationToken cancellationToken = default)
2022-11-17 14:38:24 +00:00
{
string itemFilename = model.PerformRead(s => GetFilename(s).GetValidFilename());
if (itemFilename.Length > MAX_FILENAME_LENGTH - FileExtension.Length)
itemFilename = itemFilename.Remove(MAX_FILENAME_LENGTH - FileExtension.Length);
IEnumerable<string> existingExports = exportStorage
.GetFiles(string.Empty, $"{itemFilename}*{FileExtension}")
.Concat(exportStorage.GetDirectories(string.Empty));
string filename = NamingUtils.GetNextBestFilename(existingExports, $"{itemFilename}{FileExtension}");
ProgressNotification notification = new ProgressNotification
{
State = ProgressNotificationState.Active,
Text = $"Exporting {itemFilename}...",
};
PostNotification?.Invoke(notification);
2023-05-05 12:08:01 +00:00
using var linkedSource = CancellationTokenSource.CreateLinkedTokenSource(cancellationToken, notification.CancellationToken);
2023-02-18 16:45:09 +00:00
try
2022-12-09 15:43:03 +00:00
{
2023-02-18 16:45:09 +00:00
using (var stream = exportStorage.CreateFileSafely(filename))
{
2023-05-05 12:08:01 +00:00
await ExportToStreamAsync(model, stream, notification, linkedSource.Token).ConfigureAwait(false);
2023-02-18 16:45:09 +00:00
}
}
2023-04-09 06:09:18 +00:00
catch
2023-02-18 16:45:09 +00:00
{
2023-04-09 06:09:18 +00:00
notification.State = ProgressNotificationState.Cancelled;
// cleanup if export is failed or canceled.
2023-02-26 06:28:24 +00:00
exportStorage.Delete(filename);
throw;
2023-02-26 06:28:24 +00:00
}
notification.CompletionText = $"Exported {itemFilename}! Click to view.";
notification.CompletionClickAction = () => exportStorage.PresentFileExternally(filename);
notification.State = ProgressNotificationState.Completed;
}
2022-11-21 10:04:05 +00:00
/// <summary>
2023-05-06 14:53:35 +00:00
/// Exports a model to a provided stream.
2022-11-21 10:04:05 +00:00
/// </summary>
2023-05-06 14:53:35 +00:00
/// <param name="model">The model to export.</param>
/// <param name="outputStream">The output stream to export to.</param>
/// <param name="notification">An optional notification to be updated with export progress.</param>
/// <param name="cancellationToken">A cancellation token.</param>
public Task ExportToStreamAsync(Live<TModel> model, Stream outputStream, ProgressNotification? notification = null, CancellationToken cancellationToken = default) =>
Task.Run(() => { model.PerformRead(s => ExportToStream(s, outputStream, notification, cancellationToken)); }, cancellationToken);
2022-11-18 16:02:35 +00:00
2022-12-11 07:55:44 +00:00
/// <summary>
2023-05-06 14:53:35 +00:00
/// Exports a model to a provided stream.
2022-12-11 07:55:44 +00:00
/// </summary>
/// <param name="model">The model to export.</param>
2022-12-11 07:55:44 +00:00
/// <param name="outputStream">The output stream to export to.</param>
2023-05-06 14:53:35 +00:00
/// <param name="notification">An optional notification to be updated with export progress.</param>
/// <param name="cancellationToken">A cancellation token.</param>
2023-05-05 12:28:43 +00:00
public abstract void ExportToStream(TModel model, Stream outputStream, ProgressNotification? notification, CancellationToken cancellationToken = default);
2022-12-15 12:39:48 +00:00
}
2022-11-17 14:38:24 +00:00
}