Mailing-List: contact issues-help@commons.apache.org; run by ezmlm
Precedence: bulk
Reply-To: issues@commons.apache.org
Message-ID: <1494256186.1256296679389.JavaMail.jira@brutus>
Date: Fri, 23 Oct 2009 11:17:59 +0000 (UTC)
From: "Konrad Windszus (JIRA)" <jira@apache.org>
To: issues@commons.apache.org
Subject: [jira] Created: (EXEC-42) Tutorial should include example for
 asynchronous handling
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit

Tutorial should include example for asynchronous handling
---------------------------------------------------------

                 Key: EXEC-42
                 URL: https://issues.apache.org/jira/browse/EXEC-42
             Project: Commons Exec
          Issue Type: Improvement
            Reporter: Konrad Windszus


I had some difficulties figuring out, how to asynchronously start a process. You should include an example for this on the tutorial page. Especially interesting is the following:

- How to start it (explain ExecuteResultHandler and that the callbacks are called from another thread, so these should be implemented thread-safe)
- How to know if it is still running (not possible via watchdog, but has to be implemented for oneself using the ExecuteResultHandler, again watch out for thread safety)
- How to force to terminate a process (using the watchdog)
- Add a hint about StreamHandler and that you should always use a PumpStreamHandler (otherwise this could lead to deadlocks, see http://www.javaworld.com/javaworld/jw-12-2000/jw-1229-traps.html?).
- Add an explanation of exit values, since an exit value which is not in the list of the DefaultExecutor, leads automatically to an exception, which is not clear from the javadocs.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.