DoconutExtensions
Servis ve middleware 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ı.
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
IServiceCollection AddDoconut(this IServiceCollection services, Action<DoconutOptions>? configure = null)DoconutOptions oluşturur, onları hızlıca başarısızlıkla doğrular (bkz. DoconutOptions → Başlangıç doğrulaması), ve tam servis grafiğini kaydeder:
| Servis | Ömür | Rol |
|---|---|---|
DoconutOptions | Singleton | Yapılandırma nesnesi |
| Oturum önbellek hizmeti | Singleton | Token → oturum önbelleği (IMemoryCache da kaydedilir) |
IDoconutLicenseService | Singleton | Lisans başlangıçta bir kez yüklenir (öncelik: LicenseStream → LicenseContent → LicensePath → otomatik arama) |
| Sayfa-görüntü ardışık düzeni | Singleton | Sayfalar 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) | Singleton | Token‑oturum bağlaması için izinler |
Viewer | Transient | Genel açma/kapatma arabirimi |
DocumentConverter | Transient | Dönüştürme arabirimi — Converter eklentisini gerektirir |
DocumentSigner | Transient | İmzalama arabirimi — Signer eklentisini gerektirir (bkz. Signer Eklentisi) |
DistributedDocumentPublisher | Transient | Bir belgenin artefaktlarını paylaşılan depoya yayınlar (bkz. Dağıtılmış Dağıtımlar) |
Health check "doconut" | — | Lisans/son kullanım durumunu ASP.NET sağlık kontrolleri aracılığıyla raporlar |
Bilmeniz gereken iki davranış:
- Converter eklentisini gerektirir.
DocumentConverter'ıoptions.AddPlugin<ConverterPlugin>()olmadan çözmek bir istisna fırlatır:
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 hakları başlangıçta doğrulanır. Eksik bir lisans, eski
TRIALdosyası veya kayıtlı bir eklentinin yeteneği olmadan ücretli lisans,AddDoconut()zamanında başarısız olur. Geçici/Demo kayıtları son tarihlerini geçse de devam eder, 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 — sağlık uç noktanızda lisans durumunu görmek istiyorsanız haritalayın:
app.MapHealthChecks("/health");UseDoconut
IApplicationBuilder UseDoconut(this IApplicationBuilder app)Doconut sayfa-görüntü middleware'ını ekler. ?token= sorgu parametresi taşıyan her isteği (sayfalar, küçük resimler, arama, açıklamalar, sayfa eylemleri (tam istek tablosu Temel Kavramlar → Görüntüleyicinin Çalışma Şekli 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):
app.MapWhen(
ctx => ctx.Request.Path.Value?.EndsWith("DocImage.axd", StringComparison.OrdinalIgnoreCase) == true,
branch => branch.UseDoconut());UseDoconutResources
IApplicationBuilder UseDoconutResources(this IApplicationBuilder app)Gömülü JS, CSS, görseller ve yazı tiplerini DoconutOptions.ResourcesPath (varsayılan /doconut-res) adresinde sunar. Bunlar, Viewer.ReferenceCss() / ReferenceScripts() etiketleri için üreten dosyalardır.
UseDoconut()'den önce her zaman çağırın. Görüntüleyici alanı boş kalır ve tarayıcı konsolu /doconut-res/... için 404 hataları gösteriyorsa, bu çağrı eksik ya da yanlış konumlandırılmış demektir.
Serving from shared storage
Belgeyi işleyen düğüm, sayfalarını sunan düğüm olmak zorunda olmadığı dağıtımlarda iki ek kayıt daha vardır. İkisi de Dağıtılmış Dağıtımlar içinde uçtan uca kapsanır; imzalar şunlardır:
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 depolamaOkuma tarafı, aynı paket içinde gelen Doconut.Clouds derlemesinden ayrı bir ara katmandır:
IApplicationBuilder UseDoconutCloud<THandler>(
this IApplicationBuilder app,
Action<CloudOptions>? configure = null,
string pathPrefix = "/doconut-cloud")
where THandler : BaseCloudHandlerOrdering recap
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?