Sprawdź i zrestartuj 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>

Sprawdź i zrestartuj IronPdfEngine

IronPdfEngine wykonuje każdą operację PDF dla IronPDF for Java i zarządza swoim cyklem życia automatycznie: uruchamia się przy pierwszym wywołaniu i zatrzymuje, gdy aplikacja się zamyka. Długotrwałe usługi czasami muszą interweniować, na przykład gdy zdalny host się restartuje, system operacyjny wykonuje kill lub natywny błąd przerywa działanie silnika. Klasa IronPdfEngineManager dostarcza statyczne, bezpieczne dla wątków metody do sprawdzania stanu zdrowia silnika oraz do jego uruchamiania, zatrzymywania lub restartowania.

Przykład kodu używa wzorca watchdog. IronPdfEngineManager.isEngineActive() informuje, czy silnik jest połączony, a IronPdfEngineManager.restartEngine() wymusza czyste ponowne połączenie, gdy nie jest, czyszcząc nieaktualny stan połączenia przed następnym renderowaniem. restartEngine() jest zalecaną akcją odzyskiwania. Większość aplikacji nigdy tego nie potrzebuje, ponieważ cykl życia jest automatyczny, ale jest to wartościowe dla wzmocnienia usługi, która musi pozostać dostępna.

Jedno ograniczenie dotyczy sytuacji, gdy dostarczasz własny kanał gRPC przez IronPdfEngineConnection.withCustomGrpcConnection: stopEngine() i restartEngine() nie są dostępne w tym trybie, ponieważ wywołujący jest właścicielem kanału, podczas gdy isEngineActive() i startEngine() działają wszędzie.