// Copyright (c) ppy Pty Ltd . Licensed under the MIT Licence. // See the LICENCE file in the repository root for full licence text. #nullable disable using System; using System.Collections.Generic; using System.Collections.Specialized; using System.IO; using System.Linq; using System.Threading; using System.Threading.Tasks; using osu.Framework.Allocation; using osu.Framework.Bindables; using osu.Framework.Graphics; using osu.Framework.Logging; using osu.Framework.Platform; using osu.Game.Database; using osu.Game.IO; using osu.Game.IO.Legacy; using osu.Game.Overlays.Notifications; namespace osu.Game.Collections { /// /// Handles user-defined collections of beatmaps. /// /// /// This is currently reading and writing from the osu-stable file format. This is a temporary arrangement until we refactor the /// database backing the game. Going forward writing should be done in a similar way to other model stores. /// public class CollectionManager : Component, IPostNotifications { /// /// Database version in stable-compatible YYYYMMDD format. /// private const int database_version = 30000000; private const string database_name = "collection.db"; private const string database_backup_name = "collection.db.bak"; public readonly BindableList Collections = new BindableList(); private readonly Storage storage; public CollectionManager(Storage storage) { this.storage = storage; } [Resolved(canBeNull: true)] private DatabaseContextFactory efContextFactory { get; set; } = null!; [BackgroundDependencyLoader] private void load() { efContextFactory?.WaitForMigrationCompletion(); Collections.CollectionChanged += collectionsChanged; if (storage.Exists(database_backup_name)) { // If a backup file exists, it means the previous write operation didn't run to completion. // Always prefer the backup file in such a case as it's the most recent copy that is guaranteed to not be malformed. // // The database is saved 100ms after any change, and again when the game is closed, so there shouldn't be a large diff between the two files in the worst case. if (storage.Exists(database_name)) storage.Delete(database_name); File.Copy(storage.GetFullPath(database_backup_name), storage.GetFullPath(database_name)); } if (storage.Exists(database_name)) { List beatmapCollections; using (var stream = storage.GetStream(database_name)) beatmapCollections = readCollections(stream); // intentionally fire-and-forget async. importCollections(beatmapCollections); } } private void collectionsChanged(object sender, NotifyCollectionChangedEventArgs e) => Schedule(() => { switch (e.Action) { case NotifyCollectionChangedAction.Add: foreach (var c in e.NewItems.Cast()) c.Changed += backgroundSave; break; case NotifyCollectionChangedAction.Remove: foreach (var c in e.OldItems.Cast()) c.Changed -= backgroundSave; break; case NotifyCollectionChangedAction.Replace: foreach (var c in e.OldItems.Cast()) c.Changed -= backgroundSave; foreach (var c in e.NewItems.Cast()) c.Changed += backgroundSave; break; } backgroundSave(); }); public Action PostNotification { protected get; set; } public Task GetAvailableCount(StableStorage stableStorage) { if (!stableStorage.Exists(database_name)) return Task.FromResult(0); return Task.Run(() => { using (var stream = stableStorage.GetStream(database_name)) return readCollections(stream).Count; }); } /// /// This is a temporary method and will likely be replaced by a full-fledged (and more correctly placed) migration process in the future. /// public Task ImportFromStableAsync(StableStorage stableStorage) { if (!stableStorage.Exists(database_name)) { // This handles situations like when the user does not have a collections.db file Logger.Log($"No {database_name} available in osu!stable installation", LoggingTarget.Information, LogLevel.Error); return Task.CompletedTask; } return Task.Run(async () => { using (var stream = stableStorage.GetStream(database_name)) await Import(stream).ConfigureAwait(false); }); } public async Task Import(Stream stream) { var notification = new ProgressNotification { State = ProgressNotificationState.Active, Text = "Collections import is initialising..." }; PostNotification?.Invoke(notification); var collections = readCollections(stream, notification); await importCollections(collections).ConfigureAwait(false); notification.CompletionText = $"Imported {collections.Count} collections"; notification.State = ProgressNotificationState.Completed; } private Task importCollections(List newCollections) { var tcs = new TaskCompletionSource(); Schedule(() => { try { foreach (var newCol in newCollections) { var existing = Collections.FirstOrDefault(c => c.Name.Value == newCol.Name.Value); if (existing == null) Collections.Add(existing = new BeatmapCollection { Name = { Value = newCol.Name.Value } }); foreach (string newBeatmap in newCol.BeatmapHashes) { if (!existing.BeatmapHashes.Contains(newBeatmap)) existing.BeatmapHashes.Add(newBeatmap); } } tcs.SetResult(true); } catch (Exception e) { Logger.Error(e, "Failed to import collection."); tcs.SetException(e); } }); return tcs.Task; } private List readCollections(Stream stream, ProgressNotification notification = null) { if (notification != null) { notification.Text = "Reading collections..."; notification.Progress = 0; } var result = new List(); try { using (var sr = new SerializationReader(stream)) { sr.ReadInt32(); // Version int collectionCount = sr.ReadInt32(); result.Capacity = collectionCount; for (int i = 0; i < collectionCount; i++) { if (notification?.CancellationToken.IsCancellationRequested == true) return result; var collection = new BeatmapCollection { Name = { Value = sr.ReadString() } }; int mapCount = sr.ReadInt32(); for (int j = 0; j < mapCount; j++) { if (notification?.CancellationToken.IsCancellationRequested == true) return result; string checksum = sr.ReadString(); collection.BeatmapHashes.Add(checksum); } if (notification != null) { notification.Text = $"Imported {i + 1} of {collectionCount} collections"; notification.Progress = (float)(i + 1) / collectionCount; } result.Add(collection); } } } catch (Exception e) { Logger.Error(e, "Failed to read collection database."); } return result; } public void DeleteAll() { Collections.Clear(); PostNotification?.Invoke(new ProgressCompletionNotification { Text = "Deleted all collections!" }); } private readonly object saveLock = new object(); private int lastSave; private int saveFailures; /// /// Perform a save with debounce. /// private void backgroundSave() { int current = Interlocked.Increment(ref lastSave); Task.Delay(100).ContinueWith(task => { if (current != lastSave) return; if (!save()) backgroundSave(); }); } private bool save() { lock (saveLock) { Interlocked.Increment(ref lastSave); // This is NOT thread-safe!! try { string tempPath = Path.GetTempFileName(); using (var ms = new MemoryStream()) { using (var sw = new SerializationWriter(ms, true)) { sw.Write(database_version); var collectionsCopy = Collections.ToArray(); sw.Write(collectionsCopy.Length); foreach (var c in collectionsCopy) { sw.Write(c.Name.Value); string[] beatmapsCopy = c.BeatmapHashes.ToArray(); sw.Write(beatmapsCopy.Length); foreach (string b in beatmapsCopy) sw.Write(b); } } using (var fs = File.OpenWrite(tempPath)) ms.WriteTo(fs); string databasePath = storage.GetFullPath(database_name); string databaseBackupPath = storage.GetFullPath(database_backup_name); // Back up the existing database, clearing any existing backup. if (File.Exists(databaseBackupPath)) File.Delete(databaseBackupPath); if (File.Exists(databasePath)) File.Move(databasePath, databaseBackupPath); // Move the new database in-place of the existing one. File.Move(tempPath, databasePath); // If everything succeeded up to this point, remove the backup file. if (File.Exists(databaseBackupPath)) File.Delete(databaseBackupPath); } if (saveFailures < 10) saveFailures = 0; return true; } catch (Exception e) { // Since this code is not thread-safe, we may run into random exceptions (such as collection enumeration or out of range indexing). // Failures are thus only alerted if they exceed a threshold (once) to indicate "actual" errors having occurred. if (++saveFailures == 10) Logger.Error(e, "Failed to save collection database!"); } return false; } } protected override void Dispose(bool isDisposing) { base.Dispose(isDisposing); save(); } } }