DoconutHost
Η ρίζα σύνθεσης για το System.Web
DoconutHost (namespace Doconut) είναι μια στατική κλάση που κατέχει τις υπηρεσίες του Doconut για ολόκληρη τη διεργασία εργαζόμενου. Οι εφαρμογές ASP.NET Core δημιουργούν αυτές τις υπηρεσίες μέσα στο δικό τους container του πλαισίου· το κλασικό ASP.NET δεν έχει container, έτσι DoconutHost δημιουργεί ένα και το διατηρεί. Ο handler DocImage.axd και το resource module επιλύουν όλα όσα χρειάζονται από αυτό, και το ίδιο κάνει και ο κώδικάς σας.
| Μέλος | Σκοπός |
|---|---|
static void Initialize(Action<DoconutOptions>? configure = null, Action<IServiceCollection>? configureServices = null) | Δημιουργεί τις υπηρεσίες — μία φορά |
static IServiceProvider Services { get; } | Το κατασκευασμένο container |
static bool IsInitialized { get; } | true μία φορά που Initialize έχει εκτελεστεί |
static void Shutdown() | Σταματά την παρασκηνιακή εργασία και διαγράφει το container |
Αρχικοποίηση
Καλέστε το από Application_Start στο Global.asax.cs:
// Global.asax.cs, Application_Start - μία φορά ανά διεργασία εργαζόμενου. Μια δεύτερη κλήση δεν κάνει τίποτα:
// οι επιλογές της πρώτης κλήσης κερδίζουν.
Doconut.DoconutHost.Initialize(
options =>
{
options.LicensePath = HostingEnvironment.MapPath("~/wwwroot/Doconut.Viewer.lic");
},
services =>
{
// Προαιρετικό. Εκτελείται μετά τις εγγραφές του Doconut και πριν δημιουργηθεί το container,
// ώστε να μπορεί να προσθέσει υπηρεσίες ή να αντικαταστήσει μία εγγραφή του Doconut.
services.AddMemoryCache();
});configureλαμβάνει το DoconutOptions: άδεια, διακόπτες ασφαλείας, plugins, widgets.configureServicesείναι προαιρετικό. Εκτελείται μετά την καταχώρηση των δικών του services από το Doconut και πριν δημιουργηθεί το container, ώστε να μπορεί να προσθέσει services —AddDoconutDistributedγια ένα web farm είναι το συνηθισμένο — ή να αντικαταστήσει μια καταχώρηση που έκανε το Doconut.
Η πρώτη κλήση κερδίζει. Initialize είναι idempotent: μια δεύτερη κλήση επιστρέφει αμέσως, και κανένας από τους delegates του δεν εκτελείται. Αυτό διατηρεί ένα διπλό Application_Start ακίνδυνο, αλλά σημαίνει επίσης ότι η διαμόρφωση δεν μπορεί να αλλάξει καλώντας ξανά το Initialize — επανακυκλώστε το application pool αντί αυτού.
Μια εξαίρεση που ρίχνεται εδώ — ένα plugin χωρίς άδεια, μη έγκυρες επιλογές, ελλιπής διαμόρφωση farm — συμβαίνει μέσα στο Application_Start. Το ASP.NET τότε απαντά κάθε αίτηση με ένα κενό 500, και η εξαίρεση καταγράφεται μόνο στο Windows event log (Application log, source ASP.NET).
Υπηρεσίες και IsInitialized
Το System.Web δεν διαθέτει constructor injection για controllers, pages ή handlers, οπότε επιλύστε τις υπηρεσίες του Doconut όπου τις χρησιμοποιείτε:
// Το System.Web δεν υποστηρίζει injection κατασκευής: επιλύστε τις υπηρεσίες του Doconut όπου τις χρησιμοποιείτε.
var viewer = Doconut.DoconutHost.Services.GetRequiredService<Viewer>();
// Καταχωρείται μόνο όταν το plugin Converter είναι (δείτε τη σελίδα του plugin).
var converter = Doconut.DoconutHost.Services.GetRequiredService<DocumentConverter>();Services ρίχνει InvalidOperationException (DoconutHost.Initialize must be called in Application_Start (Global.asax) before any Doconut request is served.) όταν διαβαστεί πριν από Initialize. Κώδικας που μπορεί να εκτελεστεί νωρίτερα — ένα module, ένας static constructor — μπορεί πρώτα να ελέγξει το IsInitialized.
Τι συνήθως επιλύει ο κώδικάς σας:
| Υπηρεσία | Διάρκεια ζωής | Ρόλος |
|---|---|---|
Viewer | Transient | Άνοιγμα, κλείσιμο, σημειώσεις, βοηθητικά πόρων — δείτε το Viewer |
DocumentConverter | Transient | Μετατροπή — πάντα καταχωρημένη· η επίλυσή του χωρίς το plugin Converter ρίχνει ένα InvalidOperationException που ονομάζει το plugin που πρέπει να προστεθεί |
DocumentSigner | Transient | Υπογραφή — απαιτεί το plugin Signer (δείτε το Signer Plugin) |
IDoconutLicenseService | Singleton | Η φορτωμένη άδεια και οι δυνατότητές της — δείτε το Licensing |
DoconutOptions | Singleton | Οι επιλογές που περνιούνται στο Initialize |
HealthCheckService | Singleton | Εκτελεί τον έλεγχο υγείας "doconut" (παρακάτω) |
Επιλύστε από το DoconutHost.Services, ποτέ από το δικό σας container. Η καταχώρηση του Doconut σε άλλο container δημιουργεί ένα δεύτερο, ξεχωριστό σύνολο υπηρεσιών που ο handler και το module δεν βλέπουν ποτέ: τα έγγραφα που ανοίγονται μέσω αυτού είναι άγνωστα στο DocImage.axd.
Τερματισμός
// Global.asax.cs, Application_End - σταματά την παρασκήνια εργασία και απελευθερώνει το container.
// Ασφαλές να κληθεί δύο φορές, και ασφαλές όταν το Initialize δεν εκτελέστηκε ποτέ.
Doconut.DoconutHost.Shutdown();Shutdown σταματά την παρασκηνιακή εργασία του Doconut (χρησιμοποιείται στη διανεμημένη λειτουργία) και διαγράφει το container. Είναι ασφαλές να κληθεί δύο φορές, και ασφαλές όταν το Initialize δεν έχει εκτελεστεί ποτέ — για παράδειγμα όταν το application pool επανακυκλώνεται πριν από το πρώτο αίτημα.
Έλεγχος υγείας
Το Doconut καταχωρεί έναν έλεγχο υγείας με όνομα "doconut" που αναφέρει την κατάσταση της άδειας. Το κλασικό ASP.NET δεν έχει δικό του health-check endpoint, έτσι εκθέστε το από έναν controller:
// GET /Health - Doconut καταχωρεί έναν έλεγχο υγείας "doconut" που αναφέρει την κατάσταση της άδειας:
// Healthy (valid), Degraded (trial or no license file), Unhealthy (rejected or expired).
public async Task<ActionResult> Index()
{
var health = Doconut.DoconutHost.Services.GetRequiredService<HealthCheckService>();
HealthReport report = await health.CheckHealthAsync();
Response.StatusCode = report.Status == HealthStatus.Unhealthy ? 503 : 200;
return Content(report.Status.ToString(), "text/plain");
}| Κατάσταση | Σημασία |
|---|---|
Healthy | Μία έγκυρη άδεια έχει φορτωθεί |
Degraded | Δοκιμαστική, ή δεν βρέθηκε αρχείο άδειας |
Unhealthy | Η άδεια απορρίφθηκε (π.χ., ένα επεξεργασμένο αρχείο) ή έχει λήξει |
Οι μέθοδοι επέκτασης του ASP.NET Core
Το πακέτο περιέχει επίσης τα UseDoconut() και UseDoconutResources(), τις επεκτάσεις του pipeline του ASP.NET Core, επειδή μοιράζεται τον κώδικά του με τα πακέτα ASP.NET Core. Σε αυτό το πακέτο και τα δύο είναι σημειωμένα ως [Obsolete] και δεν χρησιμοποιούνται: μια εφαρμογή System.Web δεν έχει request pipeline για να τα προσθέσει. Οι αντικαταστάσεις τους είναι οι δύο καταχωρήσεις Web.config από το Installation:
| ASP.NET Core | .NET Framework 4.7.2 |
|---|---|
builder.Services.AddDoconut(...) | DoconutHost.Initialize(...) στο Application_Start |
app.UseDoconut() | Doconut.DocImageHandler στο DocImage.axd στο Web.config |
app.UseDoconutResources() | Doconut.DoconutResourceModule στο Web.config |
| Constructor injection | DoconutHost.Services.GetRequiredService<T>() |
| Host shutdown | DoconutHost.Shutdown() στο Application_End |
Ήταν αυτή η σελίδα χρήσιμη;