Μεταφορά από την κλασική ενσωμάτωση .NET 6
Μετακίνηση μιας υπάρχουσας εφαρμογής Doconut.NET6 στην τρέχουσα DI και ασύγχρονη API
Το Doconut έχει δύο ξεχωριστές ενσωματώσεις .NET 6. Μπορούν να χρησιμοποιούν το ίδιο Doconut.NET6
όνομα πακέτου, οπότε εντοπίστε τη γενιά από τα API στην εφαρμογή πριν αλλάξετε
πακέτα, εκκίνηση, άδειες ή πόρους του προγράμματος περιήγησης.
Ποια ενσωμάτωση .NET 6 χρησιμοποιείτε;
| Εάν το έργο περιέχει… | Γενιά |
|---|---|
app.MapWhen(... "DocImage.axd" ...) | Κληρονομική / κλασική |
new Viewer(_cache, _accessor, ...) | Κληρονομική / κλασική |
Viewer.DoconutLicense(...) ή Viewer.SetLicensePlugin(...) | Κληρονομική / κλασική |
Χειροκίνητα αντιγραμμένα docViewer.js, documentLinks.js, ή docViewer.UI.js | Κληρονομική / κλασική |
builder.Services.AddDoconut(...) | Τρέχουσα ενσωμάτωση |
app.UseDoconutResources() συν app.UseDoconut() | Τρέχουσα ενσωμάτωση |
Viewer παρέχεται από dependency injection | Τρέχουσα ενσωμάτωση |
await viewer.OpenDocumentAsync(...) | Τρέχουσα ενσωμάτωση |
Εάν και οι δύο στήλες εμφανιστούν στην ίδια εφαρμογή, θεωρήστε τη μετανάστευση ως ατελή. Μην στέλνετε ένα διακριτικό εγγράφου μέσω πόρων ή middleware από την άλλη γενιά.
Γιατί το όνομα του πακέτου NuGet μπορεί να μην σας ενημερώνει
Και οι δύο γενιές έχουν διανεμηθεί υπό το Doconut.NET6 ID πακέτου. Μια αναφορά πακέτου,
αρχείο κλειδώματος ή αποθηκευμένο .nupkg επομένως δεν προσδιορίζει το φιλοξενούμενο API από μόνο του.
Καταγράψτε την ακριβή έκδοση του πακέτου και ελέγξτε το Program.cs, την κατασκευή του viewer, το άνοιγμα εγγράφου και τα σενάρια του προγράμματος περιήγησης μαζί.
Η τρέχουσα έκδοση που ελέγχθηκε για αυτόν τον οδηγό είναι Doconut.NET6 26.7.0. Τα προαιρετικά δημόσια πακέτα της είναι Doconut.NET6.Converter και Doconut.NET6.Dicom, δεσμευμένα στην ίδια έκδοση κυκλοφορίας με το βασικό πακέτο.
Πριν τη μετανάστευση
- Δημιουργήστε ένα κλαδί και ένα αναπληρωματικό αντίγραφο ασφαλείας της υπάρχουσας εφαρμογής.
- Καταγράψτε τις ακριβείς εκδόσεις του βασικού και των πρόσθετων πακέτων.
- Καταγράψτε κάθε αντιστοίχιση
DocImage.axd, κλήσηnew Viewer(...), κλήση φόρτωσης άδειας, αντιγραμμένο σενάριο Doconut, προσαρμοσμένη ενέργεια γραμμής εργαλείων και τελικό σημείο ανοίγματος εγγράφου. - Διατηρήστε τα τρέχοντα αρχεία
.licκαι τα μυστικά ανάπτυξης εκτός ελέγχου πηγαίου κώδικα. - Συλλέξτε ένα αντιπροσωπευτικό σύνολο εγγράφων PDF, Office, εικόνας, CAD, email, DICOM, αναζητήσιμα, προστατευμένα με κωδικό και σχολιασμένα.
- Καταγράψτε το υπάρχον χρονικό όριο συνεδρίας, τη συμπεριφορά ασφαλείας, τις γραμματοσειρές και τις ρυθμίσεις πλατφόρμας.
Μεταφέρετε ένα περιβάλλον πριν αλλάξετε την παραγωγή. Η τρέχουσα ενσωμάτωση αλλάζει τη διάρκεια ζωής της υπηρεσίας, τη δρομολόγηση των αιτημάτων, την ιδιοκτησία της συνεδρίας και την παράδοση πόρων του πελάτη.
Συμβατότητα πακέτου και άδειας
Αντικαταστήστε ή ενημερώστε το βασικό πακέτο σκόπιμα· μην βασίζεστε στο ίδιο ID πακέτου για την επιλογή του νέου API. Η προεπιλεγμένη εντολή εγκαθιστά την πιο πρόσφατη σταθερή έκδοση:
dotnet add package Doconut.NET6Για μια επαναλήψιμη μετανάστευση στην έκδοση που ελέγχθηκε από αυτόν τον οδηγό, περάστε την έκδοση ως ξεχωριστή επιλογή:
dotnet add package Doconut.NET6 --version 26.9.0Διατηρήστε κάθε πρόσθετο Doconut στην ίδια έκδοση με το βασικό πακέτο. Η τρέχουσα ενσωμάτωση
φορτώνει τις άδειες μία φορά κατά τη διάρκεια του AddDoconut(), χρησιμοποιώντας αυτήν την προτεραιότητα:
LicenseStream > LicenseContent > LicensePath > automatic discoveryΗ αυτόματη ανίχνευση αναζητά Doconut.Viewer.lic και τα συνοδευτικά αρχεία Doconut.Viewer.<Capability>.lic. Μια κλασική κλήση στο
Viewer.DoconutLicense(...) ή Viewer.SetLicensePlugin(...) δεν αποτελεί τρέχον μηχανισμό εκκίνησης. Μετακινήστε την άδεια στο DoconutOptions, κρατήστε τα συνοδευτικά αρχεία μαζί όταν χρησιμοποιείτε
την αυτόματη ανίχνευση, επανεκκινήστε μετά την αλλαγή μιας άδειας και επαληθεύστε τις δυνατότητες μέσω του IDoconutLicenseService.
Μην υποθέτετε ότι η παρουσία μιας παλιάς άδειας πρόσθετου αποδεικνύει δικαίωμα για μια τρέχουσα έκδοση πρόσθετου. Δοκιμάστε το Viewer, Search, Annotation, Converter και DICOM ξεχωριστά με τα εγκεκριμένα αντικείμενα της έκδοσης.
Εκκίνηση και ένεση εξαρτήσεων
Οι κλασικές εφαρμογές δημιουργούν το Viewer με κρυφή μνήμη ASP.NET και εξαρτήσεις request-accessor:
// Κλασική ενσωμάτωση — μόνο για σύγκριση; μην το μεταγλωττίσετε με το τρέχον SDK.
var viewer = new Viewer(_cache, _accessor, licenseFilePath);Η τρέχουσα ενσωμάτωση καταχωρεί το Doconut μία φορά και λαμβάνει το Viewer μέσω ένεσης εξαρτήσεων:
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
options.UnsafeMode = false;
});
builder.Services.AddDistributedMemoryCache();
builder.Services.AddSession();
app.UseSession();
app.UseDoconutResources();
app.UseDoconut();Το Viewer είναι μια παροδική υπηρεσία. Ο διαχειριστής συνεδρίας εγγράφου και η κρυφή μνήμη του διαχειρίζονται την πιο μακροχρόνια κατάσταση του εγγράφου, όχι τη συγκεκριμένη εγχυμένη Viewer παρουσία.
Μεσολαβητής και δρομολόγηση πόρων
Αφαιρέστε τον κλασικό κλάδο MapWhen που ανιχνεύει το DocImage.axd:
// Κλασική ενσωμάτωση — αφαιρέστε κατά τη διάρκεια της μετάβασης.
app.MapWhen(
context => context.Request.Path.ToString().EndsWith("DocImage.axd"),
branch => branch.UseDoconut(new DoconutOptions()));Στην τρέχουσα αλυσίδα επεξεργασίας:
- καλέστε το
UseSession()πριν από το Doconut ενώ η ασφάλεια συνεδρίας είναι ενεργοποιημένη· - καλέστε το
UseDoconutResources()πριν από τοUseDoconut()· - διατηρήστε το
ResourcesPath, τις παραγόμενες διευθύνσεις URL πόρων, και το clientResPathευθυγραμμισμένα· - όταν αντιστοιχίζεται το
UseDoconut()σε έναν κλάδο, διατηρήστε εκείνο τον κλάδο και το clientBasePathευθυγραμμισμένα.
Το MiddlewarePath είναι επικυρωμένη διαμόρφωση· δεν δημιουργεί κλάδο ASP.NET Core από μόνο του. Χρησιμοποιήστε είτε την απλή αλυσίδα επεξεργασίας στο παραπάνω παράδειγμα μεταγλώττισης είτε μια ρητή διάταξη app.Map("/doconut", branch => branch.UseDoconut()) που χρησιμοποιείται σταθερά από τον πελάτη.
Κατασκευή Viewer και διάρκεια ζωής
Αφαιρέστε τις κρυφές μνήμες που ανήκουν στην εφαρμογή για αντικείμενα Viewer. Ενσωματώστε το Viewer σε ένα endpoint, Razor page, controller ή scoped υπηρεσία εφαρμογής:
app.MapPost("/api/open", async (Viewer viewer) =>
{
var token = await viewer.OpenDocumentAsync("wwwroot/files/Sample.pdf");
return Results.Ok(new { token });
});Το επιστρεφόμενο token αναγνωρίζει μια συνεδρία εγγράφου στο διακομιστή. Θεωρήστε το ως διαπιστευτήριο τύπου bearer: μην το καταγράφετε, αποθηκεύετε ή το τοποθετείτε σε analytics.
Άνοιγμα και κλείσιμο εγγράφων
Αντικαταστήστε το συγχρονικό OpenDocument(...) με το OpenDocumentAsync(...):
// Τρέχουσα ενσωμάτωση .NET 6: ο Viewer προέρχεται από DI και το άνοιγμα του εγγράφου είναι ασύγχρονο.
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { AllowSearch = true });Οι τρέχουσες υπερφορτώσεις δέχονται διαδρομή αρχείου ή ροή, προαιρετική διαμόρφωση μορφής, προαιρετικό DocOptions και ένα token ακύρωσης. Κλείστε ρητά τη συνεδρία του διακομιστή όταν ο φυλλομετρητής δεν τη χρειάζεται πλέον:
viewer.CloseDocument(token);Μην επαναχρησιμοποιήσετε ένα κλασικό token μετά τη μετάβαση. Ανοίξτε ξανά κάθε έγγραφο μέσω του τρέχοντος API.
Κλάσεις διαμόρφωσης
Το τρέχον API διαχωρίζει τις πτυχές:
| Concern | Current type |
|---|---|
| Διαδρομές μεσολαβητή, αδειοδότηση, καταχώρηση plugin | DoconutOptions |
| Κωδικός πρόσβασης, χρονικό όριο, ασφάλεια, υδατογράφημα | DocOptions |
| Απόδοση μορφής και DPI | PdfConfig, WordConfig, ExcelConfig, and other BaseConfig types |
| Προεπιλογές widget προγράμματος περιήγησης | ViewerConfig or the equivalent JavaScript options |
| Δημιουργημένο CSS και scripts | CssConfig and ScriptConfig |
Μην προωθήσετε το DocOptions.ImageResolution ως στοιχείο ελέγχου απόδοσης. Είναι παρωχημένο· ορίστε το BaseConfig.ImageResolution στη διαμόρφωση ειδική για μορφή. Εξετάστε όλες τις προεπιλογές αντί να υποθέτετε ότι μια κλασική διαμόρφωση έχει την ίδια συμπεριφορά.
Γραμμή εργαλείων Viewer, Αναζήτηση και Σχόλιο
Μην μεταφέρετε τα παλιά scripts ένα-ένα. Οι τρέχουσες εφαρμογές αναφοράς συνθέτουν ένα πλήρες πακέτο σελίδας:
- εκδώστε το Viewer CSS και το αδειοδοτημένο Search/Annotation CSS με το
ReferenceCss· - αποδώστε τη γραμμή εργαλείων Viewer που ανήκει στην εφαρμογή·
- αποδώστε το
searchBarMount, τοannBarMountκαι το απαιτούμενο Viewer mount· - εκδώστε τα scripts του Viewer και του αδειοδοτημένου module με το
ReferenceScripts· - φορτώστε το δικό της
viewerToolbar.jsτης εφαρμογής· - αρχικοποιήστε ένα
objViewer· - αρχικοποιήστε τα αδειοδοτημένα Search και Annotation Ribbons·
- καλέστε το
attach(objViewer)σε κάθε Ribbon· - ανοίξτε το έγγραφο και καλέστε το
objViewer.View(token).
Το Search και το Annotation είναι modules που συνδέονται στον ίδιο Viewer, όχι ανεξάρτητες γραμμές εργαλείων. Η κύρια γραμμή εργαλείων ανήκει στην εφαρμογή-ξενιστή· τα Search και Annotation Ribbons είναι ενσωματωμένοι, πόροι με περιορισμένη δυνατότητα.
Αφαιρέστε τα χειροκίνητα αντιγραμμένα κλασικά αρχεία όπως τα documentLinks.js και docViewer.UI.js μόνο αφού η τρέχουσα σελίδα λειτουργεί με τους πόρους που εκδίδονται από τα ReferenceCss και ReferenceScripts.
Καταχώρηση πρόσθετου
Οι κλασικές στατικές μέθοδοι άδειας πρόσθετου δεν καταχωρούν τα τρέχοντα πρόσθετα. Εγκαταστήστε και καταχωρήστε κάθε εκδιδόμενο πακέτο ρητά:
builder.Services.AddDoconut(options =>
{
options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
options.AddPlugin<Doconut.Plugins.Dicom.DicomPlugin>();
});AddDoconut() επαληθεύει τις καταχωρημένες δυνατότητες του πρόσθετου κατά την εκκίνηση. Τα Converter και DICOM είναι εκδιδόμενα .NET 6 πρόσθετα. Η Κανονική Αναζήτηση και το Annotation είναι ενσωματωμένα χαρακτηριστικά με άδεια, όχι πακέτα AddPlugin<TPlugin>().
Ασφάλεια συνεδρίας και εγγράφου
Η τρέχουσα ενσωμάτωση συνδέει έγγραφα με αδιαφανή διακριτικά και προσωρινές συνεδρίες. Με το προεπιλεγμένο UnsafeMode = false, το UseDoconut() προσθέτει ασφάλεια πρόσβασης εγγράφου και ο κεντρικός υπολογιστής πρέπει να ρυθμίσει τη συνεδρία ASP.NET:
builder.Services.AddDistributedMemoryCache(); // η κατάσταση συνεδρίας χρειάζεται μια κρυφή μνήμη (MVC/Razor Pages ήδη προσθέτει μία)
builder.Services.AddSession();
app.UseSession();Διατηρήστε το DocOptions.IsSecured = true εκτός εάν ένας ελεγμένος σχεδιασμός απαιτεί το αντίθετο. Ποτέ μην χρησιμοποιείτε το UnsafeMode = true ως συντόμευση μετανάστευσης. Δοκιμάστε αιτήματα χωρίς διακριτικό, με κατεστραμμένο διακριτικό, με ληγμένο διακριτικό και με διακριτικό από διαφορετική συνεδρία προγράμματος περιήγησης.
Η διανεμημένη εφαρμογή αναφοράς προσθέτει εισιτήρια πρόσβασης και λεπτομέρειες μεταφοράς. Αυτά τα API δεν απαιτούνται για μια κανονική μετανάστευση μονής κόμβου.
Δοκιμή της μετανάστευσης
Ως ελάχιστο, επαληθεύστε:
- την εκκίνηση της εφαρμογής με την άδεια παραγωγής και κάθε καταχωρημένο πρόσθετο·
- τα CSS/σενάρια Viewer και όλα τα αιτήματα σελίδας‑εικόνας κάτω από τις επιλεγμένες διαδρομές·
- το άνοιγμα εγγράφου, την πλοήγηση, το ζουμ, τις μικρογραφίες, την εκτύπωση και το ρητό κλείσιμο·
- την Αναζήτηση σε έγγραφο με κείμενο και την κατάσταση μη αναζητήσιμου αρχείου μόνο με εικόνα·
- τη φόρτωση, αποθήκευση, εξαγωγή και περιορισμό δυνατοτήτων του Annotation·
- την ανακάλυψη στόχου του Converter, την έξοδο, τη λήψη και την κατάσταση υδατογραφήματος·
- τις σελίδες, τα πλαίσια και την κίνηση του DICOM· τα τεχνικά μεταδεδομένα .NET 6 δεν είναι διαθέσιμα·
- έγγραφα με προστασία κωδικού, προσαρμοσμένες γραμματοσειρές, μη λατινικό κείμενο και ρυθμισμένα χρονικά όρια·
- την απόρριψη διακριτικού μεταξύ συνεδριών και τη συμπεριφορά ληγμένης συνεδρίας·
- το κινητό, τη σκοτεινή λειτουργία και τη διαδρομή αντιστροφικού διαμεσολαβητή παραγωγής.
Σχέδιο επαναφοράς
Διατηρήστε το κλασικό αντικείμενο ανάπτυξης, τα αντίστοιχα πακέτα, τα αρχεία άδειας και τους αντιγραμμένους πόρους προγράμματος περιήγησης μαζί. Μια ασφαλής επαναφορά αλλάζει ολόκληρη τη γενιά της εφαρμογής· δεν αναμιγνύει έναν κλασικό διακομιστή με τρέχοντα σενάρια ή έναν τρέχοντα διακομιστή με κλασικές κλήσεις DocImage.axd.
Πριν από τη μετάβαση, καταγράψτε:
- τη θέση ή το αντικείμενο ανάπτυξης που χρησιμοποιείται για επαναφορά·
- την επίπτωση στη βάση δεδομένων/κρυφή μνήμη, εάν υπάρχει·
- πώς θα ακυρωθούν οι ενεργές συνεδρίες εγγράφων·
- τον έλεγχο υγείας και το δοκιμαστικό έγγραφο που χρησιμοποιείται για την απόφαση επαναφοράς·
- ποιος μπορεί να επαναφέρει το προηγούμενο σύνολο πακέτων και τη διαμόρφωση.
Τεκμηρίωση κληρονομίας
Το μεταφρασμένο κλασικό εγχειρίδιο παραμένει διαθέσιμο στο Παραδοσιακή ρύθμιση .NET 6. Η νέα Πύλη κλασικής ενσωμάτωσης εξηγεί τα ίδια σήματα αναγνώρισης και συνδέει πίσω σε αυτόν τον οδηγό μετανάστευσης.
Διατηρήστε τη ιστορική διεύθυνση URL στους σελιδοδείκτες και στα εισιτήρια υποστήριξης ενώ οι κλασικές εγκαταστάσεις εξακολουθούν να υπάρχουν. Καταγράφει μια διαφορετική γενιά και δεν ανακατευθύνει στο τρέχον API.
Ήταν αυτή η σελίδα χρήσιμη;