Skip to content
Project referenceDevelopmentEngine ccf7d03f
Authored
  • Select application storage through explicit provider registrations and logical scopes.

This project defines the storage adapter family without choosing filesystem paths. Composition supplies providers; IStorageBackendFactory resolves a selected backend and logical StorageScope into a caller-owned IApplicationStorage.

StorageBackendId is an open ordinal string identity without whitespace. The default struct is unassigned. Built-in fileSystem and browser IDs support standard composition; third-party providers do not need a new enum member or a central branch.

StorageBackendProvider is an immutable registration descriptor with a protected construction boundary and a CreateStorage extension point. It does not scan assemblies. If another extension mechanism discovers source types, that mechanism owns its attributes and discovery protocol.

StorageBackendCatalog captures the supplied registration set. Null providers, duplicate IDs and invalid registrations fail at construction. supportedBackends supports capability preflight. Creation resolves an exact ID, rejects an unregistered backend and rejects a provider’s null result. AdapterSelection.Validate can preflight the domain catalogs before initializing windows or devices.

The composition owner retains provider resources and delegates; the catalog does not take ownership of them. Each returned service belongs to its caller, typically the runtime subsystem that tracks its asynchronous work.

Providers receive a logical namespace. Their host configuration selects the physical location or platform store. Scripts continue to use keys and IApplicationStorage, never a physical root or the filesystem implementation type. Unknown backends, invalid scopes and initialization failures remain explicit composition/startup failures.

The filesystem provider requires an explicit absolute host root. Browser storage is a separate platform implementation with its own environment requirements. Registration is not evidence that either environment has been executed or certified.

Read save and load application data for service consumption and runtime storage ownership before transferring a backend.

The exact reference describes IDs, provider extension points, catalog validation and factory contracts.

Browse storage adapter types.

Project: Inno.Adapter.Storage
Source: src/adapters/storage/Inno.Adapter.Storage/Inno.Adapter.Storage.csproj

Type API Description
IStorageBackendFactory engine Creates isolated application-storage instances from explicit backend selections.
StorageBackendCatalog engine Resolves storage providers from one immutable, composition-owned registration snapshot.
StorageBackendId engine Identifies a storage implementation without closing the set of supported backends.
StorageBackendProvider engine Describes one explicitly composed storage implementation and its creation boundary.