מערכת תוספים
הרחבת הצופה עם תוספים
הליבה של 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. רישום Temporary/Demo נשמר לאחר פקיעה, אך היכולות שלו בזמן ריצה מבוטלות לאחר תאריך הפקיעה.
החוזה
תוסף מממש ממשק קטן במכוון:
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>(() => …)— שירות Typed שחלקים אחרים של הצינור יכולים לחפש.
יכולות והגבלה
יכולות הן יחידות הרישיון. 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() מפיקים את חבילות הסקריפט/סגנון לתכונות המוגבלות ברישיון (חיפוש, הערה, …) רק כאשר הרישיון מאפשר אותן, כך שממשק הווידג'ט נשאר תואם למה שהשרת יעשה בפועל.
מפת תכונות ותוספים
המוצר UI משתמש במילה “plugin” כתווית תכונה רחבה, אך רישום השרת שונה:
| תכונה | איך זה מופעל | יכולת | תורם |
|---|---|---|---|
| הערה | מובנה בצופה; כולל משאבי הערה | 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. - רישיון Temporary פעיל פותח את הכל; בייצור נפתחות רק מה שרכשת. אמת עם
IDoconutLicenseServiceלפני השחרור.
האם דף זה היה מועיל?