DoconutHost

System.Web용 구성 루트

DoconutHost (namespace Doconut) 은 전체 워커 프로세스에 대한 Doconut의 서비스를 소유하는 정적 클래스입니다. ASP.NET Core 애플리케이션은 이러한 서비스를 프레임워크 자체 컨테이너에 구축합니다; 클래식 ASP.NET에는 컨테이너가 없으므로 DoconutHost 가 하나를 만들고 유지합니다. DocImage.axd 핸들러와 리소스 모듈은 필요한 모든 것을 그것으로부터 해결하며, 여러분의 코드도 마찬가지입니다.

멤버목적
static void Initialize(Action<DoconutOptions>? configure = null, Action<IServiceCollection>? configureServices = null)서비스를 한 번 구축
static IServiceProvider Services { get; }구축된 컨테이너
static bool IsInitialized { get; }true 한 번 Initialize 실행된 후
static void Shutdown()백그라운드 작업을 중지하고 컨테이너를 해제합니다

초기화

Global.asax.cs 안의 Application_Start 에서 호출합니다:

csharp
// Global.asax.cs, Application_Start - 워커 프로세스당 한 번만 실행됩니다. 두 번째 호출은 아무 작업도 하지 않습니다:
// 첫 번째 호출의 옵션이 우선합니다.
Doconut.DoconutHost.Initialize(
    options =>
    {
        options.LicensePath = HostingEnvironment.MapPath("~/wwwroot/Doconut.Viewer.lic");
    },
    services =>
    {
        // 옵션입니다. Doconut의 자체 등록이 끝난 후, 컨테이너가 빌드되기 전에 실행됩니다,
        // 따라서 서비스를 추가하거나 Doconut이 등록한 서비스를 교체할 수 있습니다.
        services.AddMemoryCache();
    });
  • configure 은 Doconut 옵션을 받습니다: 라이선스, 보안 스위치, 플러그인, 위젯.
  • configureServices 은 선택 사항입니다. Doconut이 자체 서비스를 등록하고 컨테이너가 구축되기 전에 실행되므로, 서비스를 추가할 수 있습니다 — 웹 팜용 AddDoconutDistributed 가 일반적이며 — 또는 Doconut이 만든 등록을 교체할 수 있습니다.

첫 번째 호출이 우선합니다. Initialize 은 멱등성입니다: 두 번째 호출은 즉시 반환되고, 그 위임자들은 실행되지 않습니다. 이는 중복된 Application_Start 를 무해하게 유지하지만, Initialize 를 다시 호출하여 구성을 변경할 수 없다는 의미이며 — 대신 애플리케이션 풀을 재시작하십시오.

여기서 발생한 예외 — 라이선스가 없는 플러그인, 잘못된 옵션, 불완전한 팜 구성 — 은 Application_Start 내부에서 발생합니다. ASP.NET은 모든 요청에 빈 500 로 응답하고, 예외는 Windows 이벤트 로그(응용 프로그램 로그, 소스 ASP.NET)에만 기록됩니다.

서비스 및 IsInitialized

csharp
// System.Web에는 생성자 주입이 없습니다: Doconut 서비스를 사용하는 위치에서 해결하세요.
var viewer = Doconut.DoconutHost.Services.GetRequiredService<Viewer>();

// Converter 플러그인이 (플러그인 페이지를 참조하세요) 있을 때만 등록됩니다.
var converter = Doconut.DoconutHost.Services.GetRequiredService<DocumentConverter>();

Services 은 Initialize 이전에 읽히면 InvalidOperationException (DoconutHost.Initialize must be called in Application_Start (Global.asax) before any Doconut request is served.) 를 발생시킵니다. 더 먼저 실행될 수 있는 코드 — 모듈, 정적 생성자 — 는 먼저 IsInitialized 를 확인할 수 있습니다.

코드에서 일반적으로 해결하는 항목:

서비스수명역할
ViewerTransient열기, 닫기, 주석, 리소스 도우미 — Viewer 를 참조하십시오
DocumentConverterTransient변환 — 항상 등록됩니다; Converter 플러그인 없이 해결하면 추가해야 할 플러그인을 명시하는 InvalidOperationException 가 발생합니다
DocumentSignerTransient서명 — Signer 플러그인이 필요합니다 (Signer Plugin 참조)
IDoconutLicenseServiceSingleton로드된 라이선스와 그 기능 — Licensing 을 참조하십시오
DoconutOptionsSingletonInitialize 에 전달된 옵션
HealthCheckServiceSingleton아래의 "doconut" 건강 검사를 실행합니다

DoconutHost.Services 에서 해결하십시오, 자체 컨테이너에서 절대 하지 마세요. Doconut을 다른 컨테이너에 등록하면 핸들러와 모듈이 전혀 보지 못하는 두 번째, 별도의 서비스 세트가 생성됩니다: 이를 통해 열린 문서는 DocImage.axd 에서 알 수 없습니다.

종료

csharp
// Global.asax.cs, Application_End - 백그라운드 작업을 중지하고 컨테이너를 해제합니다.
// 두 번 호출해도 안전하며, Initialize가 실행되지 않은 경우에도 안전합니다.
Doconut.DoconutHost.Shutdown();

Shutdown 은 Doconut의 백그라운드 작업(분산 모드에서 사용)을 중지하고 컨테이너를 해제합니다. 두 번 호출해도 안전하며, Initialize 가 실행되지 않은 경우에도 안전합니다 — 예를 들어 첫 요청 전에 애플리케이션 풀이 재시작되는 경우.

건강 검사

Doconut은 라이선스 상태를 보고하는 "doconut" 라는 이름의 건강 검사를 등록합니다. 클래식 ASP.NET은 자체 건강 검사 엔드포인트가 없으므로, 컨트롤러를 통해 노출하십시오:

csharp
// GET /Health - Doconut은 "doconut" 헬스 체크를 등록하여 라이선스 상태를 보고합니다:
// 정상 (유효), 저하 (평가판 또는 라이선스 파일 없음), 비정상 (거부되었거나 만료됨).
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() 를 포함하고 있으며, 이는 ASP.NET Core 파이프라인 확장입니다. ASP.NET Core 패키지와 코드를 공유하기 때문입니다. 이 패키지에서는 두 항목 모두 [Obsolete] 로 표시되어 사용되지 않습니다: System.Web 애플리케이션에는 추가할 요청 파이프라인이 없습니다. 대신 설치 에서 두 개의 Web.config 등록이 대체됩니다:

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
생성자 주입DoconutHost.Services.GetRequiredService<T>()
호스트 종료DoconutHost.Shutdown() 안에 Application_End

이 페이지가 도움이 되었나요?