DoconutExtensions
Καταχώρηση υπηρεσιών και μεσαζόντων
DoconutExtensions (namespace Doconut.Middleware) είναι η στατική κλάση με τις τρεις κλήσεις που κάνει κάθε φιλοξενητής Doconut: μία καταχώρηση υπηρεσίας και δύο καταχωρήσεις μεσαζόντων.
builder.Services.AddDoconut(options => { /* … */ });
// …
app.UseSession(); // καλέστε UseSession() πριν από UseDoconut()
app.UseDoconutResources(); // πρέπει να καταχωρηθεί πριν από UseDoconut()
app.Map("/doconut", branch => branch.UseDoconut());UseDoconut() απαντά σε κάθε αίτημα που το φθάνει, επομένως τοποθετήστε το σε δικό του κλάδο με app.Map.
AddDoconut
IServiceCollection AddDoconut(this IServiceCollection services, Action<DoconutOptions>? configure = null)Δημιουργεί το DoconutOptions, τα επικυρώνει άμεσα (δείτε DoconutOptions → Επικύρωση εκκίνησης), και καταχωρεί το πλήρες γράφημα υπηρεσιών:
| Υπηρεσία | Διάρκεια ζωής | Ρόλος |
|---|---|---|
DoconutOptions | Singleton | Το αντικείμενο ρυθμίσεων |
| Υπηρεσία προσωρινής μνήμης συνεδρίας | Singleton | Token → session cache (IMemoryCache είναι επίσης καταχωρημένο) |
IDoconutLicenseService | Singleton | Άδεια που φορτώνεται μία φορά κατά την εκκίνηση (προτεραιότητα: LicenseStream → LicenseContent → LicensePath → auto-search) |
| Συμπλήρωμα εικόνας σελίδας | Singleton | Εκτελεί επεξεργασία εικόνας για σελίδες (υδατογράφημα, περιστροφή, κλιμάκωση, σημειώσεις) |
| Ασφάλεια εγγράφου (αποθήκευση πρόσβασης) | Singleton | Διευκολύνει τη σύνδεση token-σε-συνεδρία |
Viewer | Transient | Η δημόσια διεπαφή ανοίγματος/κλεισίματος |
DocumentConverter | Transient | Διεπαφή μετατροπής — απαιτεί το πρόσθετο Converter |
DocumentSigner | Transient | Διεπαφή υπογραφής — απαιτεί το πρόσθετο Signer (δείτε Signer Plugin) |
DistributedDocumentPublisher | Transient | Δημοσιεύει τα τεχνικά αρχεία ενός εγγράφου σε κοινόχρηστη αποθήκευση (δείτε Distributed Deployments) |
Health check "doconut" | — | Αναφέρει την κατάσταση άδειας/λήξης μέσω ελέγχων υγείας ASP.NET |
Δύο συμπεριφορές που αξίζει να γνωρίζετε:
- Ο Converter απαιτεί το πρόσθετό του. Η επίλυση του
DocumentConverterχωρίςoptions.AddPlugin<ConverterPlugin>()προκαλεί εξαίρεση:
InvalidOperationException: No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>().DocumentSigner ακολουθεί τον ίδιο κανόνα: χωρίς options.AddPlugin<SignerPlugin>() προκαλεί εξαίρεση No IDocumentSigner is registered. Add the signing plugin: options.AddPlugin<Doconut.Plugins.Signer.SignerPlugin>().
- Η άδεια πρόσθετου επικυρώνεται κατά την εκκίνηση. Απουσία άδειας, αρχείο legacy
TRIALή πληρωμένη άδεια χωρίς καταχωρημένη δυνατότητα πρόσθετου αποτυγχάνει στη στιγμήAddDoconut(). Οι προσωρινές/Δοκιμαστικές καταχωρίσεις παραμένουν μετά την ημερομηνία λήξης, ενώ οι πύλες χρόνου εκτέλεσης ανακαλούν τις ληγμένες δυνατότητες.
Ο έλεγχος υγείας ενσωματώνεται με τον τυπικό μηχανισμό ASP.NET Core — χαρτογραφήστε το αν θέλετε την κατάσταση άδειας στο σημείο υγείας σας:
app.MapHealthChecks("/health");UseDoconut
IApplicationBuilder UseDoconut(this IApplicationBuilder app)Προσθέτει το μεσαζόντα Doconut page-image. Εξυπηρετεί κάθε αίτημα που περιέχει την παράμετρο ερωτήματος ?token= — σελίδες, μικρογραφίες, αναζήτηση, σημειώσεις, ενέργειες σελίδας (ο πλήρης πίνακας αιτημάτων βρίσκεται στα Core Concepts → How the Viewer Works) — και απαντά σε οποιοδήποτε άλλο αίτημα με 404 (ή το banner ShowDoconutInfo): δεν προωθεί ποτέ το αίτημα στο υπόλοιπο pipeline. Τοποθετήστε το σε δικό του κλάδο, όπως στα παραδείγματα σε αυτή τη σελίδα. Όταν UnsafeMode είναι false, το επίπεδο ασφάλειας εγγράφου ενσωματώνεται αυτόματα πριν από αυτό.
Μια κοινή εναλλακτική διατηρεί το ιστορικό σχήμα αιτήματος DocImage.axd με έναν κλάδο MapWhen (ο πελάτης τότε χρησιμοποιεί BasePath: '/'):
app.MapWhen(
ctx => ctx.Request.Path.Value?.EndsWith("DocImage.axd", StringComparison.OrdinalIgnoreCase) == true,
branch => branch.UseDoconut());UseDoconutResources
IApplicationBuilder UseDoconutResources(this IApplicationBuilder app)Εξυπηρετεί τα ενσωματωμένα JS, CSS, εικόνες και γραμματοσειρές στο DoconutOptions.ResourcesPath (προεπιλογή /doconut-res). Αυτά είναι τα αρχεία για τα οποία τα Viewer.ReferenceCss() / ReferenceScripts() εκδίδουν ετικέτες.
Πάντα καλέστε το πριν από UseDoconut(). Αν η περιοχή προβολής παραμένει κενή και η κονσόλα του προγράμματος περιήγησης εμφανίζει 404 για /doconut-res/..., αυτή η κλήση λείπει ή είναι τοποθετημένη λανθασμένα.
Εξυπηρέτηση από κοινόχρηστη αποθήκευση
Υπάρχουν δύο επιπλέον καταχωρίσεις για αναπτύξεις όπου ο κόμβος που αποδίδει ένα έγγραφο δεν είναι απαραίτητα ο κόμβος που εξυπηρετεί τις σελίδες του. Και οι δύο καλύπτονται πλήρως στο Distributed Deployments; οι υπογραφές είναι:
IServiceCollection AddDoconutDistributedAsyncPublish(this IServiceCollection services, Action<DistributedAsyncPublishOptions>? configure = null) // ουρά δημοσίευσης παρασκηνίου με επιλογή
IServiceCollection AddDoconutDistributedWidgets(this IServiceCollection services, Action<DistributedWidgetsOptions> configure) // κοινόχρηστη αποθήκη υποστήριξης για μεταφορτώσεις widgetΗ πλευρά ανάγνωσης είναι ένα ξεχωριστό μεσαζόντ από τη συναρμολόγηση Doconut.Clouds, η οποία διανέμεται στο ίδιο πακέτο:
IApplicationBuilder UseDoconutCloud<THandler>(
this IApplicationBuilder app,
Action<CloudOptions>? configure = null,
string pathPrefix = "/doconut-cloud")
where THandler : BaseCloudHandlerΑνακεφαλαίωση σειράς
app.UseRouting();
app.UseSession(); // καλέστε UseSession() πριν από UseDoconut()
app.UseDoconutResources(); // πρέπει να καταχωρηθεί πριν από UseDoconut()
app.Map("/doconut", branch => branch.UseDoconut()); // ή ένας κλάδος MapWhenΉταν αυτή η σελίδα χρήσιμη;