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.configiçinde bildirilenDoconut.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 sunanDoconut.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:
// 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
- Lisans kapısı. Reddedilen bir lisans (manipüle edilmiş, kara listeye alınmış veya lisansın güncelleme penceresinin dışındaki bir yapı) hemen
LicenseExceptionfı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. - 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.TimeOutdakika (varsayılan 60) ile bellekte saklanır. Her sayfa isteği saati sıfırlar. - Erişim izni.
UnsafeMode = false(varsayılan) ile token, onu açan isteğin ASP.NET oturumuna bağlanır: o oturuma birsecure-{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. - 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:
| Sorgu | Amaç |
|---|---|
?token=…&page=N | Oluşturulmuş sayfa görüntüsü (PNG) |
?token=…&page=N&thumb=1 | Küçük resim |
?token=…&zoom=… | Yakınlaştırılmış sayfa görüntüsü |
?token=…&search=term | Tam metin arama (lisans kısıtlamalı) |
?token=…&bookmarks | Belge taslağı ve yer imleri |
?token=…© / &showlinks / &fileFormat | Metin kopyalama, hiperlinkler ve format bilgisi |
?token=…&meta | DICOM teknik meta verileri — bu paket için mevcut değil (cevaplar 404) |
?token=…&action=rotate/flip/close | Sayfa eylemleri ve açık kapanış (POST) |
?token=…&AnnSave=… / &AnnLoad | Kaydet ve yükle ek açıklamalar |
Her istek önce kontrol edilir:
- Token yok →
404, ya daShowDoconutInfo = trueolduğ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
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. Viewerserbestçe çözülebilir ve paylaşılabilir; oturumlar tüm durumu taşır.
Bu sayfa yardımcı oldu mu?