WopiHost.FileSystemProvider 8.0.0

WopiHost.FileSystemProvider

Reference implementation of IWopiStorageProvider and IWopiWritableStorageProvider backed by a local directory tree. Identifiers are short opaque strings cached in-memory and mapped to absolute paths.

Suitable for development, validator runs, and single-instance deployments. Storage only — token issuance and ACLs live in WopiHost.Core.

Install

dotnet add package WopiHost.FileSystemProvider

Configure

// appsettings.json
"Wopi": {
  "StorageProvider": {
    "RootPath": "./wopi-docs"   // absolute or relative to ContentRootPath
  }
}

RootPath is bound from the Wopi:StorageProvider section (WopiFileSystemProviderOptions.SectionName).

Register

builder.Services.AddFileSystemStorageProvider(builder.Configuration);
builder.Services.AddWopi(o =>
{
    o.ClientUrl = new Uri("https://your-office-online-server.com");
});

AddFileSystemStorageProvider registers WopiFileSystemProvider as both IWopiStorageProvider and IWopiWritableStorageProvider (one shared instance per scope) plus the singleton InMemoryFileIds map the provider uses for path↔id round-tripping. The runnable sample drives all of this through a sample-local Sample:StorageProvider discriminator — see sample/WopiHost/Program.cs.

How identifiers work

Identifiers are short tokens generated by InMemoryFileIds on first scan and reused for the lifetime of the process. They are NOT base64-encoded paths; consumers should treat them as opaque strings. Lookup is O(1) in both directions; the cache is rebuilt at startup if RootPath changes.

A consequence of this design: identifiers are stable within a process but not across restarts. Persist your own mapping if you need long-lived URLs.

Customize

To layer behavior — versioning, audit, soft-delete — wrap the provider via composition. The concrete class' interface methods are non-virtual, so a decorator is the cleanest seam:

public class AuditingStorageProvider(IWopiWritableStorageProvider inner, IAuditLog audit)
    : IWopiWritableStorageProvider
{
    public async Task<bool> DeleteWopiFile(string id, CancellationToken ct = default)
    {
        var deleted = await inner.DeleteWopiFile(id, ct);
        if (deleted) audit.Log($"deleted file {id}");
        return deleted;
    }

    public async Task<bool> DeleteWopiContainer(string id, CancellationToken ct = default)
    {
        var deleted = await inner.DeleteWopiContainer(id, ct);
        if (deleted) audit.Log($"deleted container {id}");
        return deleted;
    }

    // Forward the rest of IWopiWritableStorageProvider to `inner`.
    public int FileNameMaxLength => inner.FileNameMaxLength;
    // ...
}

License

See the repo README.