DoconutExtensions

Servis ve ara katman kaydı

DoconutExtensions (namespace Doconut.Middleware) her Doconut ana bilgisayarının yaptığı üç çağrıyı içeren statik sınıftır: bir servis kaydı ve iki ara katman kaydı.

csharp
builder.Services.AddDoconut(options => { /* … */ });
// …
app.UseSession();          // UseSession()'i UseDoconut()'dan önce çağırın
app.UseDoconutResources(); // UseDoconut()'dan önce kaydedilmelidir
app.Map("/doconut", branch => branch.UseDoconut());

UseDoconut() ulaşan her isteği yanıtlar, bu yüzden onu kendi dalına app.Map ile monte edin.

AddDoconut (Ekle)

text
IServiceCollection AddDoconut(this IServiceCollection services, Action<DoconutOptions>? configure = null)

DoconutOptions oluşturur, onları hızlı hata kontrolüyle doğrular (bkz. DoconutOptions → Başlangıç doğrulaması), ve tam servis grafiğini kaydeder:

ServisÖmürRol
DoconutOptionsSingletonYapılandırma nesnesi
Oturum önbellek servisiSingletonToken → oturum önbelleği (IMemoryCache da kaydedilir)
IDoconutLicenseServiceSingletonLisans başlangıçta bir kez yüklenir (öncelik: LicenseStream → LicenseContent → LicensePath → otomatik arama)
Sayfa‑görüntü işlem hattıSingletonSayfalar için görüntü işleme gerçekleştirir (filigran, döndürme, ölçekleme, açıklamalar)
Belge güvenliği (erişim deposu)SingletonToken‑oturum bağlaması için izinler
ViewerTransientGenel açık/kapalı arayüz
DocumentConverterTransientDönüştürme arayüzü — Converter eklentisini gerektirir
DocumentSignerTransientİmzalama arayüzü — Signer eklentisini gerektirir (bkz. Signer Eklentisi)
DistributedDocumentPublisherTransientBir belgenin artefaktlarını paylaşılan depolamaya yayınlar (bkz. Dağıtılmış Dağıtımlar)
Sağlık kontrolü "doconut"—Lisans/son kullanma durumunu ASP.NET sağlık kontrolleri aracılığıyla raporlar

Bilmeniz gereken iki davranış:

  • Converter eklentisini gerektirir. DocumentConverter çözümlemesi options.AddPlugin<ConverterPlugin>() olmadan hata fırlatır:
text
InvalidOperationException: No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>().

DocumentSigner aynı kuralı izler: options.AddPlugin<SignerPlugin>() olmadan No IDocumentSigner is registered. Add the signing plugin: options.AddPlugin<Doconut.Plugins.Signer.SignerPlugin>(). fırlatır

  • Eklenti yetkisi başlangıçta doğrulanır. Eksik bir lisans, eski TRIAL dosyası veya kayıtlı bir eklenti yeteneği olmadan ücretli lisans, AddDoconut() zamanında başarısız olur. Geçici/Demo kayıtları son kullanma tarihlerini geçer, ancak çalışma zamanı kapıları süresi dolmuş yetenekleri iptal eder.

Sağlık kontrolü standart ASP.NET Core mekanizmasıyla bütünleşir — lisans durumunu sağlık uç noktanızda görmek istiyorsanız haritalayın:

csharp
app.MapHealthChecks("/health");

UseDoconut (Kullan)

text
IApplicationBuilder UseDoconut(this IApplicationBuilder app)

Doconut sayfa‑görüntü ara katmanını ekler. ?token= sorgu parametresini taşıyan her isteği — sayfalar, küçük resimler, arama, açıklamalar, sayfa eylemleri (tam istek tablosu Core Concepts → How the Viewer Works içinde) — hizmet eder ve diğer tüm istekleri 404 (veya ShowDoconutInfo banner) ile yanıtlar: isteği pipeline'ın geri kalanına asla iletmez. Bu sayfadaki örneklerde olduğu gibi kendi dalına monte edin. UnsafeMode false olduğunda, belge‑güvenliği katmanı otomatik olarak önceden bağlanır.

Yaygın bir alternatif, tarihi DocImage.axd istek biçimini bir MapWhen dalı ile korur (istemci daha sonra BasePath: '/' kullanır):

csharp
app.MapWhen(
    ctx => ctx.Request.Path.Value?.EndsWith("DocImage.axd", StringComparison.OrdinalIgnoreCase) == true,
    branch => branch.UseDoconut());

UseDoconutResources (Kaynakları Kullan)

text
IApplicationBuilder UseDoconutResources(this IApplicationBuilder app)

Gömülü JS, CSS, görüntüler ve yazı tiplerini DoconutOptions.ResourcesPath (varsayılan /doconut-res) adresinde hizmet eder. Bunlar, Viewer.ReferenceCss() / ReferenceScripts() etiketleri için üreten dosyalardır.

Her zaman UseDoconut()'den önce çağırın. Görüntüleyici alanı boş kalır ve tarayıcı konsolu /doconut-res/... için 404 hataları gösterirse, bu çağrı eksik ya da yanlış konumlandırılmış demektir.

Paylaşılan Depolamadan Hizmet Verme

Belgeyi işleyen düğümün sayfalarını hizmet eden düğüm olması gerekmeyen dağıtımlar için iki ek kayıt mevcuttur. İkisi de Dağıtılmış Dağıtımlar içinde uçtan uca kapsanır; imzalar şunlardır:

text
IServiceCollection AddDoconutDistributedAsyncPublish(this IServiceCollection services, Action<DistributedAsyncPublishOptions>? configure = null)   // isteğe bağlı arka plan yayın kuyruğu
IServiceCollection AddDoconutDistributedWidgets(this IServiceCollection services, Action<DistributedWidgetsOptions> configure)                     // widget yüklemeleri için paylaşılan arka depolama

Okuma tarafı, aynı pakette gelen Doconut.Clouds derlemesinden ayrı bir ara katmandır:

text
IApplicationBuilder UseDoconutCloud<THandler>(
    this IApplicationBuilder app,
    Action<CloudOptions>? configure = null,
    string pathPrefix = "/doconut-cloud")
    where THandler : BaseCloudHandler

Sıralama Özeti

csharp
app.UseRouting();
app.UseSession();          // UseSession()'i UseDoconut()'dan önce çağırın
app.UseDoconutResources(); // UseDoconut()'dan önce kaydedilmelidir
app.Map("/doconut", branch => branch.UseDoconut()); // veya bir MapWhen dalı

Bu sayfa yardımcı oldu mu?