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

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.

Como Verificar e Reiniciar o IronPdfEngine em Java

  1. Instale a biblioteca IronPDF for Java
  2. Chame IronPdfEngineManager.isEngineActive() para verificar a conexão
  3. Chame IronPdfEngineManager.restartEngine() para recuperar um motor inativo
  4. Continue com qualquer chamada de renderização ou edição do IronPDF
Saiba mais no guia de Configuração do IronPdfEngine.

Pronto para começar?

Versão:2026.10recém-lançado

Download gratuito do Maven