Verificar y reiniciar 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>

Verificar y reiniciar IronPdfEngine

IronPdfEngine realiza cada operación PDF para IronPDF for Java y gestiona su propio ciclo de vida automáticamente: comienza en la primera llamada y se detiene cuando la aplicación sale. Los servicios de larga duración ocasionalmente necesitan intervenir, por ejemplo, cuando un host remoto se reinicia, un sistema operativo realiza un kill, o un fallo nativo interrumpe el motor. La clase IronPdfEngineManager proporciona métodos estáticos y seguros para hilos para verificar la salud del motor y para iniciarlo, detenerlo o reiniciarlo.

El ejemplo de código utiliza el patrón de watchdog. IronPdfEngineManager.isEngineActive() informa si el motor está conectado, y IronPdfEngineManager.restartEngine() fuerza una reconexión limpia cuando no lo está, limpiando el estado de conexión obsoleto antes del siguiente renderizado. restartEngine() es la acción de recuperación recomendada. La mayoría de las aplicaciones nunca lo necesitan, ya que el ciclo de vida es automático, pero es valioso para fortalecer un servicio que debe permanecer disponible.

Se aplica una limitación cuando proporcionas tu propio canal gRPC a través de IronPdfEngineConnection.withCustomGrpcConnection: stopEngine() y restartEngine() no están disponibles en ese modo porque el llamador posee el canal, mientras que isEngineActive() y startEngine() funcionan en todas partes.

Cómo verificar y reiniciar IronPdfEngine en Java

Instalar la biblioteca IronPDF for Java
Llamar a IronPdfEngineManager.isEngineActive() para verificar la conexión
Llamar a IronPdfEngineManager.restartEngine() para recuperar un motor inactivo
Continuar con cualquier llamada de renderizado o edición de IronPDF

Aprende más en la guía de Configuración de IronPdfEngine.