Verificar e 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 e Reiniciar IronPdfEngine

IronPdfEngine executa todas as operações de PDF para o IronPDF for Java e gerencia seu próprio ciclo de vida automaticamente: ele inicia na primeira chamada e para quando a aplicação é encerrada. Serviços de longa duração ocasionalmente precisam intervir, por exemplo, quando um host remoto reinicia, um kill do sistema operacional ou uma falha nativa interrompe o motor. A classe IronPdfEngineManager fornece métodos estáticos e seguros para threads para verificar a saúde do motor e para iniciá-lo, pará-lo ou reiniciá-lo.

O exemplo de código usa o padrão watchdog. IronPdfEngineManager.isEngineActive() informa se o motor está conectado, e IronPdfEngineManager.restartEngine() força uma reconexão limpa quando não está, limpando o estado de conexão obsoleto antes da próxima renderização. restartEngine() é a ação de recuperação recomendada. A maioria das aplicações nunca precisa disso, já que o ciclo de vida é automático, mas é valioso para reforçar um serviço que deve permanecer disponível.

Uma limitação se aplica quando você fornece seu próprio canal gRPC através de IronPdfEngineConnection.withCustomGrpcConnection: stopEngine() e restartEngine() não estão disponíveis nesse modo porque o chamador possui o canal, enquanto isEngineActive() e startEngine() funcionam em qualquer lugar.