Ü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

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

Ü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.

Wie man IronPdfEngine in Java überprüft und neu startet

Installieren Sie die IronPDF for Java-Bibliothek
Rufen Sie IronPdfEngineManager.isEngineActive() auf, um die Verbindung zu überprüfen
Rufen Sie IronPdfEngineManager.restartEngine() auf, um eine abgestürzte Engine wiederherzustellen
Fahren Sie mit einem beliebigen IronPDF-Rendering- oder Bearbeitungsaufruf fort

Erfahren Sie mehr im Leitfaden zur Einrichtung von IronPdfEngine.