[ 
https://issues.apache.org/jira/browse/EXEC-42?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12850489#action_12850489
 ] 

Siegfried Goeschl commented on EXEC-42:
---------------------------------------

Always a good idea to improve the documentation - do you have a draft to start 
with?

> 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
>            Assignee: Siegfried Goeschl
>
> 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.

Reply via email to