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

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

  1. Instalar la biblioteca IronPDF for Java
  2. Llamar a IronPdfEngineManager.isEngineActive() para verificar la conexión
  3. Llamar a IronPdfEngineManager.restartEngine() para recuperar un motor inactivo
  4. Continuar con cualquier llamada de renderizado o edición de IronPDF
Aprende más en la guía de Configuración de IronPdfEngine.

¿Listo para empezar?

Versión:2026.10recién publicada

Descarga Gratis de Maven