מערכת תוספים
הרחבת הצופה עם תוספים
הליבה של Doconut נשארת קלה; פונקציונליות אופציונלית נמסרת כ‑תוספים — חבילות NuGet נפרדות שתורמות צופים או שירותים ומופעלות על‑ידי הרישיון שלך. דף זה מסביר את מודל הרישום, מה קורה בזמן האתחול כאשר רישיון אינו מכסה תוסף, וכיצד לחבר צופה משלך.
רישום תוסף
כל חבילת תוסף חושפת מחלקת תוסף אחת. רשם אותה פעם אחת, ב‑Application_Start:
Doconut.DoconutHost.Initialize(options =>
{
options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
options.AddPlugin<Doconut.Plugins.Dicom.DicomPlugin>();
});
// תוסף רשום שחסר לו רישיון נזרק כאן, ב‑Application_Start, וה
// האתר לאחר מכן משיב לכל בקשה עם 500 ריק. הסיבה נמצאת ביומן האירועים של Windows.AddPlugin<TPlugin>() יוצר את התוסף ומאפשר לו לרשום את התרומות שלו עם DoconutOptions. כל מה שתוסף תורם מתוייג עם היכולת הנדרשת של התוסף, ו‑DoconutHost.Initialize בודק כל תוסף רשום מול הרישיון לפני שהאתר משרת את הבקשה הראשונה.
רישיון תוסף חסר עוצר את האתר
כאשר אין רישיון פעיל שמעניק את היכולת של תוסף רשום — אין רישיון כלל, קובץ TRIAL מיושן, או רישיון בתשלום ללא היכולת הזאת — DoconutHost.Initialize זורק InvalidOperationException מ‑Application_Start:
The Converter plugin is registered via AddPlugin but no active license grants Converter.
Remove the AddPlugin<...>() call or install a license (or trial/demo) that includes Converter.ב‑System.Web, חריגה ב‑Application_Start אינה מייצרת דף שגיאה. כל בקשה מחזירה 500 ריק, יומן ה‑IIS אינו מציג מידע מועיל, וההודעה מופיעה רק ביומן האירועים של Windows (יומן יישומים, מקור ASP.NET). כאשר אתר מפסיק להגיב מיד אחרי שהתווספה שורת AddPlugin, בדוק תחילה את קבצי הרישיון ב‑wwwroot — ראה הגדרת רישיון.
החוזה
תוסף מיישם ממשק קטן במכוון:
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.רישיון זמני פעיל מעניק כל יכולת. זה הפתעה קלאסית בזמן השקה: אותן שורות AddPlugin שהורצו במהלך ההערכה עוצרות את האתר כאשר הרישיון שנרכש משמיט אחת מהיכולות האלה. השווה את IsCapabilityGranted(...) עם מה שרכשת לפני הפריסה. עם אין רישיון כלל, שום דבר אינו ניתנת — רישיון חסר אינו רישיון זמני.
ההגבלה הזו מגיעה גם לדפדפן: Viewer.ReferenceScripts() ו‑ReferenceCss() משדרים את הקבצים לתכונות המוגבלות ברישיון (חיפוש, הערה) רק כאשר הרישיון מעניק אותן, ולכן העמוד לעולם לא מציע תכונה שהשרת יסרב לה.
מפת תכונות ותוספים
| תכונה | איך זה מופעל | יכולת | תורם |
|---|---|---|---|
| הערה | מובנה בצופה; כולל את משאבי ההערה | Annotation | כתיבה בדפדפן, שמירת מושב, ייצוא מוטבע |
| חיפוש | מובנה בצופי פורמטים ניתנים לחיפוש; כולל את משאבי החיפוש | Search | אינדקס טקסט מקורי, הדגשות, ניווט בתוצאות |
| ממיר | התקן Doconut.NETFramework.Converter ורשום ConverterPlugin | Converter | שירות המרה ב‑C# ווידג'ט רשת אופציונלי |
| DICOM | התקן Doconut.NETFramework.Dicom ורשום DicomPlugin | Dicom | צפייה בתמונות רפואיות עבור .dcm ו‑.ima |
| חותם | התקן Doconut.NETFramework.Signer ורשום SignerPlugin | Signer | חתימות נראות ואמות דיגיטליות ל‑PDF ול‑Word: שירות חתימה ב‑C# ווידג'ט רשת אופציונלי |
ההערה והחיפוש אינם משתמשים ב‑AddPlugin<TPlugin>(). ל‑Converter, DICOM ול‑Signer יש כל אחד דף תחת תוספים עם ההגדרות והשימוש שלהם. בחבילה זו, DICOM מציג דפים, מסגרות והנפשות, אך אינו קורא מטא‑נתונים טכניים — ראה תוסף DICOM.
צופים מותאמים — מטפל בפורמט שלך
אתה יכול לחבר צופה לצינור ללא כתיבת חבילת תוסף, ישירות ב‑Application_Start:
Doconut.DoconutHost.Initialize(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.
מסקנות
- תוספים נרשמים במפורש ב‑
DoconutHost.Initialize, והיכולות שלהם מאומתות שם; זכות חסרה עוצרת את האתר עם500ריק שהסיבה שלו נמצאת ביומן האירועים של Windows. - תוספים בסגנון Override מתדרדרים בעדינות; פורמטים רק‑תוסף נכשלים עם
LicenseException. - רישיון זמני פעיל פותח את הכל; בייצור נפתחות רק מה שרכשת. בדוק עם
IDoconutLicenseServiceלפני השחרור.
האם דף זה היה מועיל?