איך הצופה עובד
מחזור חיי בקשת המסמך
Doconut מציג מסמכים כתמונות מדורגות המוגשות דרך Middleware של ASP.NET Core. הבנת מחזור החיים — פתיחה, אסימון, בקשות דף, סגירה — מסבירה כמעט כל התנהגות שתראו, כולל הודעות השגיאה.
שלושת החלקים הנעים
Viewer— השירות הציבורי שאתה מוזרק. הוא פותח מסמכים ומחזיר אסימוני סשן.- סשן המסמך — אובייקט בצד השרת שמחזיק את המסמך הטעון, ממופה באמצעות אסימון ב
IMemoryCache. - ה‑Middleware של Doconut — נוסף על ידי
UseDoconut(); משיב לכל בקשה שהווידג'ט של הדפדפן מבצע (pages,thumbnails,search,annotations, …), תמיד מאומת באמצעות האסימון.
Viewer ללא מצב — בכוונה
Viewer סגור, אינו מחזיק במצב מסמך לכל בקשה, ובכוונה לא מממש את IDisposable. סשנים קיימים באופן עצמאי במנהל הסשנים ומנוקים על ידי תפוגת מטמון או CloseDocument(token) מפורש.
הזרק אותו בכל מקום שבו אתה צריך אותו:
app.MapPost("/api/open", async (string fileName, Viewer viewer) =>
{
var token = await viewer.OpenDocumentAsync($"files/{fileName}");
return Results.Content(token, "text/plain");
});מה קורה בתוך OpenDocumentAsync
- שער הרישיון. רישיון שנדחה או שפג תוקפו (ברשימה שחורה, מזויף, או גרסה מחוץ לחלון העדכון של הרישיון) זורק
LicenseExceptionמיידית, עם סיבת הדחייה כהודעה — הפתיחה לעולם לא מתדרדרת בשקט עבור רישיון לא תקף (בניגוד לחסר). רישיון זמני או מנוי שפג תוקפו לפי לוח השנה הוא היוצא מן הכלל: הוא אינו זורק — הוא מתדרדר למים. - יצירת סשן. מפעל הצופה בוחר את הצופה המתאים לפורמט עבור סיומת הקובץ וטוען את המסמך (ראה Rendering Pipeline). הסשן נשמר ב
IMemoryCacheתחת אסימון GUID חדש עם תפוגה מתגלגלת —DocOptions.TimeOutדקות, ברירת מחדל 60. כל בקשת דף מאפסת את השעון. - רישום אבטחה. עם
UnsafeMode = false(ברירת המחדל), האסימון קשור לסשן ASP.NET של המבקש: סמןsecure-{token}נכתב לתוך הסשן, כך שרק סשן הדפדפן שפתח את המסמך יכול לבקש את הדפים שלו. - האסימון מוחזר. הוא האישור היחיד לכל מה שבא אחריו.
שלושת העומס יתר שונים רק בקלט: נתיב קובץ, נתיב קובץ בתוספת תצורת פורמט לכל פורמט (PdfConfig, WordConfig, …), או Stream בתוספת FileInfo שהרחבה שלו מניעה זיהוי פורמט.
איך הווידג'ט מקבל דפים
הווידג'ט של הלקוח קורא ל‑Middleware של Doconut עם האסימון במחרוזת השאילתה. מה שה‑Middleware עושה תלוי בבקשה:
| Query | מטרה |
|---|---|
?token=…&page=N | תמונת דף מרונדרת (PNG) |
?token=…&page=N&thumb=1 | תמונה ממוזערת |
?token=…&zoom=… | רינדור דף מוגדל |
?token=…&search=term | חיפוש טקסט מלא (מבוסס רישיון) |
?token=…&bookmarks | מתאר המסמך/סימניות |
?token=…© / &showlinks / &fileFormat / &meta | העתקת טקסט, קישורים, מידע פורמט, מטא‑נתונים טכניים של DICOM |
?token=…&action=rotate/flip/close | פעולות דף וסגירה מפורשת |
?token=…&AnnSave=… / &AnnLoad | שמירת/טעינת אנוטציות |
כל אחד מהנתיבים האלה מתבצע אימות תחילה:
- אין אסימון → ה‑Middleware מחזיר 404 (או באנר גרסה כאשר
ShowDoconutInfo = true). - אסימון לא ידוע או פג תוקף → תמונת שגיאה עם
Document session not found. Please re-open document. - Middleware של סשן חסר (עם
UnsafeMode = false) → HTTP 500 עםSession middleware not configured. Call UseSession() before UseDoconut(). - אסימון נפתח על ידי סשן דפדפן שונה → תמונת שגיאה עם
You Are Not Authorized To View This Page.
שרת דפים מאחסון משותף במקום מהצומת הפותח הוא סידור שונה לחלוטין; ראה פריסות מבוזרות.
סגירת מסמך
viewer.CloseDocument(token);CloseDocument מסיר את הסשן מהמטמון (שמשחרר את מנוע המסמך הבסיסי ומשחרר את הזיכרון שלו מייד), מוחק את הסמן secure-{token}, ומבטל את ההרשאה לגישה. קריאה אליו היא אופציונלית — תפוגה מתגלגלת עושה את אותו ניקוי אוטומטית — אך עבור מסמכים גדולים זו הדרך המנומסת לשחרר זיכרון ברגע שהמשתמש סיים.
מסקנות
- מסמך פתוח אחד = סשן אחד = אסימון אחד. אסימונים הם לכל סשן דפדפן, לא כתובות URL גלובליות.
- האסימון פג בתפוגה מתגלגלת; צופה שנשאר במצב מנוחה מעבר ל
DocOptions.TimeOutצריך פתיחה מחדש. Viewerניתן להזרקה ולשיתוף בחופשיות; סשנים נושאים את כל המצב.
האם דף זה היה מועיל?