DoconutOptions
Doconut hizmetlerini yapılandırın
DoconutOptions (namespace Doconut) bütün SDK için tek yapılandırma nesnesidir. Bunu bir kez, AddDoconut() içinde yapılandırırsınız ve tek bir örnek olarak kaydedilir.
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
options.UnsafeMode = false;
options.ShowDoconutInfo = false;
options.AddPlugin<Doconut.Plugins.Dicom.DicomPlugin>();
});Properties
| Tür | Özellik | Varsayılan | Açıklama |
|---|---|---|---|
bool | ShowDoconutInfo | false | true olduğunda, bir token içermeyen middleware isteği 404 yerine bir sürüm banner'ı (Doconut <version> is running on <host>) döndürür. Duman kontrolü olarak faydalıdır; üretimde false bırakın. |
bool | UnsafeMode | false | true olduğunda, sayfa isteklerinde ASP.NET oturum güvenlik kontrolünü atlar. Üretimde false bırakın (bkz. Core Concepts → Sessions & Security). |
string | MiddlewarePath | "/doconut" | Sayfa-görüntü uç noktası için koordinasyon değeri. Doğrulanır, ancak bir pipeline dalı bağlamaz; gerçek UseDoconut() eşlemesi ve istemci BasePath ile uyumlu tutun. |
string | ResourcesPath | "/doconut-res" | Gömülü JS/CSS/görüntü/font kaynakları için URL yol ön eki. |
string | LicensePath | "" | Lisans dosyasının yolu. Boş → sonraki lisans kaynağı, ardından otomatik keşif; hiçbir şey bulunamazsa → özellikleri olmayan su işaretiyle değerlendirme durumu. |
string | LicenseContent | "" | Ham XML lisans içeriği (veritabanı, ortam değişkeni, gizli yönetici). LicensePath üzerindeki önceliği vardır. |
Stream? | LicenseStream | null | Lisans bir akış olarak, başlangıçta bir kez okunur. Diğer iki kaynağa göre önceliklidir. |
bool | ResetLicense | false | Ayrılmış uyumluluk bayrağı. Mevcut .NET 6 uygulaması bunu kullanmaz; bir lisans değiştirildikten sonra uygulamayı yeniden başlatın. |
DoconutPluginRegistry | PluginRegistry | — | Eklenti katkılarını toplayan yalnızca okunabilir kayıt defteri; görüntüleyici fabrikası tarafından tüketilir. AddPlugin<T>() aracılığıyla doldurun. |
Lisans önceliği (servis kaydı sırasında uygulanır): LicenseStream → LicenseContent → LicensePath → otomatik keşif (bkz. Getting Started → License Setup).
Methods
AddPlugin<TPlugin>()
DoconutOptions AddPlugin<TPlugin>() where TPlugin : IDoconutPlugin, new()Bu yöntemi yayınlanan isteğe bağlı Converter, DICOM ve Signer paketleri için kullanın. Açıklama ve normal Arama, yerleşik lisanslı özelliklerdir ve AddPlugin<TPlugin>() kullanmaz.
Bir birinci taraf eklentiyi (Converter, DICOM, Signer) kaydeder. Akıcı — seçenek örneğini döndürür. AddDoconut() eksik lisans, eski TRIAL dosyası veya eklentinin yeteneğini vermeyen ücretli lisans için InvalidOperationException fırlatır. Geçici/Demo kayıtları süresi dolana kadar tutulur ve çalışma zamanı kapısına tabi olur (bkz. Core Concepts → Plugin System).
İsteğe bağlı Converter widget'ı AddConverterWidget() ile etkinleştirilir ve yalnızca okunabilir ConverterWidget özelliği aracılığıyla sunulur; seçenekleri Converter Plugin sayfasında belgelenmiştir (Plugins → Converter Plugin). İsteğe bağlı Signer widget'ı aynı şekilde, AddSignerWidget() ile etkinleştirilir ve yalnızca okunabilir SignerWidget özelliği aracılığıyla sunulur; bakınız Signer Plugin.
RegisterViewer(extension, factory, defaultConfig?)
DoconutOptions RegisterViewer(
string extension, // ".myext" — başındaki nokta isteğe bağlı
Func<IFormatViewer> factory,
Func<BaseConfig>? defaultConfig = null)Bir dosya uzantısı için özel görüntüleyici kaydeder. Özel görüntüleyiciler yerleşik ve eklenti görüntüleyicilere göre önceliklidir ve lisans kısıtlamasına tabi değildir. defaultConfig atlandığında ve bir belge açıkça bir yapılandırma olmadan açıldığında, bir ImageConfig kullanılır.
Boş uzantı için ArgumentException (Extension must be a non-empty file extension.) ve null fabrika için ArgumentNullException fırlatır.
Startup validation
AddDoconut() seçenekleri hızlı başarır (fail-fast) doğrular, böylece bir yapılandırma hatası, istek zamanındaki kafa karıştırıcı 404'ler yerine başlangıçta net bir istisna olarak ortaya çıkar:
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.Common configurations
// Production: açık lisans, her şey kilitlendi (tüm güvenlik varsayılanları)
builder.Services.AddDoconut(options =>
{
options.LicenseContent = builder.Configuration["Doconut:License"] ?? "";
});
// Özel yollar (e.g. bir rota çakışmasını önlemek için)
builder.Services.AddDoconut(options =>
{
options.MiddlewarePath = "/docs-engine";
options.ResourcesPath = "/docs-assets";
});ResourcesPath değiştirdiğinizde, istemci widget'ının ResPath değerini senkronize tutun (bkz. ViewerConfig).
MiddlewarePath otomatik bir ASP.NET Core yol eşleyicisi değildir. Doconut yalnızca özel bir ön ek altında yanıt vermeli ise, UseDoconut()'ı o dalda (örneğin app.Map("/docs-engine", branch => branch.UseDoconut()) ile) bağlayın ve istemci BasePath'ı ön ekin başındaki / olmadan ayarlayın ('docs-engine').
Bu sayfa yardımcı oldu mu?