Як працює переглядач

Життєвий цикл запиту документа

Doconut рендерить документи у вигляді розбитих на сторінки зображень, які обслуговуються HTTP‑обробником, який реєструє ваш Web.config. Розуміння життєвого циклу — відкриття, токен, запити сторінок, закриття — пояснює майже всю поведінку, яку ви спостерігатимете, включаючи повідомлення про помилки.

Рухомі частини

  • Viewer — публічний сервіс, який ви отримуєте з DoconutHost.Services. Він відкриває документи та повертає токени сесії.
  • Сесія документа — об’єкт на боці сервера, що містить завантажений документ, зберігається в пам’яті під його токеном.
  • DocImage.axd — Doconut.DocImageHandler, оголошений у Web.config. Він відповідає на кожен запит, який робить віджет браузера (сторінки, мініатюри, пошук, анотації, …), завжди ідентифікований токеном.
  • /doconut-res/* — Doconut.DoconutResourceModule, який обслуговує власні скрипти, стилі та іконки віджета.

Viewer без стану — за задумом

Viewer не зберігає стан документа для кожного запиту і не реалізує IDisposable. Сесії існують незалежно від нього і очищуються внаслідок закінчення терміну або явного CloseDocument(token). У System.Web немає ін’єкції через конструктор, тому отримуйте його там, де потрібен — зазвичай у дії контролера:

csharp
// POST /ViewerApi/Open?fileName=Sample.pdf
[HttpPost]
public async Task<ActionResult> Open(string fileName)
{
    var viewer = Doconut.DoconutHost.Services.GetRequiredService<Viewer>();
    var path   = Server.MapPath("~/files/" + Path.GetFileName(fileName));

    var token = await viewer.OpenDocumentAsync(path);
    return Content(token, "text/plain");
}

Що відбувається всередині OpenDocumentAsync

  1. Ліцензійна перевірка. Відхилена ліцензія (підроблена, у чорному списку або збірка поза вікном оновлення ліцензії) миттєво генерує LicenseException, причиною чого є повідомлення. Відкриття ніколи не деградує без повідомлення для недійсної ліцензії; відсутня ліцензія лише додає водяний знак.
  2. Створення сесії. Фабрика переглядача вибирає переглядач формату за розширенням файлу та завантажує документ (див. Конвеєр рендерингу). Сесія зберігається в пам’яті під новим випадковим токеном з ковзним терміном дії DocOptions.TimeOut хвилин (за замовчуванням 60). Кожен запит сторінки скидає таймер.
  3. Надання доступу. За допомогою UnsafeMode = false (за замовчуванням) токен прив’язується до ASP.NET сесії запиту, який його відкрив: у цю сесію записується запис secure-{token}. Тому відкриття має виконуватись у запиті з станом сесії — див. Сесії та безпека.
  4. Токен повертається. Це єдиний ідентифікатор, який потрібен браузеру для всього подальшого.

Асинхронні перевантаження приймають шлях до файлу, шлях до файлу плюс конфігурацію для конкретного формату (PdfConfig, WordConfig, …) або Stream плюс FileInfo, розширення якого визначає формат. Для коду‑бекенду Web Forms, який не використовує асинхронні сторінки, OpenDocument пропонує ті ж три входи синхронно (шлях, потік з ім’ям файлу або масив байтів з ім’ям файлу).

Як віджет отримує сторінки

Віджет викликає DocImage.axd з токеном у рядку запиту. Те, що робить обробник, залежить від запиту:

ЗапитПризначення
?token=…&page=NЗображення відрендереної сторінки (PNG)
?token=…&page=N&thumb=1Мініатюра
?token=…&zoom=…Збільшене відображення сторінки
?token=…&search=termПовнотекстовий пошук (з ліцензійним обмеженням)
?token=…&bookmarksСтруктура документа та закладки
?token=…&copy / &showlinks / &fileFormatКопіювання тексту, гіперпосилання та інформація про формат
?token=…&metaТехнічні метадані DICOM — недоступні в цьому пакеті (відповідає 404)
?token=…&action=rotate/flip/closeДії зі сторінками та явне закриття (POST)
?token=…&AnnSave=… / &AnnLoadЗбереження та завантаження анотацій

Кожен запит спочатку перевіряється:

  • Відсутній токен → 404, або банер версії, коли ShowDoconutInfo = true.
  • Токен не надано цій ASP.NET сесії → зображення помилки з текстом You Are Not Authorized To View This Page.
  • Невідомий або прострочений токен → зображення помилки з текстом Document session not found. Please re-open document.

Зображення помилок — це звичайні PNG, які надсилаються зі статусом 200, тому віджет може показати їх там, де мала б бути сторінка. Перевірка моніторингу, яка дивиться лише на код статусу, буде вважати їх обслугованими сторінками; реальна сторінка важить десятки‑сотні кілобайт, а зображення помилки — близько 2 КБ.

Закриття документа

csharp
viewer.CloseDocument(token);

CloseDocument видаляє сесію (одразу звільняючи движок документа та його пам’ять), видаляє запис secure-{token} з ASP.NET сесії поточного запиту та анулює токен. Це необов’язково — ковзний термін дії виконує те ж очищення — але для великих документів це звільняє пам’ять одразу після завершення користувачем. З браузера objViewer.Close(true) надсилає еквівалентний запит на закриття до DocImage.axd.

Висновки

  • Одне відкриття документа = одна сесія = один токен, наданий ASP.NET сесії, яка його відкрила.
  • Токен закінчує термін дії у ковзному вікні; переглядач, який залишився без активності понад DocOptions.TimeOut, потребує повторного відкриття.
  • Viewer можна отримати та вільно ділитися; сесії несуть весь стан.

Чи була ця сторінка корисною?