Σύστημα Πρόσθετων

Επεκτείνετε τον προβολέα με πρόσθετα

Ο πυρήνας του Doconut παραμένει ελαφρύς· η προαιρετική λειτουργικότητα παρέχεται ως plugins — ξεχωριστά πακέτα NuGet που συνεισφέρουν προβολείς ή υπηρεσίες και ενεργοποιούνται από την άδειά σας. Αυτή η σελίδα εξηγεί το μοντέλο καταχώρησης, τι συμβαίνει κατά την εκκίνηση όταν μια άδεια δεν καλύπτει ένα plugin και πώς να ενσωματώσετε τον δικό σας προβολέα.

Καταχώρηση ενός plugin

Κάθε πακέτο plugin εκθέτει μία κλάση plugin. Καταχωρήστε το μία φορά, στο Application_Start:

csharp
Doconut.DoconutHost.Initialize(options =>
{
    options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
    options.AddPlugin<Doconut.Plugins.Dicom.DicomPlugin>();
});
// Ένα καταχωρημένο πρόσθετο του οποίου λείπει η άδεια προκαλεί εξαίρεση εδώ, στο Application_Start, και το
// ο ιστότοπος τότε απαντά κάθε αίτηση με κενό 500. Ο λόγος βρίσκεται στο αρχείο καταγραφής συμβάντων των Windows.

AddPlugin<TPlugin>() δημιουργεί το plugin και επιτρέπει την καταχώρηση των συνεισφορών του με το DoconutOptions. Ό,τι συνεισφέρει ένα plugin επισημαίνεται με την απαιτούμενη δυνατότητα του plugin, και το DoconutHost.Initialize ελέγχει κάθε καταχωρημένο plugin σε σχέση με την άδεια πριν ο ιστότοπος εξυπηρετήσει το πρώτο του αίτημα.

Η έλλειψη άδειας plugin σταματά τον ιστότοπο

Όταν καμία ενεργή άδεια δεν παρέχει τη δυνατότητα ενός καταχωρημένου plugin — καμία άδεια, ένα παλιό αρχείο TRIAL, ή μια επί πληρωμή άδεια χωρίς αυτή τη δυνατότητα — το DoconutHost.Initialize ρίχνει το InvalidOperationException από το Application_Start:

text
The Converter plugin is registered via AddPlugin but no active license grants Converter.
Remove the AddPlugin<...>() call or install a license (or trial/demo) that includes Converter.

Στο System.Web, μια εξαίρεση στο Application_Start δεν παράγει σελίδα σφάλματος. Κάθε αίτημα απαντά με ένα κενό 500, το αρχείο καταγραφής IIS δεν δείχνει κάτι χρήσιμο, και το μήνυμα εμφανίζεται μόνο στο αρχείο καταγραφής συμβάντων των Windows (Application log, πηγή ASP.NET). Όταν ένας ιστότοπος σταματά να ανταποκρίνεται αμέσως μετά την προσθήκη μιας γραμμής AddPlugin, ελέγξτε πρώτα τα αρχεία άδειας στο wwwroot — δείτε Ρύθμιση Άδειας.

Η σύμβαση

Ένα plugin υλοποιεί μια σκόπιμα μικρή διεπαφή:

csharp
public interface IDoconutPlugin
{
    string Name { get; }                          // π.χ. "Doconut DICOM Viewer"
    LicenseCapability RequiredCapability { get; } // η πύλη άδειας
    void Register(IDoconutPluginBuilder builder); // συνεισφέρετε προβολείς/υπηρεσίες
}

Μέσα στο Register, ο κατασκευαστής δέχεται δύο τύπους συνεισφοράς:

  • builder.RegisterViewer(extension, factory) — ένας προβολέας για μια επέκταση αρχείου· η εργοστασιακή λειτουργία επιστρέφει ένα IFormatViewer (το plugin DICOM καταχωρεί .dcm και .ima με αυτόν τον τρόπο),
  • builder.RegisterService<TContract>(() => …) — μια τυποποιημένη υπηρεσία που άλλα μέρη της αλυσίδας μπορούν να αναζητήσουν.

