Class ParentListener

java.lang.Object
java.lang.Thread
org.apache.commons.launcher.ParentListener
All Implemented Interfaces:
Runnable

public class ParentListener extends Thread
A class for detecting if the parent JVM that launched this process has terminated.
Author:
Patrick Luby
  • Constructor Details

    • ParentListener

      public ParentListener(String path) throws IOException
      Validates and caches a lock file created by the parent JVM.
      Parameters:
      path - the lock file that the parent JVM has an open FileOutputStream
      Throws:
      IOException - if the heartbeat cannot be converted into a valid File object
  • Method Details

    • run

      public void run()
      Periodically check that the parent JVM has not terminated. On all platforms other than Windows, this method will check that System.in has not been closed. On Windows NT, 2000, and XP the lock file specified in the ParentListener(String) constructor is monitored as reading System.in will block the entire process on Windows machines that use some versions of Unix shells such as MKS, etc. No monitoring is done on Window 95, 98, and ME.
      Specified by:
      run in interface Runnable
      Overrides:
      run in class Thread