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

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

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

Καταχώρηση ενός πρόσθετου

Κάθε πακέτο πρόσθετου εκθέτει μία κλάση πρόσθετου. Την καταχωρίζετε μία φορά, κατά την εκκίνηση:

csharp
builder.Services.AddDoconut(options =>
{
    options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
    options.AddPlugin<Doconut.Plugins.Dicom.DicomPlugin>();
});

AddPlugin<TPlugin>() δημιουργεί το πρόσθετο και καλεί την Register callback του ενάντια στο μητρώο πρόσθετων που διατηρείται στο DoconutOptions. Ό,τι συνεισφέρει ένα πρόσθετο επισημαίνεται με την απαιτούμενη δυνατότητα του πρόσθετου. AddDoconut() επικυρώνει άμεσα τα καταχωρημένα πρόσθετα: μια ελλιπής άδεια, ένα παλιό αρχείο TRIAL ή μια πληρωμένη άδεια χωρίς τη δυνατότητα αποτυγχάνει την εκκίνηση με InvalidOperationException. Μια καταχώρηση Temporary/Demo διατηρείται μετά τη λήξη, αλλά οι δυνατότητες χρόνου εκτέλεσης της ανακαλούνται μετά την ημερομηνία λήξης.

Η σύμβαση

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

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

Μέσα στο Register, ο builder δέχεται δύο είδη συνεισφορών:

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

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

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

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

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

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

Ο ίδιος περιορισμός εμφανίζεται στην πλευρά του πελάτη: Viewer.ReferenceScripts() και ReferenceCss() εκδίδουν τα πακέτα script/style για τις δυνατότητες περιορισμένες από άδεια (αναζήτηση, σχολιασμός, …) μόνο όταν η άδεια τις ενεργοποιεί, ώστε το UI του widget να παραμένει συνεπές με ό,τι θα κάνει πραγματικά ο διακομιστής.

Χάρτης χαρακτηριστικών και πρόσθετων

Η διεπαφή προϊόντος χρησιμοποιεί το “plugin” ως ευρύ ετικέτα χαρακτηριστικού, αλλά η καταχώρηση στον διακομιστή διαφέρει:

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

Το Σχόλιο και η κανονική Αναζήτηση δεν χρησιμοποιούν AddPlugin<TPlugin>()· τα πακέτα τους εκδίδονται μόνο όταν η άδεια χορηγεί την αντίστοιχη δυνατότητα. Οι Μετατροπέας, DICOM και Υπογραφέας είναι υλοποιήσεις opt‑in IDoconutPlugin.

Κυκλοφορημένα πακέτα πρόσθετων

ΠρόσθετοΠακέτοΔυνατότηταΣυνεισφέρει
ΜετατροπέαςΕγκαταστήστε Doconut.NET6.ConverterConverterΔυνατότητα μετατροπής εγγράφων
DICOMΕγκαταστήστε Doconut.NET6.DicomDicomΠροβολή ιατρικών εικόνων (.dcm και .ima — μορφές μόνο-πρόσθετου)
ΥπογραφέαςΕγκαταστήστε Doconut.NET6.SignerSignerΥπογραφή PDF και Word

Κάθε ένα έχει μια αφιερωμένη σελίδα κάτω από Plugins με τη διαμόρφωση και τη χρήση του.

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

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

csharp
builder.Services.AddDoconut(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() { }
}

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

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

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

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