Görüntüleyicinin Nasıl Çalıştığı

Belge İstek Yaşam Döngüsü

Doconut, belgeleri sayfalı görüntüler olarak işler ve bu görüntüler, sizin Web.config kaydeden bir HTTP işleyicisi tarafından sunulur. Yaşam döngüsünü — açma, token, sayfa istekleri, kapama — anlamak, gözlemleyeceğiniz hemen hemen her davranışı, hata mesajları dahil, açıklar.

Hareketli parçalar

  • Viewer — DoconutHost.Services'den çözdüğünüz genel hizmet. Belgeleri açar ve oturum token'ları döndürür.
  • Belge oturumu — yüklü belgeyi tutan, token'ı altında bellekte saklanan sunucu tarafı nesne.
  • DocImage.axd — Web.config içinde bildirilen Doconut.DocImageHandler. Tarayıcı widget'ının yaptığı her isteğe (sayfalar, küçük resimler, arama, ek açıklamalar, …) yanıt verir ve her zaman token ile tanımlanır.
  • /doconut-res/* — widget'ın kendi betiklerini, stillerini ve simgelerini sunan Doconut.DoconutResourceModule.

Viewer durum bilgisizdir — tasarım gereği

Viewer, istek başına belge durumu tutmaz ve IDisposable uygulamaz. Oturumlar ondan bağımsız olarak yaşar ve süresi dolma ya da açık bir CloseDocument(token) ile temizlenir. System.Web'de yapılandırıcı enjeksiyonu yoktur, bu yüzden ihtiyacınız olduğunda çözün — genellikle bir denetleyici eyleminde:

csharp
// POST /ViewerApi/Open?fileName=Sample.pdf
[HttpPost]
public async Task<ActionResult> Open(string fileName)
{
    var viewer = Doconut.DoconutHost.Services.GetRequiredService<Viewer>();
    var path   = Server.MapPath("~/files/" + Path.GetFileName(fileName));

    var token = await viewer.OpenDocumentAsync(path);
    return Content(token, "text/plain");
}

OpenDocumentAsync içinde neler olur

  1. Lisans kapısı. Reddedilen bir lisans (manipüle edilmiş, kara listeye alınmış veya lisansın güncelleme penceresinin dışındaki bir yapı) hemen LicenseException fırlatır, nedeni mesaj olarak verir. Açma işlemi, geçersiz bir lisans için asla sessizce bozulmaz; eksik bir lisans yalnızca filigran ekler.
  2. Oturum oluşturma. Görüntüleyici fabrikası, dosya uzantısı için uygun format görüntüleyicisini seçer ve belgeyi yükler (Rendering Pipeline bakınız). Oturum, yeni rastgele bir token altında, kaydırmalı süresi dolma süresi DocOptions.TimeOut dakika (varsayılan 60) ile bellekte saklanır. Her sayfa isteği saati sıfırlar.
  3. Erişim izni. UnsafeMode = false (varsayılan) ile token, onu açan isteğin ASP.NET oturumuna bağlanır: o oturuma bir secure-{token} girişi yazılır. Açma işlemi bu yüzden oturum durumu olan bir istekte çalışmalıdır — Sessions & Security bakınız.
  4. Token döndürülür. Sonraki tüm işlemler için tarayıcının ihtiyaç duyduğu tek tanımlayıcıdır.

Asenkron aşırı yüklemeler bir dosya yolu, bir dosya yolu artı format başına yapılandırma (PdfConfig, WordConfig, …) veya formatı uzantısı seçen bir Stream artı bir FileInfo alır. Asenkron sayfalar kullanmayan Web Forms kod-arkası için, OpenDocument aynı üç girişi senkron olarak sunar (bir yol, bir dosya adıyla bir akış veya bir dosya adıyla bir bayt dizisi).

Widget sayfaları nasıl alır

Widget, sorgu dizesinde token ile DocImage.axd'i çağırır. İşleyicinin yaptığı, isteğe bağlıdır:

SorguAmaç
?token=…&page=NOluşturulmuş sayfa görüntüsü (PNG)
?token=…&page=N&thumb=1Küçük resim
?token=…&zoom=…Yakınlaştırılmış sayfa görüntüsü
?token=…&search=termTam metin arama (lisans kısıtlamalı)
?token=…&bookmarksBelge taslağı ve yer imleri
?token=…&copy / &showlinks / &fileFormatMetin kopyalama, hiperlinkler ve format bilgisi
?token=…&metaDICOM teknik meta verileri — bu paket için mevcut değil (cevaplar 404)
?token=…&action=rotate/flip/closeSayfa eylemleri ve açık kapanış (POST)
?token=…&AnnSave=… / &AnnLoadKaydet ve yükle ek açıklamalar

Her istek önce kontrol edilir:

  • Token yok → 404, ya da ShowDoconutInfo = true olduğunda bir sürüm banner'ı.
  • Token bu ASP.NET oturumuna verilmemiş → You Are Not Authorized To View This Page. okuyan bir hata resmi
  • Bilinmeyen veya süresi dolmuş token → Document session not found. Please re-open document. okuyan bir hata resmi

Hata görüntüleri, 200 durum kodu ile gönderilen sıradan PNG'lerdir, böylece widget bunları sayfanın olması gereken yerde gösterebilir. Yalnızca durum koduna bakan bir izleme kontrolü, bunları sunulan sayfalar olarak raporlar; gerçek bir sayfa onlarca ila yüzlerce kilobayt iken, bir hata görüntüsü yaklaşık 2 KB'dir.

Bir belgeyi kapatma

csharp
viewer.CloseDocument(token);

CloseDocument oturumu kaldırır (belge motorunu ve belleğini hemen serbest bırakır), mevcut isteğin ASP.NET oturumundan secure-{token} girişini kaldırır ve token'ı iptal eder. Bu isteğe bağlıdır — kaydırmalı süresi dolma aynı temizlik işlemini yapar — ancak büyük belgeler için kullanıcı işi bitirir bitirmez belleği serbest bırakır. Tarayıcıdan, objViewer.Close(true) eşdeğer kapatma isteğini DocImage.axd'e gönderir.

Çıkarımlar

  • Bir açık belge = bir oturum = bir token, onu açan ASP.NET oturumuna verilir.
  • Token, kaydırmalı bir pencere içinde süresi dolar; DocOptions.TimeOut'den sonra boşta kalan bir görüntüleyici yeniden açma gerektirir.
  • Viewer serbestçe çözülebilir ve paylaşılabilir; oturumlar tüm durumu taşır.

Bu sayfa yardımcı oldu mu?