DoconutOptions

Налаштуйте сервіси Doconut

DoconutOptions (namespace Doconut) є єдиним об’єктом конфігурації для всього SDK. Ви налаштовуєте його один раз, всередині AddDoconut(), і він реєструється як singleton.

Це зміна не лише розташування, а й форми. У попередній бібліотеці .NET Standard екземпляр DoconutOptions створювався під час конвеєра і передавався UseDoconut(new DoconutOptions { … }). Тут проміжне програмне забезпечення не приймає жодних параметрів — все налаштовується під час реєстрації сервісу.

csharp
builder.Services.AddDoconut(options =>
{
    options.LicensePath     = "Doconut.Viewer.lic";
    options.UnsafeMode      = false;
    options.ShowDoconutInfo = false;
    options.AddPlugin<Doconut.Plugins.Dicom.DicomPlugin>();
});

Властивості

ТипВластивістьЗа замовчуваннямОпис
boolShowDoconutInfofalseКоли true, запит проміжного програмного забезпечення без токену повертає банер версії (Doconut <version> is running on <host>) замість 404. Корисно як швидка перевірка; залиште false у продакшн.
boolUnsafeModefalseКоли true, пропускає перевірку безпеки ASP.NET‑сесії при запитах сторінок. Залиште false у продакшн на одному вузлі (див. Основні концепції → Сесії та безпека). Раніше писалося UnSafeMode.
stringMiddlewarePath"/doconut"Значення координації для кінцевої точки page-image. Воно валідовано, але не монтує гілку конвеєра; тримайте його узгодженим з реальним відображенням UseDoconut() та клієнтським BasePath.
stringResourcesPath"/doconut-res"Префікс URL‑шляху для вбудованих ресурсів JS/CSS/зображень/шрифтів.
stringLicensePath""Шлях до файлу ліцензії. Порожньо → наступне джерело ліцензії, потім автоматичне виявлення; якщо нічого не знайдено → стан оцінки з водяним знаком без можливостей.
stringLicenseContent""Необроблений XML‑вміст ліцензії (база даних, змінна середовища, менеджер секретів). Має пріоритет над LicensePath.
Stream?LicenseStreamnullЛіцензія у вигляді потоку, читається один раз під час запуску. Має пріоритет над обома іншими джерелами.
boolResetLicensefalseЗарезервований прапорець сумісності. Поточна реалізація його не використовує; перезапустіть застосунок після заміни ліцензії.
DoconutPluginRegistryPluginRegistry—Реєстр лише для читання, що збирає внески плагінів; використовується фабрикою переглядачів. Заповнюйте через AddPlugin<T>().

Пріоритет ліцензій (застосовується під час реєстрації сервісу): LicenseStream → LicenseContent → LicensePath → автоматичне виявлення (див. Початок роботи → Налаштування ліцензії).

Методи

AddPlugin<TPlugin>()

text
DoconutOptions AddPlugin<TPlugin>() where TPlugin : IDoconutPlugin, new()

Використовуйте цей метод для випущених opt‑in пакетів Converter, DICOM та Signer. Анотація та звичайний Пошук — вбудовані ліцензовані функції і не використовують AddPlugin<TPlugin>().

Реєструє плагін першої сторони (Converter, DICOM, Signer). Fluent — повертає екземпляр параметрів. AddDoconut() викидає InvalidOperationException при відсутній ліцензії, застарілому файлі TRIAL або платній ліцензії, що не надає можливість плагіну. Тимчасові/демо‑реєстрації зберігаються після закінчення терміну дії та підлягають runtime‑вратам (див. Основні концепції → Система плагінів).

Віджет opt‑in Converter активується за допомогою AddConverterWidget() і доступний через властивість лише для читання ConverterWidget; його параметри задокументовані на сторінці Плагіни → Converter Plugin. Віджет opt‑in Signer активується аналогічно, за допомогою AddSignerWidget(), і доступний через властивість лише для читання SignerWidget; див. Signer Plugin.

RegisterViewer(extension, factory, defaultConfig?)

text
DoconutOptions RegisterViewer(
    string extension,                    // ".myext" — початкова крапка необов’язкова
    Func<IFormatViewer> factory,
    Func<BaseConfig>? defaultConfig = null)

Реєструє користувацький переглядач для розширення файлу. Користувацькі переглядачі мають пріоритет над вбудованими та переглядачами плагінів і не залежать від ліцензії. Якщо defaultConfig пропущено і документ відкривається без явної конфігурації, використовується ImageConfig.

Викидає ArgumentException (Extension must be a non-empty file extension.) при порожньому розширенні та ArgumentNullException для null‑фабрики.

Перевірка під час запуску

AddDoconut() перевіряє параметри fail‑fast, тому помилкова конфігурація проявляється як чітке виключення під час запуску, а не як заплутані 404 під час запиту:

text
DoconutOptions.MiddlewarePath must be a non-empty path starting with '/'.
DoconutOptions.ResourcesPath must be a non-empty path starting with '/'.
DoconutOptions.MiddlewarePath and ResourcesPath must be different paths.

Загальні конфігурації

csharp
// Продакшн: явна ліцензія, все заблоковано (всі типові налаштування безпеки)
builder.Services.AddDoconut(options =>
{
    options.LicenseContent = builder.Configuration["Doconut:License"] ?? "";
});

// Користувацькі шляхи (наприклад, щоб уникнути конфлікту маршруту)
builder.Services.AddDoconut(options =>
{
    options.MiddlewarePath = "/docs-engine";
    options.ResourcesPath  = "/docs-assets";
});

Коли ви змінюєте ResourcesPath, тримайте ResPath клієнтського віджету синхронізованим (див. ViewerConfig). Це одне з двох налаштувань на боці клієнта, які можуть не працювати без повідомлення про помилку.

MiddlewarePath не є автоматичним мапером маршрутів ASP.NET Core. Якщо Doconut має відповідати лише під кастомним префіксом, змонтуйте UseDoconut() на цій гілці (наприклад за допомогою app.Map("/docs-engine", branch => branch.UseDoconut())) і встановіть клієнтське BasePath на цей префікс без початкового / ('docs-engine'). Поширена альтернатива зберігає історичну форму запиту DocImage.axd на гілці MapWhen з BasePath: '/'.

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