IronPdfEngine 확인 및 재시작


import com.ironsoftware.ironpdf.*;

// Recover automatically if IronPdfEngine was interrupted (host restart, crash, or kill)
if (!IronPdfEngineManager.isEngineActive()) {
    IronPdfEngineManager.restartEngine();
}

// Continue as normal; the engine is now guaranteed to be connected
PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>Hello World</h1>");
pdf.saveAs("output.pdf");

mvn install

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>2026.6.1</version>
</dependency>

IronPdfEngine 확인 및 재시작

IronPdfEngine은 IronPDF for Java의 모든 PDF 작업을 수행하며, 자체 수명 주기를 자동으로 관리합니다. 첫 번째 호출 시 시작하고 애플리케이션이 종료될 때 중지됩니다. 원격 호스트 재시작, 운영 체제 kill 또는 네이티브 충돌로 인해 엔진이 중단될 때 장기 실행 서비스가 개입해야 할 때가 있습니다. IronPdfEngineManager 클래스는 엔진의 상태를 확인하고 시작, 중지 또는 재시작할 수 있는 정적, 스레드 안전 메서드를 제공합니다.

코드 예제는 감시자 패턴을 사용합니다. IronPdfEngineManager.isEngineActive()는 엔진이 연결되어 있는지 보고하며, IronPdfEngineManager.restartEngine()은 연결이 끊어졌을 때 깨끗한 재연결을 강제하여 다음 렌더링 전에 오래된 연결 상태를 지웁니다. restartEngine()은 권장되는 복구 조치입니다. 대부분의 애플리케이션은 수명 주기가 자동이기 때문에 필요하지 않지만, 항상 사용 가능해야 하는 서비스를 강화하는 데 유용합니다.

자체 gRPC 채널을 IronPdfEngineConnection.withCustomGrpcConnection을 통해 제공할 때 하나의 제한이 적용됩니다. 이 모드에서는 호출자가 채널을 소유하기 때문에 stopEngine()과 restartEngine()을 사용할 수 없지만, isEngineActive()와 startEngine()은 어디서나 작동합니다.