// Copyright (c) ppy Pty Ltd . Licensed under the MIT Licence. // See the LICENCE file in the repository root for full licence text. using System; using System.Threading; using osu.Framework.Allocation; using osu.Framework.Graphics; using osu.Framework.Logging; using osu.Framework.Platform; using osu.Framework.Statistics; using osu.Game.Input.Bindings; using Realms; namespace osu.Game.Database { public class RealmContextFactory : Component, IRealmFactory { private readonly Storage storage; private const string database_name = @"client"; private const int schema_version = 6; /// /// Lock object which is held for the duration of a write operation (via ). /// private readonly object writeLock = new object(); /// /// Lock object which is held during sections. /// private readonly SemaphoreSlim blockingLock = new SemaphoreSlim(1); private static readonly GlobalStatistic reads = GlobalStatistics.Get("Realm", "Get (Read)"); private static readonly GlobalStatistic writes = GlobalStatistics.Get("Realm", "Get (Write)"); private static readonly GlobalStatistic refreshes = GlobalStatistics.Get("Realm", "Dirty Refreshes"); private static readonly GlobalStatistic contexts_created = GlobalStatistics.Get("Realm", "Contexts (Created)"); private static readonly GlobalStatistic pending_writes = GlobalStatistics.Get("Realm", "Pending writes"); private static readonly GlobalStatistic active_usages = GlobalStatistics.Get("Realm", "Active usages"); private Realm context; public Realm Context { get { if (context == null) { context = createContext(); Logger.Log($"Opened realm \"{context.Config.DatabasePath}\" at version {context.Config.SchemaVersion}"); } // creating a context will ensure our schema is up-to-date and migrated. return context; } } public RealmContextFactory(Storage storage) { this.storage = storage; } public RealmUsage GetForRead() { reads.Value++; return new RealmUsage(createContext()); } public RealmWriteUsage GetForWrite() { writes.Value++; pending_writes.Value++; Monitor.Enter(writeLock); return new RealmWriteUsage(createContext(), writeComplete); } /// /// Flush any active contexts and block any further writes. /// /// /// This should be used in places we need to ensure no ongoing reads/writes are occurring with realm. /// ie. to move the realm backing file to a new location. /// /// An which should be disposed to end the blocking section. public IDisposable BlockAllOperations() { if (IsDisposed) throw new ObjectDisposedException(nameof(RealmContextFactory)); blockingLock.Wait(); flushContexts(); return new InvokeOnDisposal(this, endBlockingSection); static void endBlockingSection(RealmContextFactory factory) => factory.blockingLock.Release(); } protected override void Update() { base.Update(); if (context?.Refresh() == true) refreshes.Value++; } private Realm createContext() { try { if (IsDisposed) throw new ObjectDisposedException(nameof(RealmContextFactory)); blockingLock.Wait(); contexts_created.Value++; return Realm.GetInstance(new RealmConfiguration(storage.GetFullPath($"{database_name}.realm", true)) { SchemaVersion = schema_version, MigrationCallback = onMigration, }); } finally { blockingLock.Release(); } } private void writeComplete() { Monitor.Exit(writeLock); pending_writes.Value--; } private void onMigration(Migration migration, ulong lastSchemaVersion) { switch (lastSchemaVersion) { case 5: // let's keep things simple. changing the type of the primary key is a bit involved. migration.NewRealm.RemoveAll(); break; } } private void flushContexts() { var previousContext = context; context = null; // wait for all threaded usages to finish while (active_usages.Value > 0) Thread.Sleep(50); previousContext?.Dispose(); } protected override void Dispose(bool isDisposing) { if (!IsDisposed) { // intentionally block all operations indefinitely. this ensures that nothing can start consuming a new context after disposal. BlockAllOperations(); blockingLock?.Dispose(); } base.Dispose(isDisposing); } /// /// A usage of realm from an arbitrary thread. /// public class RealmUsage : IDisposable { public readonly Realm Realm; internal RealmUsage(Realm context) { active_usages.Value++; Realm = context; } /// /// Disposes this instance, calling the initially captured action. /// public virtual void Dispose() { Realm?.Dispose(); active_usages.Value--; } } /// /// A transaction used for making changes to realm data. /// public class RealmWriteUsage : RealmUsage { private readonly Action onWriteComplete; private readonly Transaction transaction; internal RealmWriteUsage(Realm context, Action onWriteComplete) : base(context) { this.onWriteComplete = onWriteComplete; transaction = Realm.BeginWrite(); } /// /// Commit all changes made in this transaction. /// public void Commit() => transaction.Commit(); /// /// Revert all changes made in this transaction. /// public void Rollback() => transaction.Rollback(); /// /// Disposes this instance, calling the initially captured action. /// public override void Dispose() { // rollback if not explicitly committed. transaction?.Dispose(); base.Dispose(); onWriteComplete(); } } } }