Σύστημα Πρόσθετων
Επεκτείνετε τον προβολέα με πρόσθετα
Ο πυρήνας του Doconut παραμένει ελαφρύς· η προαιρετική λειτουργικότητα παρέχεται ως plugins — ξεχωριστά πακέτα NuGet που συνεισφέρουν προβολείς ή υπηρεσίες και ενεργοποιούνται από την άδειά σας. Αυτή η σελίδα εξηγεί το μοντέλο καταχώρησης, πώς η περιοριστική άδεια λειτουργεί σε χρόνο εκτέλεσης και πώς να ενσωματώσετε τον δικό σας προβολέα.
Καταχώρηση ενός πρόσθετου
Κάθε πακέτο πρόσθετου εκθέτει μία κλάση πρόσθετου. Την καταχωρείτε μία φορά, κατά την εκκίνηση:
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 διατηρείται μετά τη λήξη, αλλά οι δυνατότητες χρόνου εκτέλεσης της ανακαλούνται μετά την ημερομηνία λήξης.
Η σύμβαση
Ένα πρόσθετο υλοποιεί μια σκόπιμα μικρή διεπαφή:
public interface IDoconutPlugin
{
string Name { get; } // π.χ. "Doconut DICOM Viewer"
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 δεν έχει ενσωματωμένο προβολέα): χωρίς τη δυνατότητα η κλήση ανοίγματος αποτυγχάνει σκληρά:
LicenseException: This document type requires the 'Dicom' plugin license.Μια ενεργή άδεια Temporary χορηγεί κάθε δυνατότητα (με καθαρή, χωρίς υδατογράφημα βασική προβολή). Αυτό είναι μια κλασική πηγή εκπλήξεων κατά την έναρξη λειτουργίας: η καταχώρηση των ίδιων πρόσθετων με μια αγορασμένη άδεια που παραλείπει μία από τις δυνατότητές τους κάνει το AddDoconut() να αποτύχει κατά την εκκίνηση. Συγκρίνετε το IsCapabilityGranted(...) με το πλάνο σας πριν από την ανάπτυξη. Το αντίστροφο: με καμία άδεια, τίποτα δεν χορηγείται — μια ελλιπής άδεια δεν είναι άδεια Temporary.
Ο ίδιος περιορισμός εμφανίζεται στην πλευρά του πελάτη: Viewer.ReferenceScripts() και ReferenceCss() εκδίδουν τα πακέτα script/style για τις λειτουργίες που περιορίζονται από την άδεια (αναζήτηση, σχολιασμός, …) μόνο όταν η άδεια τις ενεργοποιεί, ώστε το UI του widget να παραμένει συνεπές με ό,τι θα κάνει πραγματικά ο διακομιστής.
Χάρτης λειτουργιών και πρόσθετων
Το UI του προϊόντος χρησιμοποιεί το “plugin” ως ευρύ ετικέτα λειτουργίας, αλλά η καταχώρηση στον διακομιστή διαφέρει:
| Λειτουργία | Πώς ενεργοποιείται | Δυνατότητα | Συνεισφέρει |
|---|---|---|---|
| Σχόλιο | Ενσωματωμένο στον προβολέα· περιλαμβάνει πόρους σχολιασμού | Annotation | Δημιουργία μέσω προγράμματος περιήγησης, διατήρηση συνεδρίας και εξαγωγές με ενσωματωμένο υδατογράφημα |
| Αναζήτηση | Ενσωματωμένο σε προβολείς μορφών με δυνατότητα αναζήτησης· περιλαμβάνει πόρους αναζήτησης και ενεργοποιεί εξαγωγή όπου απαιτείται | Search | Φυσικό ευρετήριο κειμένου, επισημάνσεις και πλοήγηση αποτελεσμάτων |
| Μετατροπέας | Εγκαταστήστε Doconut.NET8.Converter και καταχωρίστε ConverterPlugin | Converter | Υπηρεσία μετατροπής C# και προαιρετικό web widget |
| DICOM | Εγκαταστήστε Doconut.NET8.Dicom και καταχωρίστε DicomPlugin | Dicom | Προβολή ιατρικών εικόνων για .dcm και .ima |
| Υπογράφων | Εγκαταστήστε Doconut.NET8.Signer και καταχωρίστε SignerPlugin | Signer | Ορατές υπογραφές και ψηφιακά σφραγίσματα για PDF και Word: υπηρεσία υπογραφής C# και προαιρετικό web widget |
Τα Σχόλιο και η κανονική Αναζήτηση δεν χρησιμοποιούν AddPlugin<TPlugin>()· τα πακέτα τους εκδίδονται μόνο όταν η άδεια χορηγεί την αντίστοιχη δυνατότητα. Οι Μετατροπέας, DICOM και Υπογράφων είναι υλοποιήσεις IDoconutPlugin με επιλογή ενεργοποίησης.
Κυκλοφορημένα πακέτα πρόσθετων
| Πρόσθετο | Πακέτο | Δυνατότητα | Συνεισφέρει |
|---|---|---|---|
| Μετατροπέας | Doconut.NET8.Converter | Converter | Δυνατότητα μετατροπής εγγράφων |
| DICOM | Doconut.NET8.Dicom | Dicom | Προβολή ιατρικών εικόνων (.dcm και .ima — μορφές μόνο-πρόσθετου) |
| Υπογράφων | Doconut.NET8.Signer | Signer | Υπογραφή PDF και Word |
Κάθε ένα έχει μια αφιερωμένη σελίδα κάτω από Plugins με τη διαμόρφωση και τη χρήση του.
Προσαρμοσμένοι προβολείς — ο δικός σας διαχειριστής μορφής
Μπορείτε να ενσωματώσετε έναν προβολέα στη γραμμή επεξεργασίας χωρίς να γράψετε πακέτο πρόσθετου, απευθείας από Program.cs:
builder.Services.AddDoconut(options =>
{
options.RegisterViewer(
".myext",
() => new MyCustomViewer(), // υλοποιεί IFormatViewer
() => new ImageConfig { ImageResolution = 150 }); // προαιρετική προεπιλεγμένη ρύθμιση
});
// Ο διαχειριστής μορφής που δημιουργεί το factory. Αντικαταστήστε αυτά τα μέλη με τη δική σας απόδοση.
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πριν από την αποστολή.
Ήταν αυτή η σελίδα χρήσιμη;