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.10.1</version>
</dependency>

IronPdfEngine のチェックと再起動

IronPdfEngineは、IronPDF for JavaのすべてのPDF操作を実行し、そのライフサイクルを自動的に管理します。最初の呼び出しで開始し、アプリケーションが終了すると停止します。長時間実行されるサービスは、リモートホストの再起動、オペレーティングシステムのkill、またはネイティブクラッシュがエンジンを中断する場合に介入する必要があります。IronPdfEngineManagerクラスは、エンジンの状態を確認し、開始、停止、または再起動するための静的でスレッドセーフなメソッドを提供します。

コード例ではウォッチドッグパターンを使用しています。IronPdfEngineManager.isEngineActive()はエンジンが接続されているかどうかを報告し、IronPdfEngineManager.restartEngine()は接続されていない場合にクリーンな再接続を強制し、次のレンダリングの前に古い接続状態をクリアします。restartEngine()は推奨される回復アクションです。ライフサイクルは自動であるため、ほとんどのアプリケーションでは必要ありませんが、常に利用可能でなければならないサービスを強化するために価値があります。

独自のgRPCチャネルをIronPdfEngineConnection.withCustomGrpcConnectionを通じて提供する場合、1つの制限が適用されます。このモードでは、呼び出し側がチャネルを所有しているため、stopEngine()とrestartEngine()は使用できませんが、isEngineActive()とstartEngine()はどこでも動作します。