Δυνατότητες και περιορισμός

Οι δυνατότητες είναι οι μονάδες της άδειας. Τα Converter, Dicom και Signer παρέχονται ως plugins με επιλογή ενεργοποίησης· τα Search και Annotation είναι ενσωματωμένα χαρακτηριστικά που περιορίζονται με τον ίδιο τρόπο. Ο βασικός προβολέας δεν είναι δυνατότητα — είναι η προαπαιτούμενη προϋπόθεση, εκτεθειμένη ως IsViewerLicensed στην υπηρεσία άδειας.

Η επικύρωση κατά την εκκίνηση συνήθως κρατά ένα μη αδειοδοτημένο plugin εκτός της αλυσίδας αιτημάτων. Η εργοστασιακή λειτουργία προβολέα εφαρμόζει επίσης δύο αμυντικούς κανόνες, που έχουν σημασία εάν τα δικαιώματα αλλάξουν ενώ ο ιστότοπος λειτουργεί:

  • Ένα plugin που παρακάμπτει έναν ενσωματωμένο προβολέα (ζητά μια επέκταση που επίσης διαχειρίζεται ένας ενσωματωμένος προβολέας): με την αδειοδοτημένη δυνατότητα, ο προβολέας του plugin κερδίζει· χωρίς αυτήν, το Doconut επιστρέφει στον ενσωματωμένο προβολέα. Οι χρήστες εξακολουθούν να βλέπουν το έγγραφό τους· απλώς δεν λαμβάνουν τη συμπεριφορά του plugin.
  • Μορφή μόνο για plugin (.dcm και .ima — DICOM δεν έχει ενσωματωμένο προβολέα): χωρίς τη δυνατότητα, το άνοιγμα αποτυγχάνει:
text
LicenseException: This document type requires the 'Dicom' plugin license.

Μια ενεργή προσωρινή (Temporary) άδεια χορηγεί κάθε δυνατότητα. Αυτό είναι μια κλασική έκπληξη κατά την έναρξη λειτουργίας: οι ίδιες γραμμές AddPlugin που εκτελέστηκαν κατά την αξιολόγηση σταματούν τον ιστότοπο όταν η αγορασμένη άδεια παραλείπει μία από αυτές τις δυνατότητες. Συγκρίνετε το IsCapabilityGranted(...) με αυτό που αγοράσατε πριν την ανάπτυξη. Με καμία άδεια, τίποτα δεν χορηγείται — μια ελλιπής άδεια δεν είναι προσωρινή άδεια.

Ο ίδιος περιορισμός φθάνει στον περιηγητή: τα Viewer.ReferenceScripts() και ReferenceCss() εκδίδουν τα αρχεία για χαρακτηριστικά περιορισμένα από άδεια (Αναζήτηση, Σχόλιο) μόνο όταν η άδεια τα χορηγεί, έτσι η σελίδα ποτέ δεν προσφέρει χαρακτηριστικό που ο διακομιστής θα αρνηθεί.

Χάρτης χαρακτηριστικών και plugin

