View Javadoc
1   /*
2    * Licensed to the Apache Software Foundation (ASF) under one or more
3    *  contributor license agreements.  See the NOTICE file distributed with
4    *  this work for additional information regarding copyright ownership.
5    *  The ASF licenses this file to You under the Apache License, Version 2.0
6    *  (the "License"); you may not use this file except in compliance with
7    *  the License.  You may obtain a copy of the License at
8    *
9    *      http://www.apache.org/licenses/LICENSE-2.0
10   *
11   *  Unless required by applicable law or agreed to in writing, software
12   *  distributed under the License is distributed on an "AS IS" BASIS,
13   *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14   *  See the License for the specific language governing permissions and
15   *  limitations under the License.
16   */
17  
18  package org.apache.commons.exec;
19  
20  /**
21   * The callback handlers for the result of asynchronous process execution. When a process is started asynchronously the callback provides you with the result of
22   * the executed process, i.e. the exit value or an exception.
23   *
24   * @see org.apache.commons.exec.Executor#execute(CommandLine, java.util.Map, ExecuteResultHandler)
25   */
26  public interface ExecuteResultHandler {
27  
28      /**
29       * The asynchronous execution completed.
30       *
31       * @param exitValue the exit value of the sub-process.
32       */
33      void onProcessComplete(int exitValue);
34  
35      /**
36       * The asynchronous execution failed.
37       *
38       * @param e the {@code ExecuteException} containing the root cause.
39       */
40      void onProcessFailed(ExecuteException e);
41  }