Eklenti Sistemi
Görüntüleyiciyi eklentilerle genişletin
Doconut'un çekirdeği hafif kalır; isteğe bağlı işlevsellik eklentiler olarak gönderilir — görüntüleyiciler veya hizmetler katkıda bulunan ayrı NuGet paketleri ve lisansınız tarafından etkinleştirilir. Bu sayfa kayıt modelini, lisans kısıtlamasının çalışma zamanında nasıl davrandığını ve kendi görüntüleyicinizi nasıl ekleyeceğinizi açıklar.
Bu model bu sürümde yenidir. Önceki .NET Standard kütüphanesinde eklenti kaydı yoktu: dönüşüm doğrudan görüntüleyicide gerçekleşir ve eklenti lisansları statik Viewer.SetLicensePlugin(...) çağrılarıyla kurulurdu. Burada da bir kayıt mekanizması yoktur.
Bir eklenti kaydetmek
Her eklenti paketi bir eklenti sınıfı ortaya çıkarır. Bunu bir kez, başlangıçta kaydedersiniz:
builder.Services.AddDoconut(options =>
{
options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
options.AddPlugin<Doconut.Plugins.Dicom.DicomPlugin>();
});AddPlugin<TPlugin>() eklentiyi örnekler ve DoconutOptions üzerinde tutulan eklenti kaydına karşı Register geri çağrısını yürütür. Bir eklentinin katkıda bulunduğu her şey eklentinin gerekli yeteneği ile etiketlenir. AddDoconut() kayıtlı eklentileri hemen doğrular: eksik bir lisans, eski TRIAL dosyası veya yetenek olmadan ücretli lisans, başlangıcı InvalidOperationException ile başarısız kılar. Bir Geçici/Demo kaydı süresi dolana kadar korunur, ancak çalışma zamanı yetenekleri son tarih geçtikten sonra iptal edilir.
Sözleşme
Bir eklenti kasıtlı olarak küçük bir arayüz uygular:
public interface IDoconutPlugin
{
string Name { get; } // örn. "Doconut DICOM Viewer"
LicenseCapability RequiredCapability { get; } // lisans geçidi
void Register(IDoconutPluginBuilder builder); // görüntüleyicileri/hizmetleri katkıda bulunun
}Register içinde, oluşturucu iki tür katkıyı kabul eder:
builder.RegisterViewer(extension, factory)— bir dosya uzantısı için görüntüleyici; fabrika birIFormatViewerdöndürür (DICOM eklentisi bu şekilde.dcmve.imakaydeder),builder.RegisterService<TContract>(() => …)— boru hattının diğer bölümlerinin arayabileceği tiplenmiş bir hizmet.
Yetkinlikler ve kısıtlama
Yetkinlikler lisans birimleridir. Converter, Dicom ve Signer isteğe bağlı eklentiler olarak gelir; Search ve Annotation aynı şekilde kısıtlanan yerleşik özelliklerdir. Temel görüntüleyici bir yetkinlik değildir — ön koşuldur ve lisans hizmetinde IsViewerLicensed olarak ortaya çıkar.
Başlangıç doğrulaması normalde lisanssız bir eklentinin istek boru hattına girmesini engeller. Görüntüleyici fabrikası ayrıca iki savunma amaçlı çalışma zamanı kuralı uygular; bu kurallar, haklar başlangıçtan sonra değişirse önem kazanır:
- Eklenti yerleşik bir görüntüleyiciyi geçersiz kılar (bir eklenti, yerleşik kaydın da işlediği bir uzantıyı talep eder): yetenek lisanslıysa, eklenti görüntüleyici kazanır; lisanssızsa, Doconut sessizce yerleşik görüntüleyiciye geri döner. Kullanıcılar hâlâ belgelerini görür — sadece eklenti özelliğini almazlar.
- Sadece eklenti formatı (
.dcmve.ima— DICOM'in yerleşik bir görüntüleyicisi yoktur): yetenek olmadan açma çağrısı sert bir şekilde başarısız olur:
LicenseException: This document type requires the 'Dicom' plugin license.Aktif bir Geçici lisans her yetkinliği verir (temiz, filigran içermeyen temel görüntüleme ile). Bu, yayına geçişte klasik bir sürpriz kaynağıdır: aynı eklentileri, yeteneklerinden birini dışarıda bırakan satın alınmış bir lisansla kaydetmek, AddDoconut()'ın başlangıçta başarısız olmasına neden olur. Dağıtmadan önce planınıza karşı IsCapabilityGranted(...)'ı karşılaştırın. Diğer yandan: hiç lisans yoksa, hiçbir şey verilmez — eksik bir lisans bir Geçici lisans değildir.
Aynı kısıtlama istemci tarafında da görülür: Viewer.ReferenceScripts() ve ReferenceCss(), lisans‑kısıtlı özellikler (arama, açıklama, …) için script/stil paketlerini yalnızca lisans etkinleştirdiğinde üretir, böylece widget'ın UI'si sunucunun gerçekte yapacaklarıyla tutarlı kalır.
Özellik ve eklenti haritası
Ürün UI'si "plugin" terimini geniş bir özellik etiketi olarak kullanır, ancak sunucu kaydı farklıdır:
| Özellik | Nasıl etkinleştirilir | Yetkinlik | Katkı sağlar |
|---|---|---|---|
| Açıklama | Görüntüleyiciye yerleşiktir; açıklama kaynaklarını içerir | Annotation | Tarayıcı oluşturma, oturum kalıcılığı ve yanmış dışa aktarmalar |
| Arama | Aranabilir format görüntüleyicilerine yerleşiktir; arama kaynaklarını içerir ve gerektiğinde çıkarımı etkinleştirir | Search | Yerel metin indeksi, vurgulamalar ve sonuç navigasyonu |
| Dönüştürücü | Doconut.NETStandard.Converter kurun ve ConverterPlugin kaydedin | Converter | C# dönüşüm hizmeti ve isteğe bağlı web widget'ı |
| DICOM | Doconut.NETStandard.Dicom kurun ve DicomPlugin kaydedin | Dicom | .dcm ve .ima için tıbbi görüntü görüntüleme |
| İmzalayıcı | Doconut.NETStandard.Signer kurun ve SignerPlugin kaydedin | Signer | PDF ve Word için görünür imzalar ve dijital mühürler: C# imzalama hizmeti ve isteğe bağlı bir web widget |
Açıklama ve normal Arama, AddPlugin<TPlugin>() kullanmaz; bunların paketleri yalnızca lisans ilgili yetkinliği verdiğinde üretilir. Dönüştürücü, DICOM ve İmzalayıcı, opt‑in IDoconutPlugin uygulamalarıdır.
Yayınlanan eklenti paketleri
| Eklenti | Paket | Yetkinlik | Katkı sağlar |
|---|---|---|---|
| Dönüştürücü | Doconut.NETStandard.Converter | Converter | Belge dönüştürme yetkinliği |
| DICOM | Doconut.NETStandard.Dicom | Dicom | Tıbbi görüntü görüntüleme (.dcm ve .ima — sadece eklenti formatları) |
| İmzalayıcı | Doconut.NETStandard.Signer | Signer | PDF ve Word imzalama |
Her birinin Plugins altında yapılandırma ve kullanım bilgilerini içeren ayrı bir sayfası vardır.
Özel görüntüleyiciler — kendi format işleyiciniz
Bir eklenti paketi yazmadan, doğrudan Program.cs üzerinden bir görüntüleyiciyi boru hattına ekleyebilirsiniz:
builder.Services.AddDoconut(options =>
{
options.RegisterViewer(
".myext",
() => new MyCustomViewer(), // IFormatViewer uygular
() => new ImageConfig { ImageResolution = 150 }); // isteğe bağlı varsayılan yapılandırma
});
// Fabrika oluşturduğu format işleyicisi. Bu üyeleri kendi görselleştirmenizle değiştirin.
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() { }
}Özel görüntüleyiciler her şeyin — yerleşiklerin ve eklentilerin — önüne geçer ve lisans‑kısıtlamalı değildir (kendi kodunuzdur). Fabrika, varsayılan bir yapılandırma sağlamadığınızda bir ImageConfig'a geri döner.
Çıkarımlar
- Eklentiler açıkça kaydedilir ve
LicenseCapability'larıAddDoconut()sırasında doğrulanır — eksik veya yetersiz geçici olmayan haklar hızlıca başarısız olur. - Geçersiz kılma tarzı eklentiler nazikçe gerileşir; sadece eklenti formatları bir
LicenseExceptionile başarısız olur. - Aktif bir Geçici lisans her şeyi açar; üretim, satın aldıklarınızı açar. Göndermeden önce
IDoconutLicenseServiceile doğrulayın.
Bu sayfa yardımcı oldu mu?