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