System wtyczek

Rdzeń Doconut pozostaje lekki; opcjonalna funkcjonalność jest dostarczana jako wtyczki — oddzielne pakiety NuGet, które dostarczają przeglądarki lub usługi i są włączane przez twoją licencję. Ta strona wyjaśnia model rejestracji, jak ograniczenia licencyjne zachowują się w czasie wykonywania oraz jak podłączyć własną przeglądarkę.

Rejestrowanie wtyczki

Każdy pakiet wtyczki udostępnia jedną klasę wtyczki. Rejestrujesz ją raz, przy uruchamianiu:

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

AddPlugin<TPlugin>() tworzy instancję wtyczki i wywołuje jej Register callback w rejestrze wtyczek przechowywanym na DoconutOptions. Wszystko, co wtyczka wnosi, jest oznaczone wymaganą możliwością wtyczki. AddDoconut() natychmiast waliduje zarejestrowane wtyczki: brak licencji, starszy plik TRIAL lub płatna licencja bez tej możliwości powodują niepowodzenie uruchomienia z InvalidOperationException. Rejestracja tymczasowa/Demo jest zachowywana po wygaśnięciu, ale jej możliwości w czasie działania są cofane po dacie wygaśnięcia.

Umowa

Wtyczka implementuje celowo mały interfejs:

public interface IDoconutPlugin
{
    string Name { get; }                          // np. "Doconut DICOM Viewer"
    LicenseCapability RequiredCapability { get; } // brama licencyjna
    void Register(IDoconutPluginBuilder builder); // dodaj przeglądarki/usługi
}

Wewnątrz Register, konstruktor akceptuje dwa rodzaje wkładów:

• builder.RegisterViewer(".dcm", () => new DicomViewer()) — przeglądarka dla rozszerzenia pliku,
• builder.RegisterService<TContract>(() => …) — typowana usługa, którą inne części potoku mogą wyszukać.

Możliwości i ograniczenia

Możliwości są jednostkami licencyjnymi. Converter i Dicom są dostarczane jako wtyczki opcjonalne; Search i Annotation są wbudowanymi funkcjami ograniczanymi w ten sam sposób. Podstawowa przeglądarka nie jest możliwością — jest wymogiem wstępnym, udostępnianym jako IsViewerLicensed w usłudze licencji.

Walidacja przy uruchamianiu zazwyczaj zapobiega nielicencjonowanej wtyczce przed wejściem do potoku żądań. Fabryka przeglądarek stosuje również dwie defensywne reguły w czasie działania, które mają znaczenie, jeśli uprawnienia zmieniają się po uruchomieniu:

• Wtyczka nadpisuje wbudowaną przeglądarkę (wtyczka zgłasza rozszerzenie, które obsługuje również wbudowany rejestr): przy licencjonowanej możliwości, przeglądarka wtyczki wygrywa; bez niej, Doconut cicho przełącza się na wbudowaną przeglądarkę. Użytkownicy nadal widzą swój dokument — po prostu nie otrzymują funkcji wtyczki.
• Format tylko wtyczkowy (np. .dcm — DICOM nie ma wbudowanej przeglądarki): bez możliwości wywołanie otwarcia kończy się twardą awarią:

LicenseException: This document type requires the 'Dicom' plugin license.

Aktywna tymczasowa licencja przyznaje wszystkie możliwości (z czystym, nieoznaczonym podstawowym podglądem). To klasyczne źródło niespodzianek przy uruchamianiu: rejestracja tych samych wtyczek z zakupioną licencją, która pomija jedną z ich możliwości, powoduje niepowodzenie AddDoconut() podczas uruchamiania. Porównaj IsCapabilityGranted(...) ze swoim planem przed wdrożeniem. Odwrotna strona: przy braku jakiejkolwiek licencji, nic nie jest przyznane — brak licencji nie jest tymczasową licencją.

To samo ograniczenie pojawia się po stronie klienta: Viewer.ReferenceScripts() i ReferenceCss() emitują pakiety skryptów/style dla funkcji ograniczonych licencją (wyszukiwanie, adnotacje, …) tylko gdy licencja je włącza, więc interfejs widgetu pozostaje spójny z tym, co serwer faktycznie zrobi.

Mapa funkcji i wtyczek

Interfejs produktu używa „wtyczka” jako szerokiej etykiety funkcji, ale rejestracja po stronie serwera różni się:

Adnotacja i zwykłe Wyszukiwanie nie używają AddPlugin<TPlugin>(); ich pakiety są emitowane tylko wtedy, gdy licencja przyznaje odpowiednią możliwość. Konwerter i DICOM są wydanymi opcjonalnymi implementacjami IDoconutPlugin dla tego zestawu dokumentacji.

Zatwierdzone artefakty .NET 6 zawierają Doconut.NET6.Converter i Doconut.NET6.Dicom w tej samej wersji co pakiet podstawowy.

Wydane pakiety wtyczek

Każda ma dedykowaną stronę w sekcji Wtyczki z jej konfiguracją i użyciem.

Niestandardowe przeglądarki — własny obsługiwacz formatu

Możesz podłączyć przeglądarkę do potoku bez pisania pakietu wtyczki, bezpośrednio z Program.cs:

builder.Services.AddDoconut(options =>
{
    options.RegisterViewer(
        ".myext",
        () => new MyCustomViewer(),               // implementuje IFormatViewer
        () => new ImageConfig { ImageResolution = 150 }); // opcjonalna domyślna konfiguracja
});

Niestandardowe przeglądarki mają pierwszeństwo przed wszystkim — zarówno wbudowanymi, jak i wtyczkami — i nie są ograniczane licencją (są twoim kodem). Fabryka przechodzi do ImageConfig, gdy nie dostarczysz domyślnej konfiguracji.

Najważniejsze wnioski

• Wtyczki są rejestrowane explicite i ich LicenseCapability jest walidowany podczas AddDoconut() — brak lub niewystarczające nie‑tymczasowe uprawnienie powoduje szybkie niepowodzenie.
• Wtyczki typu override degradują się łagodnie; formaty tylko wtyczkowe kończą się niepowodzeniem z LicenseException.
• Aktywna tymczasowa licencja odblokowuje wszystko; produkcyjna odblokowuje to, co kupiłeś. Zweryfikuj z IDoconutLicenseService przed wypuszczeniem.