DoconutUzantıları
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ı.
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 (Ekleme)
IServiceCollection AddDoconut(this IServiceCollection services, Action<DoconutOptions>? configure = null)DoconutOptions oluşturur, bunları hızlıca hataya düşecek şekilde doğrular (bkz. DoconutOptions → Başlangıç doğrulaması) ve tam servis grafiğini kaydeder:
| Servis | Ömür | Rol |
|---|---|---|
DoconutOptions | Tekil | Yapılandırma nesnesi |
| Oturum önbellek servisi | Tekil | Token → oturum önbelleği (IMemoryCache de kaydedilir) |
IDoconutLicenseService | Tekil | Başlangıçta bir kez yüklenen lisans (öncelik: LicenseStream → LicenseContent → LicensePath → otomatik arama) |
| Sayfa‑görüntü iş akışı | Tekil | 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) | Tekil | Token‑oturum bağlaması için izinler |
Viewer | Geçici | Halk açık/kapalı arabirimi |
DocumentConverter | Geçici | Dönüştürme arabirimi — Converter eklentisi gerekir |
DocumentSigner | Geçici | İmzalama arabirimi — Signer eklentisi gerekir (bkz. Signer Eklentisi) |
DistributedDocumentPublisher | Geçici | Bir belgenin artefaktlarını paylaşımlı depolamaya yayınlar |
Sağlık kontrolü "doconut" | — | ASP.NET sağlık kontrolleri aracılığıyla lisans/son kullanım durumunu raporlar |
Önceki .NET Standard kütüphanesinde eşdeğer bir çağrı yoktur. Her istek için new Viewer(cache, accessor) oluşturur ve seçenekleri ara katmana iletir; ikisi de bu tek kayıtla değiştirilir.
Bilmeniz gereken iki davranış:
- Converter eklentisi gerekir.
DocumentConverterçözülürkenoptions.AddPlugin<ConverterPlugin>()olmadan 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 yetkisi başlangıçta doğrulanır. Eksik bir lisans, eski
TRIALdosyası veya kaydedilmiş 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 hayatta kalır, 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:
app.MapHealthChecks("/health");UseDoconut (Kullanım)
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 boru hattını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.
Argüman almaz. Burada bir DoconutOptions örneği geçirmek önceki kütüphanenin şekliydi ve artık derlenmez.
Ortak bir kurulum, tarihi DocImage.axd istek şeklini 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 (Kaynaklar)
IApplicationBuilder UseDoconutResources(this IApplicationBuilder app)Gömülü JS, CSS, görüntüler ve yazı tiplerini DoconutOptions.ResourcesPath (varsayılan /doconut-res) adresinde sunar. Bunlar, Viewer.ReferenceCss() / ReferenceScripts() tarafından etiketler oluşturulan 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ıştır.
Bu, gömülü kaynak işleme ara katmanını manuel olarak bağlamak için desteklenen bir değişikliktir.
Paylaşımlı depolamadan hizmet verme
Belgeyi oluşturan düğümün sayfalarını hizmet eden düğüm olması zorunlu olmayan dağıtımlarda iki ek kayıt bulunur. İ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 destek deposuOkuma tarafı, aynı pakette 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 : BaseCloudHandlerUseDoconutWebFarm(...) ve WebFarmOptions bu sürümde mevcut değil. Ayar‑ayara eşleme için geçiş rehberi sayfasına bakın.
Sıralama Özeti
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?