DoconutHost
Główny punkt kompozycji dla System.Web
DoconutHost (namespace Doconut) jest statyczną klasą, która zarządza usługami Doconut dla całego procesu roboczego. Aplikacje ASP.NET Core budują te usługi w własnym kontenerze frameworka; klasyczny ASP.NET nie ma kontenera, więc DoconutHost tworzy go i utrzymuje. Obsługa DocImage.axd oraz moduł zasobów rozwiązują wszystko, czego potrzebują, z tego kontenera, podobnie jak Twój kod.
| Członek | Cel |
|---|---|
static void Initialize(Action<DoconutOptions>? configure = null, Action<IServiceCollection>? configureServices = null) | Tworzy usługi — raz |
static IServiceProvider Services { get; } | Zbudowany kontener |
static bool IsInitialized { get; } | true po jednorazowym uruchomieniu Initialize |
static void Shutdown() | Zatrzymuje pracę w tle i zwalnia kontener |
Inicjalizacja
Wywołaj ją z Application_Start w Global.asax.cs:
// Global.asax.cs, Application_Start - raz na proces roboczy. Drugie wywołanie jest operacją bez efektu:
// opcje pierwszego wywołania wygrywają.
Doconut.DoconutHost.Initialize(
options =>
{
options.LicensePath = HostingEnvironment.MapPath("~/wwwroot/Doconut.Viewer.lic");
},
services =>
{
// Opcjonalne. Uruchamiane po własnych rejestracjach Doconut i przed zbudowaniem kontenera,
// aby mógł dodać usługi lub zastąpić jedną zarejestrowaną przez Doconut.
services.AddMemoryCache();
});configureotrzymuje OpcjeDoconut: licencję, przełączniki bezpieczeństwa, wtyczki, widgety.configureServicesjest opcjonalny. Uruchamia się po zarejestrowaniu usług przez Doconut i przed zbudowaniem kontenera, więc może dodać usługi —AddDoconutDistributeddla farmy webowej jest typowy — lub zastąpić rejestrację wykonaną przez Doconut.
Pierwsze wywołanie wygrywa. Initialize jest idempotentny: drugie wywołanie zwraca natychmiast, a żaden z jego delegatów nie zostaje uruchomiony. To sprawia, że zduplikowany Application_Start jest nieszkodliwy, ale oznacza również, że konfiguracji nie można zmienić ponownym wywołaniem Initialize — zamiast tego zresetuj pulę aplikacji.
Wyjątek rzucony w tym miejscu — wtyczka bez licencji, nieprawidłowe opcje, niekompletna konfiguracja farmy — występuje wewnątrz Application_Start. ASP.NET następnie odpowiada na każde żądanie pustym 500, a wyjątek jest zapisywany wyłącznie w dzienniku zdarzeń Windows (dziennik Aplikacji, źródło ASP.NET).
Usługi i IsInitialized
System.Web nie posiada wstrzykiwania przez konstruktor dla kontrolerów, stron ani obsługujących, więc rozwiązuj usługi Doconut tam, gdzie ich używasz:
// System.Web nie obsługuje wstrzykiwania przez konstruktor: rozwiąż usługi Doconut tam, gdzie ich używasz.
var viewer = Doconut.DoconutHost.Services.GetRequiredService<Viewer>();
// Rejestrowane tylko wtedy, gdy wtyczka Converter jest (zobacz stronę wtyczki).
var converter = Doconut.DoconutHost.Services.GetRequiredService<DocumentConverter>();Services rzuca InvalidOperationException (DoconutHost.Initialize must be called in Application_Start (Global.asax) before any Doconut request is served.) gdy odczytany przed Initialize. Kod, który może uruchomić się wcześniej — moduł, statyczny konstruktor — może najpierw sprawdzić IsInitialized.
Co Twój kod zazwyczaj rozwiązuje:
| Usługa | Czas życia | Rola |
|---|---|---|
Viewer | Transient | Otwieranie, zamykanie, adnotacje, pomocniki zasobów — zobacz Podgląd |
DocumentConverter | Transient | Konwersja — zawsze zarejestrowana; rozwiązanie jej bez wtyczki Converter rzuca InvalidOperationException, który podaje nazwę wtyczki do dodania |
DocumentSigner | Transient | Podpisywanie — wymaga wtyczki Wtyczka Podpisująca |
IDoconutLicenseService | Singleton | Załadowana licencja i jej możliwości — zobacz Licencjonowanie |
DoconutOptions | Singleton | Opcje przekazane do Initialize |
HealthCheckService | Singleton | Uruchamia kontrolę zdrowia "doconut" (poniżej) |
Rozwiązuj z DoconutHost.Services, nigdy nie z własnego kontenera. Rejestrowanie Doconut w innym kontenerze tworzy drugi, odrębny zestaw usług, którego obsługa i moduł nigdy nie widzą: dokumenty otwarte przez niego są nieznane DocImage.axd.
Zamykanie
// Global.asax.cs, Application_End - zatrzymuje pracę w tle i zwalnia kontener.
// Bezpieczne wywołanie dwukrotnie oraz gdy Initialize nigdy nie zostało uruchomione.
Doconut.DoconutHost.Shutdown();Shutdown zatrzymuje pracę w tle Doconut (używaną w trybie rozproszonym) i zwalnia kontener. Jest bezpieczne wywołanie dwukrotnie oraz gdy Initialize nigdy nie został uruchomiony — na przykład gdy pula aplikacji jest resetowana przed pierwszym żądaniem.
Sprawdzenie stanu zdrowia
Doconut rejestruje kontrolę zdrowia o nazwie "doconut", która raportuje stan licencji. Klasyczny ASP.NET nie ma własnego punktu końcowego kontroli zdrowia, więc udostępnij ją z kontrolera:
// GET /Health - Doconut rejestruje kontrolę zdrowia "doconut", która raportuje stan licencji:
// Zdrowy (ważny), Zdegradowany (wersja próbna lub brak pliku licencji), Niezdrowy (odrzucony lub wygasły).
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");
}| Status | Znaczenie |
|---|---|
Healthy | Załadowano ważną licencję |
Degraded | Tryb próbny lub nie znaleziono pliku licencji |
Unhealthy | Licencja została odrzucona (np. zmodyfikowany plik) lub wygasła |
Metody rozszerzeń ASP.NET Core
Pakiet zawiera również UseDoconut() i UseDoconutResources(), rozszerzenia potoku ASP.NET Core, ponieważ współdzieli kod z pakietami ASP.NET Core. W tym pakiecie oba są oznaczone jako [Obsolete] i nie są używane: aplikacja System.Web nie posiada potoku żądań, do którego można je dodać. Ich zamienniki to dwa rejestracje Web.config z Instalacja:
| ASP.NET Core | .NET Framework 4.7.2 |
|---|---|
builder.Services.AddDoconut(...) | DoconutHost.Initialize(...) in Application_Start |
app.UseDoconut() | Doconut.DocImageHandler on DocImage.axd in Web.config |
app.UseDoconutResources() | Doconut.DoconutResourceModule in Web.config |
| Wstrzykiwanie przez konstruktor | DoconutHost.Services.GetRequiredService<T>() |
| Zamykanie hosta | DoconutHost.Shutdown() in Application_End |
Czy ta strona była pomocna?