Systém pluginů
Rozšiřte prohlížeč pomocí pluginů
Jádro Doconut zůstává štíhlé; volitelná funkčnost je dodávána jako pluginy — samostatné balíčky NuGet, které poskytují prohlížeče nebo služby a jsou aktivovány vaší licencí. Tato stránka vysvětluje model registrace, jak se řízení licencí chová za běhu, a jak připojit vlastní prohlížeč.
Registrace pluginu
Každý balíček pluginu vystavuje jednu třídu pluginu. Zaregistrujete ji jednou, při spuštění:
builder.Services.AddDoconut(options =>
{
options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
options.AddPlugin<Doconut.Plugins.Dicom.DicomPlugin>();
});AddPlugin<TPlugin>() vytvoří instanci pluginu a zavolá jeho Register zpětné volání proti registru pluginů umístěnému na DoconutOptions. Všechno, co plugin přispívá, je označeno požadovanou schopností pluginu. AddDoconut() okamžitě ověřuje registrované pluginy: chybějící licence, starý soubor TRIAL nebo placená licence bez této schopnosti způsobí selhání spuštění s InvalidOperationException. Registrace Temporary/Demo je zachována po vypršení, ale její runtime schopnosti jsou po datu vypršení odebrány.
Smlouva
Plugin implementuje úmyslně malý rozhraní:
public interface IDoconutPlugin
{
string Name { get; } // např. "Doconut DICOM Viewer"
LicenseCapability RequiredCapability { get; } // licenční brána
void Register(IDoconutPluginBuilder builder); // přispějte k prohlížečům/službám
}Uvnitř Register builder přijímá dva typy příspěvků:
builder.RegisterViewer(extension, factory)— prohlížeč pro příponu souboru; továrna vracíIFormatViewer(plugin DICOM registruje.dcma.imatímto způsobem),builder.RegisterService<TContract>(() => …)— typovanou službu, kterou mohou ostatní části pipeline vyhledat.
Schopnosti a řízení
Schopnosti jsou jednotky licence. Converter, Dicom a Signer jsou dodávány jako volitelné pluginy; Search a Annotation jsou vestavěné funkce řízené stejným způsobem. Základní prohlížeč není schopnost — je předpokladem, vystaveným jako IsViewerLicensed v licenční službě.
Validace při spuštění normálně zabraňuje nelicencovanému pluginu vstoupit do požadavkové pipeline. Továrna prohlížečů také uplatňuje dvě obranné runtime pravidla, která jsou důležitá, pokud se oprávnění po spuštění změní:
- Plugin přepisuje vestavěný prohlížeč (plugin si nárokuje příponu, kterou také obsluhuje vestavěný registr): pokud je schopnost licencována, pluginový prohlížeč vyhrává; pokud ne, Doconut tiše přepne na vestavěný prohlížeč. Uživatelé stále vidí svůj dokument — jen nedostanou funkci pluginu.
- Formát pouze pro plugin (
.dcma.ima— DICOM nemá vestavěný prohlížeč): bez schopnosti volání open selže tvrdě:
LicenseException: This document type requires the 'Dicom' plugin license.Aktivní dočasná licence poskytuje všechny schopnosti (s čistým, neoznačeným základním prohlížením). To je klasický zdroj překvapení při nasazení: registrace stejných pluginů s zakoupenou licencí, která jednu z jejich schopností vynechává, způsobí selhání AddDoconut() během spuštění. Porovnejte IsCapabilityGranted(...) se svým plánem před nasazením. Na druhou stranu: s žádnou licencí vůbec, nic není poskytnuto — chybějící licence není dočasná licence.
Stejné řízení se objevuje na klientské straně: Viewer.ReferenceScripts() a ReferenceCss() emitují balíčky skriptů/stylů pro funkce řízené licencí (vyhledávání, anotace, …) pouze když licence je povolí, takže UI widgetu zůstává v souladu s tím, co server skutečně udělá.
Mapa funkcí a pluginů
Produktové UI používá „plugin“ jako široký štítek funkce, ale registrace na serveru se liší:
| Funkce | Jak je povoleno | Schopnost | Přispívá |
|---|---|---|---|
| Anotace | Vestavěno v prohlížeči; zahrnuje zdroje anotací | Annotation | Autorování v prohlížeči, perzistence relace a exporty s vypálenou anotací |
| Vyhledávání | Vestavěno v prohlížečích prohledávatelných formátů; zahrnuje zdroje vyhledávání a umožňuje extrakci tam, kde je požadována | Search | Nativní textový index, zvýraznění a navigace výsledků |
| Konvertor | Nainstalujte Doconut.NET8.Converter a zaregistrujte ConverterPlugin | Converter | C# konverzní služba a volitelný webový widget |
| DICOM | Nainstalujte Doconut.NET8.Dicom a zaregistrujte DicomPlugin | Dicom | Prohlížení medicínských obrázků pro .dcm a .ima |
| Podepisovač | Nainstalujte Doconut.NET8.Signer a zaregistrujte SignerPlugin | Signer | Viditelné podpisy a digitální pečeti pro PDF a Word: C# podepisovací služba a volitelný webový widget |
Anotace a běžné Vyhledávání nepoužívají AddPlugin<TPlugin>(); jejich balíčky jsou emitovány pouze když licence poskytne odpovídající schopnost. Konvertor, DICOM a Podepisovač jsou volitelné implementace IDoconutPlugin.
Vydané balíčky pluginů
| Plugin | Balíček | Schopnost | Přispívá |
|---|---|---|---|
| Konvertor | Doconut.NET8.Converter | Converter | Schopnost konverze dokumentů |
| DICOM | Doconut.NET8.Dicom | Dicom | Prohlížení medicínských obrázků (.dcm a .ima — formáty pouze pro plugin) |
| Podepisovač | Doconut.NET8.Signer | Signer | Podepisování PDF a Word |
Každý má samostatnou stránku pod Pluginy se svým nastavením a použitím.
Vlastní prohlížeče — váš vlastní obslužný formát
Můžete připojit prohlížeč do pipeline bez psaní balíčku pluginu, přímo z Program.cs:
builder.Services.AddDoconut(options =>
{
options.RegisterViewer(
".myext",
() => new MyCustomViewer(), // implements IFormatViewer
() => new ImageConfig { ImageResolution = 150 }); // volitelná výchozí konfigurace
});
// Formátový handler, který továrna vytvoří. Nahraďte tyto členy vlastním vykreslováním.
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() { }
}Vlastní prohlížeče mají přednost před všemi — vestavěnými i pluginy — a nejsou řízeny licencí (jsou vaším kódem). Továrna přepne na ImageConfig, pokud neposkytnete výchozí konfiguraci.
Závěry
- Pluginy jsou registrovány explicitně a jejich
LicenseCapabilityje ověřováno běhemAddDoconut()— chybějící nebo nedostatečné ne-dočasné oprávnění selže rychle. - Pluginy typu override selhávají elegantně; formáty pouze pro plugin selžou s
LicenseException. - Aktivní dočasná licence odemyká vše; produkční odemyká to, co jste zakoupili. Ověřte pomocí
IDoconutLicenseServicepřed vydáním.
Byla tato stránka užitečná?