ΧαρακτηριστικόΠώς ενεργοποιείταιΔυνατότηταΣυνεισφέρει
ΣχόλιοΕνσωματωμένο στον προβολέα· συμπεριλαμβάνει τους πόρους σχολιασμούAnnotationΔημιουργία στο πρόγραμμα περιήγησης, διατήρηση συνεδρίας, εξαγωγές με ενσωματωμένο υδατογράφημα
ΑναζήτησηΕνσωματωμένο σε προβολείς μορφών με δυνατότητα αναζήτησης· συμπεριλαμβάνει τους πόρους αναζήτησηςSearchΦυσικός δείκτης κειμένου, επισήμανση, πλοήγηση αποτελεσμάτων
ΜετατροπέαςΕγκαταστήστε Doconut.NETFramework.Converter και καταχωρήστε ConverterPluginConverterΥπηρεσία μετατροπής C# και ένα προαιρετικό web widget
DICOMΕγκαταστήστε Doconut.NETFramework.Dicom και καταχωρήστε DicomPluginDicomΠροβολή ιατρικών εικόνων για .dcm και .ima
ΥπογραφέαςΕγκαταστήστε Doconut.NETFramework.Signer και καταχωρήστε SignerPluginSignerΟρατές υπογραφές και ψηφιακά σφραγίσματα για PDF και Word: υπηρεσία υπογραφής C# και ένα προαιρετικό web widget

Τα Annotation και Search δεν χρησιμοποιούν το AddPlugin<TPlugin>(). Τα Converter, DICOM και Signer έχουν καθένα μια σελίδα κάτω από Plugins με τη διαμόρφωση και τη χρήση τους. Σε αυτό το πακέτο, το DICOM αποδίδει σελίδες, πλαίσια και κινούμενα σχέδια, αλλά δεν διαβάζει τεχνικά μεταδεδομένα — δείτε Πρόσθετο DICOM.

Προσαρμοσμένοι προβολείς — ο δικός σας διαχειριστής μορφής

Μπορείτε να ενσωματώσετε έναν προβολέα στην αλυσίδα χωρίς να γράψετε ένα πακέτο plugin, απευθείας στο Application_Start:

csharp
Doconut.DoconutHost.Initialize(options =>
{
    options.RegisterViewer(
        ".myext",
        () => new MyCustomViewer(),                        // υλοποιεί IFormatViewer
        () => new ImageConfig { ImageResolution = 150 });  // προαιρετική προεπιλεγμένη διαμόρφωση
});

// Ο διαχειριστής μορφής που δημιουργεί το εργοστάσιο. Αντικαταστήστε αυτά τα μέλη με τη δική σας απόδοση.
public sealed class MyCustomViewer : Doconut.Core.Interfaces.IFormatViewer
{
    public ViewerType ViewerType => ViewerType.None;
    public int TotalPages => 0;
    public int DefaultWidth => 0;
    public int DefaultHeight => 0;
    public bool PreferOcr => false;

    public Task LoadAsync(Stream documentStream, BaseConfig config, CancellationToken ct = default)
        => Task.CompletedTask;

    public Task<byte[]> GetPageImageAsync(int pageNumber, CancellationToken ct = default)
        => Task.FromResult(Array.Empty<byte>());

    public void Dispose() { }
}

Οι προσαρμοσμένοι προβολείς έχουν προτεραιότητα πάνω από τα πάντα — τόσο ενσωματωμένα όσο και plugins — και δεν περιορίζονται από άδεια: είναι ο κώδικάς σας. Όταν δεν παρέχετε προεπιλεγμένη διαμόρφωση, η εργοστασιακή λειτουργία χρησιμοποιεί ένα ImageConfig.

Συμπεράσματα

  • Τα plugins καταχωρούνται ρητά στο DoconutHost.Initialize, και οι δυνατότητές τους επικυρώνονται εκεί· μια ελλιπής δικαιοδοσία σταματά τον ιστότοπο με ένα κενό 500 του οποίου ο λόγος βρίσκεται στο αρχείο καταγραφής συμβάντων των Windows.
  • Τα plugins τύπου παράκαμψης υποβαθμίζονται ομαλά· οι μορφές μόνο για plugin αποτυγχάνουν με ένα LicenseException.
  • Μια ενεργή προσωρινή (Temporary) άδεια ξεκλειδώνει τα πάντα· η παραγωγική ξεκλειδώνει ό,τι αγοράσατε. Ελέγξτε με το IDoconutLicenseService πριν τη διανομή.

Ήταν αυτή η σελίδα χρήσιμη;