Πώς Λειτουργεί ο Προβολέας
Ο κύκλος ζωής του αιτήματος εγγράφου
Το Doconut αποδίδει έγγραφα ως σελίδες εικόνων, που εξυπηρετούνται από έναν HTTP handler που καταχωρεί το Web.config σας. Η κατανόηση του κύκλου ζωής — άνοιγμα, διακριτικό, αιτήματα σελίδας, κλείσιμο — εξηγεί σχεδόν κάθε συμπεριφορά που θα παρατηρήσετε, συμπεριλαμβανομένων των μηνυμάτων σφάλματος.
Τα κινούμενα μέρη
Viewer— η δημόσια υπηρεσία που επιλύετε από τοDoconutHost.Services. Ανοίγει έγγραφα και επιστρέφει διακριτικά συνεδρίας.- Η συνεδρία εγγράφου — ένα αντικείμενο στο διακομιστή που κρατά το φορτωμένο έγγραφο, διατηρείται στη μνήμη υπό το διακριτικό του.
DocImage.axd— τοDoconut.DocImageHandlerπου δηλώνεται στοWeb.config. Απαντά σε κάθε αίτημα που κάνει το widget του προγράμματος περιήγησης (σελίδες, μικρογραφίες, αναζήτηση, σημειώσεις, …), πάντα αναγνωρίζεται από το διακριτικό./doconut-res/*— τοDoconut.DoconutResourceModule, το οποίο εξυπηρετεί τα δικά του scripts, styles και εικονίδια του widget.
Viewer είναι χωρίς κατάσταση — σχεδιαστικά
Viewer δεν διατηρεί κατάσταση εγγράφου ανά αίτημα και δεν υλοποιεί IDisposable. Οι συνεδρίες ζουν ανεξάρτητα από αυτό και καθαρίζονται με λήξη ή με ρητό CloseDocument(token). Το System.Web δεν έχει injection κατασκευής, οπότε επιλύστε το όπου το χρειάζεστε — συνήθως σε μια ενέργεια ελεγκτή:
// 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
- Πύλη άδειας. Μια απορριφθείσα άδεια (παραποιημένη, σε μαύρη λίστα, ή μια έκδοση εκτός του παραθύρου ενημέρωσης της άδειας) ρίχνει το
LicenseExceptionαμέσως, με τον λόγο ως μήνυμα. Το άνοιγμα δεν υποβαθμίζεται σιωπηρά για μια μη έγκυρη άδεια· μια ελλιπής άδεια προσθέτει μόνο υδατογράφημα. - Δημιουργία συνεδρίας. Η εργοστασιακή μονάδα προβολέα επιλέγει τον προβολέα μορφής για την επέκταση του αρχείου και φορτώνει το έγγραφο (δείτε το Rendering Pipeline). Η συνεδρία αποθηκεύεται στη μνήμη κάτω από ένα νέο τυχαίο διακριτικό με κυλιόμενη λήξη των
DocOptions.TimeOutλεπτών (προεπιλογή 60). Κάθε αίτημα σελίδας επαναφέρει το ρολόι. - Παραχώρηση πρόσβασης. Με το
UnsafeMode = false(η προεπιλογή), το διακριτικό δεσμεύεται στην συνεδρία ASP.NET του αιτήματος που το άνοιξε: μια καταχώρησηsecure-{token}γράφεται σε αυτή τη συνεδρία. Το άνοιγμα πρέπει επομένως να εκτελείται σε αίτημα με κατάσταση συνεδρίας — δείτε το Sessions & Security. - Το διακριτικό επιστρέφεται. Είναι ο μοναδικός αναγνωριστικός που χρειάζεται το πρόγραμμα περιήγησης για όλα τα επόμενα.
Οι ασύγχρονες υπερφορτώσεις δέχονται μια διαδρομή αρχείου, μια διαδρομή αρχείου συν μια διαμόρφωση ανά μορφή (PdfConfig, WordConfig, …), ή ένα Stream συν ένα FileInfo του οποίου η επέκταση επιλέγει τη μορφή. Για κώδικα-πίσω Web Forms που δεν χρησιμοποιεί ασύγχρονες σελίδες, το OpenDocument προσφέρει τις ίδιες τρεις εισόδους συγχρονικά (μια διαδρομή, ένα stream με όνομα αρχείου, ή έναν πίνακα byte με όνομα αρχείου).
Πώς το widget λαμβάνει σελίδες
Το widget καλεί το DocImage.axd με το διακριτικό στη συμβολοσειρά ερωτήματος. Το τι κάνει ο handler εξαρτάται από το αίτημα:
| Ερώτημα | Σκοπός |
|---|---|
?token=…&page=N | Απόδοση εικόνας σελίδας (PNG) |
?token=…&page=N&thumb=1 | Μικρογραφία |
?token=…&zoom=… | Απόδοση μεζερισμένης σελίδας |
?token=…&search=term | Αναζήτηση πλήρους κειμένου (με πύλη άδειας) |
?token=…&bookmarks | Δομή εγγράφου και σελιδοδείκτες |
?token=…© / &showlinks / &fileFormat | Αντιγραφή κειμένου, υπερσυνδέσεις και πληροφορίες μορφής |
?token=…&meta | Τεχνικά μεταδεδομένα DICOM — μη διαθέσιμα σε αυτό το πακέτο (απαντά το 404) |
?token=…&action=rotate/flip/close | Ενέργειες σελίδας και ρητό κλείσιμο (POST) |
?token=…&AnnSave=… / &AnnLoad | Αποθήκευση και φόρτωση σημειώσεων |
Κάθε αίτημα ελέγχεται πρώτα:
- Χωρίς διακριτικό →
404, ή μια ετικέτα έκδοσης ότανShowDoconutInfo = true. - Το διακριτικό δεν έχει παραχωρηθεί σε αυτή τη συνεδρία ASP.NET → μια εικόνα σφάλματος που διαβάζει
You Are Not Authorized To View This Page. - Άγνωστο ή ληγμένο διακριτικό → μια εικόνα σφάλματος που διαβάζει
Document session not found. Please re-open document.
Οι εικόνες σφάλματος είναι απλά PNG που αποστέλλονται με κατάσταση 200, ώστε το widget να μπορεί να τις εμφανίσει εκεί που θα ήταν η σελίδα. Μια παρακολούθηση που ελέγχει μόνο τον κωδικό κατάστασης θα τις καταγράψει ως σελίδες που εξυπηρετήθηκαν· μια πραγματική σελίδα είναι δεκάδες έως εκατοντάδες kilobytes, μια εικόνα σφάλματος περίπου 2 KB.
Κλείσιμο εγγράφου
viewer.CloseDocument(token);CloseDocument αφαιρεί τη συνεδρία (απελευθερώνοντας τη μηχανή εγγράφου και τη μνήμη της αμέσως), αφαιρεί την καταχώρηση secure-{token} από τη συνεδρία ASP.NET του τρέχοντος αιτήματος, και ανακαλεί το διακριτικό. Είναι προαιρετικό — η κυλιόμενη λήξη κάνει τον ίδιο καθαρισμό — αλλά για μεγάλα έγγραφα απελευθερώνει μνήμη τη στιγμή που ο χρήστης τελειώνει. Από το πρόγραμμα περιήγησης, το objViewer.Close(true) στέλνει το ισοδύναμο αίτημα κλεισίματος στο DocImage.axd.
Συμπεράσματα
- Ένα ανοιχτό έγγραφο = μία συνεδρία = ένα διακριτικό, παραχωρημένο στη συνεδρία ASP.NET που το άνοιξε.
- Το διακριτικό λήγει σε κυλιόμενο παράθυρο· ένας προβολέας που παραμένει αδρανής πέρα από το
DocOptions.TimeOutχρειάζεται επανέναρξη. - Το
Viewerμπορεί να επιλυθεί και να μοιραστεί ελεύθερα· οι συνεδρίες μεταφέρουν όλη την κατάσταση.
Ήταν αυτή η σελίδα χρήσιμη;