SettingsStorage class¶

Summary¶

View source

Provides a base class for implementing observable application settings storage using Akavache. Each property is exposed as a live IObservable backed by a SettingsStream — subscribers see the current value immediately, are updated on every write, and never block the calling thread. Persistence goes through the underlying IBlobCache asynchronously.

classDiagram
class SettingsStorage
class ISettingsStorage {
    <>
}
ISettingsStorage <|.. SettingsStorage
class INotifyPropertyChanged {
    <>
}
INotifyPropertyChanged <|.. SettingsStorage
class IDisposable {
    <>
}
IDisposable <|.. SettingsStorage

Implements: ISettingsStorage, INotifyPropertyChanged, IDisposable

Remarks¶

This is a deliberate break from the earlier GetOrCreate<T>/SetOrCreate<T> sync getter pattern. That model called .Wait() on the underlying blob cache's observable chain — a synchronous bridge that deadlocked (and occasionally crashed natively) against async backends like the worker-thread sqlite queue. The observable shape fits Akavache's core API and eliminates the whole class of .Wait() hazards from settings code.

Typical derived class:

public sealed class MySettings : SettingsBase
 {
 public MySettings() : base(nameof(MySettings)) { }
 
 public IObservable<bool> Enabled => GetOrCreateObservable(true);
 
 public IObservable<Unit> SetEnabled(bool value) =>
 SetObservable(value, nameof(Enabled));
 }

Callers subscribe to Enabled to receive the current value + any future updates, or call await settings.Enabled.FirstAsync() for a one-shot read.

Constructors¶

Methods¶

Events¶

Derived types¶

• SettingsBase