Index

wrapper.on_exit.<n>
Compatibilité :3.1.0
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community
Plateformes :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Certaines applications ont le bon réflexe de renvoyer des « codes de sortie » porteurs de signification. Dans de tels cas, il peut être souhaitable de redémarrer l'application lorsqu'elle se termine avec certains codes de sortie. Cet ensemble de propriétés rend cela possible.

wrapper.on_exit.default

Il est possible de spécifier une action à entreprendre pour n'importe quel code de sortie en utilisant la propriété wrapper.on_exit.default et en la définissant sur SHUTDOWN ou RESTART. La valeur par défaut est SHUTDOWN.

L'action peut être l'une des suivantes :

  • RESTART
  • SHUTDOWN
  • PAUSE (Depuis la ver. 3.5.0) : mettra le Wrapper dans un état de pause. Cela retarde le redémarrage de la JVM jusqu'à ce que le Wrapper soit repris. Si la pause du Wrapper n'est pas activée, la JVM sera redémarrée comme si l'action RESTART avait été configurée. Consultez la propriété wrapper.pausable pour plus de détails.
Exemple : (Action par défaut) 
wrapper.on_exit.default=SHUTDOWN

wrapper.on_exit.<n>

De plus, il est possible de spécifier ce qui se produira pour un code de sortie spécifique en définissant une propriété dont le nom est wrapper.on_exit. suivi du code de sortie.

Le nom de la propriété commence par wrapper.on_exit.<n>. et le composant « <n> » du nom de la propriété est un code de sortie.

L'action peut être l'une des suivantes :

  • RESTART : lancera une nouvelle JVM.
  • SHUTDOWN : procédera à l'arrêt du Wrapper.
  • PAUSE (Depuis la ver. 3.5.0) : mettra le Wrapper dans un état de pause. Cela retarde le redémarrage de la JVM jusqu'à ce que le Wrapper soit repris. Si la pause du Wrapper n'est pas activée, la JVM sera redémarrée comme si l'action RESTART avait été configurée. Consultez la propriété wrapper.pausable pour plus de détails.

Si une propriété on_exit.<n> n'est pas définie pour un code de sortie donné, elle prendra par défaut la valeur de la propriété wrapper.on_exit.default.

Exemple : (Redémarrage sur le code de sortie 1) 
wrapper.on_exit.1=RESTART

Exemple d'utilisation :

Pour configurer le Wrapper afin qu'il redémarre la JVM pour tous les codes de sortie excepté le code de sortie « 0 » (zéro), utilisez ce qui suit :

Exemple : (Code de sortie « 0 » : Arrêt de la JVM, Tous les autres codes de sortie : Redémarrage de la JVM) 
wrapper.on_exit.default=RESTART
wrapper.on_exit.0=SHUTDOWN

Les propriétés on_exit seront déclenchées par les appels à WrapperManager.stop(n), WrapperManager.stopImmediate(n) et System.exit(n).

Les signaux ou actions externes qui déclenchent l'arrêt du Wrapper et de sa JVM feront que ces propriétés seront ignorées pendant l'arrêt du Wrapper. Cela signifie que configurer le Wrapper pour qu'il redémarre sur n'importe quel code de sortie n'empêchera pas le Wrapper de s'arrêter.