سیستم افزونهها
گسترش نمایشگر با افزونهها
هسته Doconut ساده باقی میماند؛ عملکردهای اختیاری به صورت افزونهها — بستههای جداگانه NuGet که نمایشگرها یا سرویسها را اضافه میکنند و توسط مجوز شما فعال میشوند. این صفحه مدل ثبتنام، نحوه رفتار محدودسازی مجوز در زمان اجرا، و چگونگی افزودن نمایشگر خودتان را توضیح میدهد.
ثبت یک افزونه
هر بسته افزونه یک کلاس افزونه را افشا میکند. شما آن را یک بار، در زمان راهاندازی ثبت میکنید:
builder.Services.AddDoconut(options =>
{
options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
options.AddPlugin<Doconut.Plugins.Dicom.DicomPlugin>();
});AddPlugin<TPlugin>() یک نمونه از افزونه ایجاد میکند و فراخوانی Register خود را نسبت به رجیستری افزونه که بر روی DoconutOptions نگهداری میشود، اجرا میکند. هر چیزی که افزونه اضافه میکند با قابلیت مورد نیاز افزونه برچسبگذاری میشود. AddDoconut() بلافاصله افزونههای ثبتشده را اعتبارسنجی میکند: یک مجوز گمشده، فایل قدیمی TRIAL، یا مجوز پرداختشده بدون قابلیت، راهاندازی را با InvalidOperationException شکست میدهد. یک ثبتنام موقت/دمو تا پس از انقضا حفظ میشود، اما قابلیتهای زمان اجرا پس از تاریخ انقضا لغو میشوند.
قرارداد
یک افزونه یک رابط کاربری بهطور عمدی کوچک را پیادهسازی میکند:
public interface IDoconutPlugin
{
string Name { get; } // مثلاً "Doconut DICOM Viewer"
LicenseCapability RequiredCapability { get; } // دروازهٔ مجوز
void Register(IDoconutPluginBuilder builder); // مشارکت در نمایشگرها/سرویسها
}در داخل Register، سازنده دو نوع مشارکت را میپذیرد:
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.یک مجوز موقت فعال تمام قابلیتها را اعطا میکند (با نمایش پایهٔ پاک و بدون واترمارک). این منبع کلاسیک شگفتیهای زمان راهاندازی است: ثبت همان افزونهها با مجوز خریداریشده که یکی از قابلیتهای آنها را حذف میکند، باعث میشود AddDoconut() در زمان راهاندازی شکست بخورد. قبل از استقرار، IsCapabilityGranted(...) را با برنامهٔ خود مقایسه کنید. طرف دیگر: با بدون هیچ مجوزی، هیچچیزی اعطا نمیشود — یک مجوز گمشده، مجوز موقت نیست.
همان محدودسازی در سمت مشتری نیز ظاهر میشود: Viewer.ReferenceScripts() و ReferenceCss() بستههای اسکریپت/استایل برای ویژگیهای محدودشده توسط مجوز (جستجو، حاشیهنویسی، …) فقط زمانی که مجوز آنها را فعال کند، تولید میکنند، بهطوری که رابط کاربری ویجت با آنچه سرور واقعاً انجام میدهد، سازگار بماند.
نقشه ویژگیها و افزونهها
رابط کاربری محصول از «افزونه» بهعنوان برچسب ویژگی گسترده استفاده میکند، اما ثبتنام سرور متفاوت است:
| ویژگی | چگونه فعال میشود | قابلیت | مشارکت میکند |
|---|---|---|---|
| حاشیهنویسی | درون نمایشگر تعبیه شده؛ شامل منابع حاشیهنویسی | Annotation | نویسندگی مرورگر، حفظ نشست، و خروجیهای سوزاندهشده |
| جستجو | درون نمایشگرهای فرمت قابل جستجو تعبیه شده؛ شامل منابع جستجو و فعالسازی استخراج در صورت نیاز | Search | فهرست متن بومی، برجستهسازیها، و ناوبری نتایج |
| مبدل | نصب Doconut.NET6.Converter و ثبت ConverterPlugin | Converter | سرویس تبدیل C# و ویجت وب اختیاری |
| DICOM | نصب Doconut.NET6.Dicom و ثبت DicomPlugin | Dicom | نمایش تصویر پزشکی برای .dcm و .ima |
| امضا کننده | نصب Doconut.NET6.Signer و ثبت SignerPlugin | Signer | امضاهای قابل مشاهده و مهرهای دیجیتال برای PDF و Word: سرویس امضای C# و یک ویجت وب اختیاری |
حاشیهنویسی و جستجوی معمولی از AddPlugin<TPlugin>() استفاده نمیکنند؛ بستههای آنها فقط زمانی تولید میشوند که مجوز قابلیت مربوطه را اعطا کند. مبدل، DICOM و امضا کننده پیادهسازیهای IDoconutPlugin اختیاری هستند.
بستههای افزونه منتشر شده
| افزونه | بسته | قابلیت | مشارکت میکند |
|---|---|---|---|
| مبدل | Doconut.NET6.Converter | Converter | قابلیت تبدیل سند |
| DICOM | Doconut.NET6.Dicom | Dicom | نمایش تصویر پزشکی (.dcm و .ima — قالبهای فقط افزونهای) |
| امضا کننده | Doconut.NET6.Signer | Signer | امضای PDF و Word |
هر کدام صفحهٔ اختصاصی خود را تحت افزونهها دارند که شامل پیکربندی و استفاده است.
نمایشگرهای سفارشی — پردازشگر قالب خودتان
میتوانید یک نمایشگر را به خط لوله متصل کنید بدون نوشتن بستهٔ افزونه، مستقیماً از Program.cs:
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شکست میخورند. - یک مجوز موقت فعال همه چیز را باز میکند؛ محیط تولید آنچه خریداری کردهاید را باز میکند. قبل از ارسال، با
IDoconutLicenseServiceتأیید کنید.
آیا این صفحه مفید بود؟