DoconutExtensions
Dienst- und Middleware-Registrierung
DoconutExtensions (namespace Doconut.Middleware) ist die statische Klasse mit den drei Aufrufen, die jeder Doconut-Host macht: eine Service‑Registrierung und zwei Middleware‑Registrierungen.
builder.Services.AddDoconut(options => { /* … */ });
// …
app.UseSession(); // Rufen Sie UseSession() vor UseDoconut() auf
app.UseDoconutResources(); // muss vor UseDoconut() registriert werden
app.Map("/doconut", branch => branch.UseDoconut());UseDoconut() beantwortet jede Anfrage, die sie erreicht, also binden Sie sie in einem eigenen Zweig mit app.Map.
AddDoconut
IServiceCollection AddDoconut(this IServiceCollection services, Action<DoconutOptions>? configure = null)Erstellt das DoconutOptions, validiert sie sofort (siehe DoconutOptions → Start‑Validierung) und registriert das vollständige Service‑Graph.
| Dienst | Lebensdauer | Rolle |
|---|---|---|
DoconutOptions | Singleton | Das Konfigurationsobjekt |
| Session‑Cache‑Dienst | Singleton | Token → Session‑Cache (IMemoryCache ist ebenfalls registriert) |
IDoconutLicenseService | Singleton | Lizenz, die einmal beim Start geladen wird (Priorität: LicenseStream → LicenseContent → LicensePath → Auto‑Suche) |
| Seiten‑Bild‑Pipeline | Singleton | Führt Bildverarbeitung für Seiten durch (Wasserzeichen, Drehen, Skalieren, Anmerkungen) |
| Dokumentensicherheit (Zugriffs‑Store) | Singleton | Gewährt Bindungen von Token zu Session |
Viewer | Kurzlebig | Die öffentliche Öffnen/Schließen‑Fassade |
DocumentConverter | Kurzlebig | Konvertierungs‑Fassade — erfordert das Converter‑Plugin |
DocumentSigner | Kurzlebig | Signatur‑Fassade — erfordert das Signer‑Plugin (siehe Signer‑Plugin) |
DistributedDocumentPublisher | Kurzlebig | Veröffentlicht die Artefakte eines Dokuments in gemeinsamem Speicher (siehe Verteilte Bereitstellungen) |
Gesundheitsprüfung "doconut" | — | Berichtet über Lizenz‑/Ablaufstatus über ASP.NET‑Health‑Checks |
Zwei Verhaltensweisen, die es zu kennen gilt:
- Converter erfordert sein Plugin. Das Auflösen von
DocumentConverterohneoptions.AddPlugin<ConverterPlugin>()wirft:
InvalidOperationException: No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>().DocumentSigner folgt derselben Regel: Ohne options.AddPlugin<SignerPlugin>() wirft es No IDocumentSigner is registered. Add the signing plugin: options.AddPlugin<Doconut.Plugins.Signer.SignerPlugin>().
- Plugin‑Berechtigung wird beim Start validiert. Eine fehlende Lizenz, eine veraltete
TRIAL‑Datei oder eine bezahlte Lizenz ohne registrierte Plugin‑Fähigkeit schlägt zurAddDoconut()‑Zeit fehl. Temporäre/Demo‑Registrierungen überleben ihr Ablaufdatum, während Laufzeit‑Gates die abgelaufenen Fähigkeiten widerrufen.
Der Gesundheits‑Check integriert sich in den Standard‑ASP.NET‑Core‑Mechanismus — binden Sie ihn ein, wenn Sie den Lizenzstatus auf Ihrem Health‑Endpunkt sehen möchten:
app.MapHealthChecks("/health");UseDoconut
IApplicationBuilder UseDoconut(this IApplicationBuilder app)Fügt die Doconut‑Seiten‑Bild‑Middleware hinzu. Sie bedient jede Anfrage, die einen ?token=‑Abfrageparameter enthält — Seiten, Thumbnails, Suche, Anmerkungen, Seitenaktionen (die vollständige Anfragetabelle befindet sich in Kernkonzepte → Wie der Viewer funktioniert) — und beantwortet jede andere Anfrage selbst mit 404 (oder dem ShowDoconutInfo‑Banner): Sie leitet keine Anfrage an den Rest der Pipeline weiter. Binden Sie sie in einem eigenen Zweig ein, wie in den Beispielen auf dieser Seite. Wenn UnsafeMode false ist, wird die Dokumentensicherheits‑Schicht automatisch davor verkabelt.
Eine gängige Alternative bewahrt das historische DocImage.axd‑Anfrageformat mit einem MapWhen‑Zweig (der Client verwendet dann BasePath: '/'):
app.MapWhen(
ctx => ctx.Request.Path.Value?.EndsWith("DocImage.axd", StringComparison.OrdinalIgnoreCase) == true,
branch => branch.UseDoconut());UseDoconutResources
IApplicationBuilder UseDoconutResources(this IApplicationBuilder app)Stellt das eingebettete JS, CSS, Bilder und Schriftarten unter DoconutOptions.ResourcesPath (Standard /doconut-res) bereit. Dies sind die Dateien, für die Viewer.ReferenceCss() / ReferenceScripts() Tags erzeugen.
Rufen Sie es immer vor UseDoconut() auf. Wenn der Viewer‑Bereich leer bleibt und die Browser‑Konsole 404‑Fehler für /doconut-res/... anzeigt, fehlt dieser Aufruf oder ist falsch platziert.
Bereitstellung aus gemeinsamem Speicher
Zwei weitere Registrierungen existieren für Bereitstellungen, bei denen der Knoten, der ein Dokument rendert, nicht unbedingt der Knoten ist, der seine Seiten bereitstellt. Beide werden von Anfang bis Ende in Verteilte Bereitstellungen behandelt; die Signaturen sind:
IServiceCollection AddDoconutDistributedAsyncPublish(this IServiceCollection services, Action<DistributedAsyncPublishOptions>? configure = null) // opt-in Hintergrund-Publishing-Warteschlange
IServiceCollection AddDoconutDistributedWidgets(this IServiceCollection services, Action<DistributedWidgetsOptions> configure) // gemeinsamer Backend-Speicher für Widget-UploadsDie Leseseite ist eine separate Middleware aus dem Doconut.Clouds‑Assembly, das im selben Paket ausgeliefert wird:
IApplicationBuilder UseDoconutCloud<THandler>(
this IApplicationBuilder app,
Action<CloudOptions>? configure = null,
string pathPrefix = "/doconut-cloud")
where THandler : BaseCloudHandlerZusammenfassung der Reihenfolge
app.UseRouting();
app.UseSession(); // Rufen Sie UseSession() vor UseDoconut() auf
app.UseDoconutResources(); // muss vor UseDoconut() registriert werden
app.Map("/doconut", branch => branch.UseDoconut()); // oder ein MapWhen-ZweigWar diese Seite hilfreich?