מערכת תוספים
הרחבת הצופה עם תוספים
הליבה של 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 משתמש במילה “תוסף” כתווית תכונה רחבה, אך רישום השרת שונה:
| תכונה | איך זה מופעל | יכולת | תורם |
|---|---|---|---|
| אנוטציה | מובנה במציג; כולל משאבי אנוטציה | Annotation | יצירת תוכן בדפדפן, שמירת מושב, וייצוא משולב |
| חיפוש | מובנה במציגי פורמטים שניתן לחפש בהם; כולל משאבי חיפוש ומאפשר חילוץ כשנדרש | Search | אינדקס טקסט מקורי, הדגשות, וניווט בתוצאות |
| ממיר | התקן Doconut.NET8.Converter ורשום ConverterPlugin | Converter | שירות המרה ב‑C# ווידג'ט אינטרנטי אופציונלי |
| DICOM | התקן Doconut.NET8.Dicom ורשום DicomPlugin | Dicom | צפייה בתמונות רפואיות עבור .dcm ו.ima |
| חותם | התקן Doconut.NET8.Signer ורשום SignerPlugin | Signer | חתימות נראות וחותמות דיגיטליות ל‑PDF ול‑Word: שירות חתימה ב‑C# ווידג'ט אינטרנטי אופציונלי |
אנוטציה וחיפוש רגיל אינם משתמשים בAddPlugin<TPlugin>(); החבילות שלהם נפלטות רק כאשר הרישיון מעניק את היכולת המתאימה. ממיר, DICOM ו‑Signer הם מימושים של IDoconutPlugin אופציונליים.
חבילות תוספים משוחררות
| תוסף | חבילה | יכולת | תורם |
|---|---|---|---|
| ממיר | Doconut.NET8.Converter | Converter | יכולת המרת מסמכים |
| DICOM | Doconut.NET8.Dicom | Dicom | צפייה בתמונות רפואיות (.dcm ו.ima — פורמטים רק-תוסף) |
| חותם | Doconut.NET8.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לפני השחרור.
האם דף זה היה מועיל?