Vérifier et redémarrer 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.10.1</version>
</dependency>

Vérifier et redémarrer IronPdfEngine

IronPdfEngine effectue chaque opération PDF pour IronPDF for Java et gère automatiquement son propre cycle de vie : il démarre lors du premier appel et s'arrête lorsque l'application se termine. Les services de longue durée doivent parfois intervenir, par exemple lorsqu'un hôte distant redémarre, qu'un système d'exploitation effectue un kill, ou qu'un crash natif interrompt le moteur. La classe IronPdfEngineManager fournit des méthodes statiques et thread-safe pour vérifier la santé du moteur et pour le démarrer, l'arrêter ou le redémarrer.

L'exemple de code utilise le modèle de chien de garde. IronPdfEngineManager.isEngineActive() indique si le moteur est connecté, et IronPdfEngineManager.restartEngine() force une reconnexion propre lorsqu'il ne l'est pas, en effaçant l'état de connexion obsolète avant le prochain rendu. restartEngine() est l'action de récupération recommandée. La plupart des applications n'en ont jamais besoin, puisque le cycle de vie est automatique, mais c'est précieux pour renforcer un service qui doit rester disponible.

Une limitation s'applique lorsque vous fournissez votre propre canal gRPC via IronPdfEngineConnection.withCustomGrpcConnection : stopEngine() et restartEngine() ne sont pas disponibles dans ce mode car l'appelant possède le canal, tandis que isEngineActive() et startEngine() fonctionnent partout.