Πώς Λειτουργεί ο Προβολέας
Ο κύκλος ζωής του αιτήματος εγγράφου
Το Doconut αποδίδει έγγραφα ως σελιδοποιημένες εικόνες που εξυπηρετούνται μέσω του middleware ASP.NET Core. Η κατανόηση του κύκλου ζωής — άνοιγμα, διακριτικό, αιτήματα σελίδων, κλείσιμο — εξηγεί σχεδόν κάθε συμπεριφορά που θα παρατηρήσετε, συμπεριλαμβανομένων των μηνυμάτων σφάλματος.
Τα τρία κινούμενα μέρη
Viewer— η δημόσια υπηρεσία που ενσωματώνετε. Ανοίγει έγγραφα και επιστρέφει διακριτικά συνεδρίας.- Η συνεδρία εγγράφου — ένα αντικείμενο στο διακομιστή που κρατά το φορτωμένο έγγραφο, προσδιορισμένο με ένα διακριτικό στο
IMemoryCache. - Το middleware Doconut — προστίθεται από
UseDoconut()· απαντά σε κάθε αίτημα που κάνει το widget του προγράμματος περιήγησης (pages,thumbnails,search,annotations, …), πάντα πιστοποιημένο με το διακριτικό.
Viewer είναι χωρίς κατάσταση — σχεδιαστικά
Viewer είναι κλεισμένο, δεν κρατά κατάσταση εγγράφου ανά αίτηση, και σκόπιμα δεν υλοποιεί IDisposable. Οι συνεδρίες ζουν ανεξάρτητα στον διαχειριστή συνεδριών και καθαρίζονται από τη λήξη της προσωρινής μνήμης ή από ένα ρητό CloseDocument(token).
Ενσωματώστε το όπου χρειάζεται:
app.MapPost("/api/open", async (string fileName, Viewer viewer) =>
{
var token = await viewer.OpenDocumentAsync($"files/{fileName}");
return Results.Content(token, "text/plain");
});Τι συμβαίνει μέσα στο OpenDocumentAsync
- Πύλη άδειας. Μια απορριφθείσα ή λήξη έκδοσης άδειας (μαύρη λίστα, παραποιημένη, ή μια έκδοση εκτός του παραθύρου ενημέρωσης της άδειας) ρίχνει αμέσως ένα
LicenseException, με τον λόγο απόρριψης ως μήνυμα — το άνοιγμα δεν υποβαθμίζεται σιωπηρά για μια μη έγκυρη (αντί για απουσία) άδεια. Μια λήξη ημερολογίου για προσωρινή ή συνδρομητική άδεια αποτελεί εξαίρεση: δεν ρίχνει — υποβαθμίζεται σε υδατογράφημα. - Δημιουργία συνεδρίας. Η εργοστασιακή μονάδα προβολέα επιλέγει τον κατάλληλο προβολέα μορφής για την επέκταση αρχείου και φορτώνει το έγγραφο (δείτε το Rendering Pipeline). Η συνεδρία αποθηκεύεται στο
IMemoryCacheκάτω από ένα νέο διακριτικό GUID με κυλιόμενη λήξη —DocOptions.TimeOutλεπτά, προεπιλογή 60. Κάθε αίτημα σελίδας επαναφέρει το χρονόμετρο. - Καταγραφή ασφαλείας. Με
UnsafeMode = false(η προεπιλογή), το διακριτικό δεσμεύεται στη συνεδρία ASP.NET του καλούντος: έναsecure-{token}marker γράφεται στη συνεδρία, ώστε μόνο η συνεδρία του προγράμματος περιήγησης που άνοιξε το έγγραφο να μπορεί να ζητήσει τις σελίδες του. - Το διακριτικό επιστρέφεται. Είναι το μοναδικό διαπιστευτήριο για όλα όσα ακολουθούν.
Οι τρεις υπερφορτώσεις διαφέρουν μόνο στην είσοδο: μια διαδρομή αρχείου, μια διαδρομή αρχείου συν μια διαμόρφωση ανά μορφή (PdfConfig, WordConfig, …), ή ένα Stream συν ένα FileInfo του οποίου η επέκταση καθορίζει την ανίχνευση μορφής.
Πώς το widget λαμβάνει σελίδες
Το widget του πελάτη καλεί το middleware Doconut με το διακριτικό στη συμβολοσειρά ερωτήματος. Η λειτουργία του middleware εξαρτάται από το αίτημα:
| Ερώτημα | Σκοπός |
|---|---|
?token=…&page=N | Εικόνα σελίδας (PNG) |
?token=…&page=N&thumb=1 | Μικρογραφία |
?token=…&zoom=… | Απόδοση μεζερισμένης σελίδας |
?token=…&search=term | Αναζήτηση πλήρους κειμένου (με άδεια) |
?token=…&bookmarks | Δομή εγγράφου/σελιδοδείκτες |
?token=…© / &showlinks / &fileFormat / &meta | Αντιγραφή κειμένου, υπερσυνδέσεις, πληροφορίες μορφής, τεχνικά μεταδεδομένα DICOM |
?token=…&action=rotate/flip/close | Ενέργειες σελίδας και ρητό κλείσιμο |
?token=…&AnnSave=… / &AnnLoad | Αποθήκευση/φόρτωση σχολίων |
Κάθε μία από αυτές τις διαδρομές επικυρώνεται πρώτα:
- Χωρίς διακριτικό → το middleware επιστρέφει 404 (ή μια μπάνερ έκδοσης όταν
ShowDoconutInfo = true). - Άγνωστο ή ληγμένο διακριτικό → μια εικόνα σφάλματος με
Document session not found. Please re-open document. - Απουσία middleware συνεδρίας (με
UnsafeMode = false) → HTTP 500 μεSession middleware not configured. Call UseSession() before UseDoconut(). - Διακριτικό ανοιγμένο από διαφορετική συνεδρία προγράμματος περιήγησης → μια εικόνα σφάλματος με
You Are Not Authorized To View This Page.
Η εξυπηρέτηση σελίδων από κοινόχρηστη αποθήκευση αντί για τον κόμβο ανοίγματος είναι μια εντελώς διαφορετική διάταξη· δείτε Διανεμημένες Αναπτύξεις.
Κλείσιμο εγγράφου
viewer.CloseDocument(token);CloseDocument αφαιρεί τη συνεδρία από την κρυφή μνήμη (που απελευθερώνει τη βασική μηχανή εγγράφου και ελευθερώνει τη μνήμη της αμέσως), διαγράφει το secure-{token} marker, και ανακαλεί την άδεια πρόσβασης. Η κλήση του είναι προαιρετική — η κυλιόμενη λήξη κάνει την ίδια εκκαθάριση αυτόματα — αλλά για μεγάλα έγγραφα είναι ο ευγενικός τρόπος να απελευθερωθεί η μνήμη μόλις ο χρήστης ολοκληρώσει.
Συμπεράσματα
- Ένα ανοιχτό έγγραφο = μία συνεδρία = ένα διακριτικό. Τα διακριτικά είναι ανά συνεδρία προγράμματος περιήγησης, όχι παγκόσμια URLs.
- Το διακριτικό λήγει σε κυλιόμενο παράθυρο· ένας προβολέας που παραμένει αδρανής πέρα από
DocOptions.TimeOutχρειάζεται νέο άνοιγμα. Viewerμπορεί να ενσωματωθεί και να μοιραστεί ελεύθερα· οι συνεδρίες μεταφέρουν όλη την κατάσταση.
Ήταν αυτή η σελίδα χρήσιμη;