Überprüfen & Neustarten von 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
Überprüfen & Neustarten von IronPdfEngine

Überprüfen & Neustarten von IronPdfEngine

IronPdfEngine führt jede PDF-Operation für IronPDF for Java aus und verwaltet seinen eigenen Lebenszyklus automatisch: Es startet beim ersten Aufruf und stoppt, wenn die Anwendung beendet wird. Lang laufende Dienste müssen gelegentlich eingreifen, zum Beispiel wenn ein Remote-Host neu startet, ein Betriebssystem kill oder ein nativer Absturz die Engine unterbricht. Die Klasse IronPdfEngineManager bietet statische, threadsichere Methoden, um die Gesundheit der Engine zu überprüfen und sie zu starten, zu stoppen oder neu zu starten.

Das Codebeispiel verwendet das Watchdog-Muster. IronPdfEngineManager.isEngineActive() meldet, ob die Engine verbunden ist, und IronPdfEngineManager.restartEngine() erzwingt eine saubere Wiederverbindung, wenn dies nicht der Fall ist, und löscht den veralteten Verbindungsstatus vor dem nächsten Rendern. restartEngine() ist die empfohlene Wiederherstellungsaktion. Die meisten Anwendungen benötigen dies nie, da der Lebenszyklus automatisch ist, aber es ist wertvoll, um einen Dienst zu härten, der verfügbar bleiben muss.

Eine Einschränkung gilt, wenn Sie Ihren eigenen gRPC-Kanal über IronPdfEngineConnection.withCustomGrpcConnection bereitstellen: stopEngine() und restartEngine() sind in diesem Modus nicht verfügbar, da der Anrufer den Kanal besitzt, während isEngineActive() und startEngine() überall funktionieren.

Erfahren Sie mehr im Leitfaden zur Einrichtung von IronPdfEngine.

Bereit anzufangen?

Version:2026.10gerade veröffentlicht