<apidef name="extexecution_spi">External Execution SPI</apidef>

            <summary>New API/SPI to abstract process builder</summary>

            <version major="1" minor="28"/>

            <date day="21" month="11" year="2011"/>

            <author login="phejl"/>

            <compatibility binary="compatible" source="compatible" semantic="compatible"/>

            <description>

                New API/SPI classes to allow different implementations

                of process builders.

            </description>

            <class package="org.netbeans.api.extexecution" name="ProcessBuilder"/>

            <class package="org.netbeans.spi.extexecution" name="ProcessBuilderFactory"/>

            <class package="org.netbeans.spi.extexecution" name="ProcessBuilderImplementation"/>

            <issue number="205104"/>

        </change>

        <change>

            <api name="extexecution_api"/>

   The SPI

   <api group="java" name="ExternalExecutionSPI" type="export" category="stable" url="@TOP@org/netbeans/spi/extexecution/package-summary.html"/>

   allows different implementations of process builder.

  </p>

  <p>

  <usecase id="process-builder" name="Custom process builder">

    <p>

      Third party wants to implement custom process builder to provide

      additional functionality, such as remote execution.

    </p>

    <p>

      In order to do so it will implement

      <a href="@TOP@org/netbeans/spi/extexecution/ProcessBuilderImplementation.html">

       ProcessBuilderImplementation</a> and pass

      <a href="@TOP@org/netbeans/api/extexecution/ProcessBuilder.html">

       ProcessBuilder</a> to its clients. The API instances are created with

      help of

      <a href="@TOP@org/netbeans/spi/extexecution/ProcessBuilderFactory.html">ProcessBuilderFactory</a>.

    </p>

  </usecase>

                <package>org.netbeans.spi.extexecution</package>

LocalProcessFactory=Factory creating local processes

 * <p>

 * Also see {@link ProcessBuilder#getLocal()}.

/*

 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.

 *

 * Copyright 2011 Oracle and/or its affiliates. All rights reserved.

 *

 * Oracle and Java are registered trademarks of Oracle and/or its affiliates.

 * Other names may be trademarks of their respective owners.

 *

 * The contents of this file are subject to the terms of either the GNU

 * General Public License Version 2 only ("GPL") or the Common

 * Development and Distribution License("CDDL") (collectively, the

 * "License"). You may not use this file except in compliance with the

 * License. You can obtain a copy of the License at

 * http://www.netbeans.org/cddl-gplv2.html

 * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the

 * specific language governing permissions and limitations under the

 * License.  When distributing the software, include this License Header

 * Notice in each file and include the License file at

 * nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this

 * particular file as subject to the "Classpath" exception as provided

 * by Oracle in the GPL Version 2 section of the License file that

 * accompanied this code. If applicable, add the following below the

 * License Header, with the fields enclosed by brackets [] replaced by

 * your own identifying information:

 * "Portions Copyrighted [year] [name of copyright owner]"

 *

 * If you wish your version of this file to be governed by only the CDDL

 * or only the GPL Version 2, indicate your decision by adding

 * "[Contributor] elects to include this software in this distribution

 * under the [CDDL or GPL Version 2] license." If you do not indicate a

 * single choice of license, a recipient has the option to distribute

 * your version of this file under either the CDDL, the GPL Version 2 or

 * to extend the choice of license to its licensees as provided above.

 * However, if you add GPL Version 2 code and therefore, elected the GPL

 * Version 2 license, then the option applies only if the new code is

 * made subject to such option by the copyright holder.

 *

 * Contributor(s):

 *

 * Portions Copyrighted 2011 Sun Microsystems, Inc.

 */

package org.netbeans.api.extexecution;

import java.io.File;

import java.io.IOException;

import java.util.ArrayList;

import java.util.HashMap;

import java.util.List;

import java.util.Map;

import java.util.concurrent.Callable;

import org.netbeans.api.annotations.common.NonNull;

import org.netbeans.api.annotations.common.NullAllowed;

import org.netbeans.spi.extexecution.ProcessBuilderFactory;

import org.netbeans.spi.extexecution.ProcessBuilderImplementation;

import org.openide.util.NbBundle;

import org.openide.util.Parameters;

/**

 * Abstraction of process builders. You can freely configure the parameters

 * and then create a process by calling the {@link #call()} method. You can

 * also (re)configure the builder and spawn a different process.

 * <p>

 * Note the API does not prescribe the actual meaning of {@link Process}.

 * It may be local process, remote process or some other implementation.

 * <p>

 * You can use the default implementation returned by {@link #getLocal()}

 * for creating the local machine OS processes.

 * <p>

 * <i>Thread safety</i> of this class depends on thread safety of

 * the {@link ProcessBuilderImplementation} the class is using. If it is thread

 * safe (if possible the implementation should be even stateless) this class

 * is thread safe as well.

 *

 * @author Petr Hejl

 * @since 1.28

 */

public final class ProcessBuilder implements Callable<Process> {

    private final ProcessBuilderImplementation implementation;

    private final String description;

    /**<i>GuardedBy("this")</i>*/

    private String executable;

    /**<i>GuardedBy("this")</i>*/

    private String workingDirectory;

    /**<i>GuardedBy("this")</i>*/

    private List<String> arguments = new ArrayList<String>();

    /**<i>GuardedBy("this")</i>*/

    private List<String> paths = new ArrayList<String>();

    /**<i>GuardedBy("this")</i>*/

    private Map<String, String> envVariables = new HashMap<String, String>();

    /**<i>GuardedBy("this")</i>*/

    private boolean redirectErrorStream;

    static {

        ProcessBuilderFactory.Accessor.DEFAULT = new ProcessBuilderFactory.Accessor() {

            @Override

            public ProcessBuilder createProcessBuilder(ProcessBuilderImplementation impl, String description) {

                return new ProcessBuilder(impl, description);

            }

        };

    }

    private ProcessBuilder(ProcessBuilderImplementation implementation, String description) {

        this.implementation = implementation;

        this.description = description;

    }

    /**

     * Returns the {@link ProcessBuilder} creating the OS process on local

     * machine. Returned implementation is <code>thread safe</code>.

     *

     * @return the {@link ProcessBuilder} creating the OS process on local

     *             machine

     */

    public static ProcessBuilder getLocal() {

        return new ProcessBuilder(new LocalProcessFactory(),

                NbBundle.getMessage(ProcessBuilder.class, "LocalProcessFactory"));

    }

    /**

     * Returns the human readable description of this builder.

     *

     * @return the human readable description of this builder

     */

    @NonNull

    public String getDescription() {

        return description;

    }

    /**

     * Sets the executable to run. There is no default value. The {@link #call()}

     * methods throws {@link IllegalStateException} when there is no executable

     * configured.

     *

     * @param executable the executable to run

     */

    public void setExecutable(@NonNull String executable) {

        Parameters.notNull("executable", executable);

        synchronized (this) {

            this.executable = executable;

        }

    }

    /**

     * Sets the working directory for the process created by subsequent call

     * of {@link #call()}. The default value is implementation specific.

     *

     * @param workingDirectory the working directory of the process

     */

    public void setWorkingDirectory(@NullAllowed String workingDirectory) {

        synchronized (this) {

            this.workingDirectory = workingDirectory;

        }

    }

    /**

     * Sets the arguments passed to the process created by subsequent call

     * of {@link #call()}. By default there are no arguments.

     *

     * @param arguments the arguments passed to the process

     */

    public void setArguments(@NonNull List<String> arguments) {

        Parameters.notNull("arguments", arguments);

        synchronized (this) {

            this.arguments.clear();

            this.arguments.addAll(arguments);

        }

    }

    /**

     * Sets the environment variables for the process created by subsequent call

     * of {@link #call()}. By default there are no environment variables with

     * exception of <code>PATH</code> possibly configured by {@link #setPaths(java.util.List)}.

     *

     * @param envVariables the environment variables for the process

     */

    public void setEnvironmentVariables(@NonNull Map<String, String> envVariables) {

        Parameters.notNull("envVariables", envVariables);

        synchronized (this) {

            this.envVariables.clear();

            this.envVariables.putAll(envVariables);

        }

    }

    /**

     * Sets the additional paths to be included in <code>PATH</code> environment

     * variable for the process.

     *

     * @param paths the additional paths to be included in <code>PATH</code>

     *             environment variable

     */

    public void setPaths(@NonNull List<String> paths) {

        Parameters.notNull("paths", paths);

        synchronized (this) {

            this.paths.clear();

            this.paths.addAll(paths);

        }

    }

    /**

     * Configures the error stream redirection. If <code>true</code> the error

     * stream of process created by subsequent call of {@link #call()} method

     * will be redirected to standard output stream.

     *

     * @param redirectErrorStream the error stream redirection

     */

    public void setRedirectErrorStream(boolean redirectErrorStream) {

        synchronized (this) {

            this.redirectErrorStream = redirectErrorStream;

        }

    }

    /**

     * Creates the new {@link Process} based on the properties configured

     * in this builder.

     * <p>

     * Actual behavior depends on the builder implementation, but it should

     * respect all the properties configured on this builder.

     *

     * @see ProcessBuilderImplementation

     * @return the new {@link Process} based on the properties configured

     *             in this builder

     * @throws IOException if the process could not be created

     * @throws IllegalStateException if there is no executable configured

     *             by {@link #setExecutable(java.lang.String)}

     */

    @NonNull

    @Override

    public Process call() throws IOException {

        String currentExecutable = null;

        String currentWorkingDirectory = null;

        List<String> currentArguments = new ArrayList<String>();

        List<String> currentPaths = new ArrayList<String>();

        Map<String, String> currentEnvVariables = new HashMap<String, String>();

        boolean currentRedirectErrorStream = false;

        synchronized (this) {

            currentExecutable = executable;

            currentWorkingDirectory = workingDirectory;

            currentArguments.addAll(arguments);

            currentPaths.addAll(paths);

            currentEnvVariables.putAll(envVariables);

            currentRedirectErrorStream = redirectErrorStream;

        }

        if (currentExecutable == null) {

            throw new IllegalStateException("The executable has not been configured");

        }

        return implementation.createProcess(currentExecutable, currentWorkingDirectory, currentArguments,

                currentPaths, currentEnvVariables, currentRedirectErrorStream);

    }

    private static class LocalProcessFactory implements ProcessBuilderImplementation {

        @Override

        public Process createProcess(String executable, String workingDirectory, List<String> arguments,

                List<String> paths, Map<String, String> environment, boolean redirectErrorStream) throws IOException {

            ExternalProcessBuilder builder = new ExternalProcessBuilder(executable);

            if (workingDirectory != null) {

                builder = builder.workingDirectory(new File(workingDirectory));

            }

            for (String argument : arguments) {

                builder = builder.addArgument(argument);

            }

            for (String path : paths) {

                builder = builder.prependPath(new File(path));

            }

            for (Map.Entry<String, String> entry : environment.entrySet()) {

                builder = builder.addEnvironmentVariable(entry.getKey(), entry.getValue());

            }

            builder = builder.redirectErrorStream(redirectErrorStream);

            return builder.call();

        }

    }

}

/*

 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.

 *

 * Copyright 2011 Oracle and/or its affiliates. All rights reserved.

 *

 * Oracle and Java are registered trademarks of Oracle and/or its affiliates.

 * Other names may be trademarks of their respective owners.

 *

 * The contents of this file are subject to the terms of either the GNU

 * General Public License Version 2 only ("GPL") or the Common

 * Development and Distribution License("CDDL") (collectively, the

 * "License"). You may not use this file except in compliance with the

 * License. You can obtain a copy of the License at

 * http://www.netbeans.org/cddl-gplv2.html

 * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the

 * specific language governing permissions and limitations under the

 * License.  When distributing the software, include this License Header

 * Notice in each file and include the License file at

 * nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this

 * particular file as subject to the "Classpath" exception as provided

 * by Oracle in the GPL Version 2 section of the License file that

 * accompanied this code. If applicable, add the following below the

 * License Header, with the fields enclosed by brackets [] replaced by

 * your own identifying information:

 * "Portions Copyrighted [year] [name of copyright owner]"

 *

 * If you wish your version of this file to be governed by only the CDDL

 * or only the GPL Version 2, indicate your decision by adding

 * "[Contributor] elects to include this software in this distribution

 * under the [CDDL or GPL Version 2] license." If you do not indicate a

 * single choice of license, a recipient has the option to distribute

 * your version of this file under either the CDDL, the GPL Version 2 or

 * to extend the choice of license to its licensees as provided above.

 * However, if you add GPL Version 2 code and therefore, elected the GPL

 * Version 2 license, then the option applies only if the new code is

 * made subject to such option by the copyright holder.

 *

 * Contributor(s):

 *

 * Portions Copyrighted 2011 Sun Microsystems, Inc.

 */

package org.netbeans.spi.extexecution;

/**

 * The factory allowing SPI implementors of {@link ProcessBuilderImplementation}

 * to create its API instances {@link org.netbeans.api.extexecution.ProcessBuilder}.

 *

 * @author Petr Hejl

 * @since 1.28

 */

public class ProcessBuilderFactory {

    private ProcessBuilderFactory() {

        super();

    }

    /**

     * Creates the instance of {@link org.netbeans.api.extexecution.ProcessBuilder}

     * from its SPI representation.

     *

     * @param impl SPI representation

     * @param description human readable description of the builder

     * @return the API instance

     */

    public static org.netbeans.api.extexecution.ProcessBuilder createProcessBuilder(

            ProcessBuilderImplementation impl, String description) {

        return Accessor.DEFAULT.createProcessBuilder(impl, description);

    }

    /**

     * The accessor pattern class.

     */

    public abstract static class Accessor {

        /** The default accessor. */

        public static Accessor DEFAULT;

        static {

            // invokes static initializer of ProcessBuilder.class

            // that will assign value to the DEFAULT field above

            Class c = org.netbeans.api.extexecution.ProcessBuilder.class;

            try {

                Class.forName(c.getName(), true, c.getClassLoader());

            } catch (ClassNotFoundException ex) {

                assert false : ex;

            }

        }

        /**

         * Creates the instance of {@link org.netbeans.api.extexecution.ProcessBuilder}

         * from its SPI representation.

         *

         * @param impl SPI representation

         * @param description human readable description of the builder

         * @return the API instance

         */

        public abstract org.netbeans.api.extexecution.ProcessBuilder createProcessBuilder(

                ProcessBuilderImplementation impl, String description);

    }

}

/*

 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.

 *

 * Copyright 2011 Oracle and/or its affiliates. All rights reserved.

 *

 * Oracle and Java are registered trademarks of Oracle and/or its affiliates.

 * Other names may be trademarks of their respective owners.

 *

 * The contents of this file are subject to the terms of either the GNU

 * General Public License Version 2 only ("GPL") or the Common

 * Development and Distribution License("CDDL") (collectively, the

 * "License"). You may not use this file except in compliance with the

 * License. You can obtain a copy of the License at

 * http://www.netbeans.org/cddl-gplv2.html

 * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the

 * specific language governing permissions and limitations under the

 * License.  When distributing the software, include this License Header

 * Notice in each file and include the License file at

 * nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this

 * particular file as subject to the "Classpath" exception as provided

 * by Oracle in the GPL Version 2 section of the License file that

 * accompanied this code. If applicable, add the following below the

 * License Header, with the fields enclosed by brackets [] replaced by

 * your own identifying information:

 * "Portions Copyrighted [year] [name of copyright owner]"

 *

 * If you wish your version of this file to be governed by only the CDDL

 * or only the GPL Version 2, indicate your decision by adding

 * "[Contributor] elects to include this software in this distribution

 * under the [CDDL or GPL Version 2] license." If you do not indicate a

 * single choice of license, a recipient has the option to distribute

 * your version of this file under either the CDDL, the GPL Version 2 or

 * to extend the choice of license to its licensees as provided above.

 * However, if you add GPL Version 2 code and therefore, elected the GPL

 * Version 2 license, then the option applies only if the new code is

 * made subject to such option by the copyright holder.

 *

 * Contributor(s):

 *

 * Portions Copyrighted 2011 Sun Microsystems, Inc.

 */

package org.netbeans.spi.extexecution;

import java.io.IOException;

import java.util.List;

import java.util.Map;

import org.netbeans.api.annotations.common.NonNull;

import org.netbeans.api.annotations.common.NullAllowed;

/**

 * The interface representing the implementation

 * of {@link org.netbeans.api.extexecution.ProcessBuilder}.

 *

 * <div class="nonnormative">

 * <p>

 * Although it is not required it is reasonable to have implementation of this

 * interface stateless. In such case instances of {@link org.netbeans.api.extexecution.ProcessBuilder}

 * using it will be <i>thread safe</i>.

 * </div>

 *

 * @see org.netbeans.api.extexecution.ProcessBuilder

 * @author Petr Hejl

 * @since 1.28

 */

public interface ProcessBuilderImplementation {

    /**

     * Creates a process using the specified parameters and environment

     * configuration.

     *

     * @param executable the name of the executable to run

     * @param workingDirectory the working directory of the created process or

     *             <code>null</code> as implementation specific default

     * @param arguments the arguments passed to the process

     * @param paths the additional paths to add to <code>PATH</code> environment

     *             variable

     * @param environment environment variables to configure for the process

     * @param redirectErrorStream when <code>true</code> the error stream of

     *             the process should be redirected to standard output stream

     * @return a process created with specified parameters and environment

     *             configuration

     * @throws IOException IOException if the process could not be created

     */

    @NonNull

    Process createProcess(@NonNull String executable, @NullAllowed String workingDirectory, @NonNull List<String> arguments,

            @NonNull List<String> paths, @NonNull Map<String, String> environment, boolean redirectErrorStream) throws IOException;

}

/*

 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.

 *

 * Copyright 1997-2010 Oracle and/or its affiliates. All rights reserved.

 *

 * Oracle and Java are registered trademarks of Oracle and/or its affiliates.

 * Other names may be trademarks of their respective owners.

 *

 * The contents of this file are subject to the terms of either the GNU

 * General Public License Version 2 only ("GPL") or the Common

 * Development and Distribution License("CDDL") (collectively, the

 * "License"). You may not use this file except in compliance with the

 * License. You can obtain a copy of the License at

 * http://www.netbeans.org/cddl-gplv2.html

 * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the

 * specific language governing permissions and limitations under the

 * License.  When distributing the software, include this License Header

 * Notice in each file and include the License file at

 * nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this

 * particular file as subject to the "Classpath" exception as provided

 * by Oracle in the GPL Version 2 section of the License file that

 * accompanied this code. If applicable, add the following below the

 * License Header, with the fields enclosed by brackets [] replaced by

 * your own identifying information:

 * "Portions Copyrighted [year] [name of copyright owner]"

 *

 * Contributor(s):

 *

 * The Original Software is NetBeans. The Initial Developer of the Original

 * Software is Sun Microsystems, Inc. Portions Copyright 1997-2007 Sun

 * Microsystems, Inc. All Rights Reserved.

 *

 * If you wish your version of this file to be governed by only the CDDL

 * or only the GPL Version 2, indicate your decision by adding

 * "[Contributor] elects to include this software in this distribution

 * under the [CDDL or GPL Version 2] license." If you do not indicate a

 * single choice of license, a recipient has the option to distribute

 * your version of this file under either the CDDL, the GPL Version 2 or

 * to extend the choice of license to its licensees as provided above.

 * However, if you add GPL Version 2 code and therefore, elected the GPL

 * Version 2 license, then the option applies only if the new code is

 * made subject to such option by the copyright holder.

 */

/**

 * The support SPI for creation of external processes.

 *

 * @see org.netbeans.spi.extexecution.ProcessBuilderImplementation

 */

package org.netbeans.spi.extexecution;

/*

 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.

 *

 * Copyright 2011 Oracle and/or its affiliates. All rights reserved.

 *

 * Oracle and Java are registered trademarks of Oracle and/or its affiliates.

 * Other names may be trademarks of their respective owners.

 *

 * The contents of this file are subject to the terms of either the GNU

 * General Public License Version 2 only ("GPL") or the Common

 * Development and Distribution License("CDDL") (collectively, the

 * "License"). You may not use this file except in compliance with the

 * License. You can obtain a copy of the License at

 * http://www.netbeans.org/cddl-gplv2.html

 * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the

 * specific language governing permissions and limitations under the

 * License.  When distributing the software, include this License Header

 * Notice in each file and include the License file at

 * nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this

 * particular file as subject to the "Classpath" exception as provided

 * by Oracle in the GPL Version 2 section of the License file that

 * accompanied this code. If applicable, add the following below the

 * License Header, with the fields enclosed by brackets [] replaced by

 * your own identifying information:

 * "Portions Copyrighted [year] [name of copyright owner]"

 *

 * If you wish your version of this file to be governed by only the CDDL

 * or only the GPL Version 2, indicate your decision by adding

 * "[Contributor] elects to include this software in this distribution

 * under the [CDDL or GPL Version 2] license." If you do not indicate a

 * single choice of license, a recipient has the option to distribute

 * your version of this file under either the CDDL, the GPL Version 2 or

 * to extend the choice of license to its licensees as provided above.

 * However, if you add GPL Version 2 code and therefore, elected the GPL

 * Version 2 license, then the option applies only if the new code is

 * made subject to such option by the copyright holder.

 *

 * Contributor(s):

 *

 * Portions Copyrighted 2011 Sun Microsystems, Inc.

 */

package org.netbeans.api.extexecution;

import java.io.IOException;

import java.util.List;

import java.util.Map;

import org.netbeans.junit.NbTestCase;

import org.netbeans.spi.extexecution.ProcessBuilderFactory;

import org.netbeans.spi.extexecution.ProcessBuilderImplementation;

/**

 *

 * @author Petr Hejl

 */

public class ProcessBuilderTest extends NbTestCase {

    public ProcessBuilderTest(String name) {

        super(name);

    }

    public void testExecutable() throws IOException {

        TestProcessBuilder testBuilder = new TestProcessBuilder();

        ProcessBuilder builder = ProcessBuilderFactory.createProcessBuilder(testBuilder, "Test builder");

        try {

            builder.call();

            fail("Empty executable does not throw exception");

        } catch (IllegalStateException ex) {

            // expected

        }

        builder.setExecutable("ls");

        builder.call();

        assertEquals("ls", testBuilder.getExecutable());

        builder.setExecutable("cd");

        assertEquals("ls", testBuilder.getExecutable());

        builder.call();

        assertEquals("cd", testBuilder.getExecutable());

    }

    public void testWorkingDirectory() throws IOException {

        TestProcessBuilder testBuilder = new TestProcessBuilder();

        ProcessBuilder builder = ProcessBuilderFactory.createProcessBuilder(testBuilder, "Test builder");

        builder.setExecutable("ls");

        builder.call();

        assertNull(testBuilder.getWorkingDirectory());

        builder.setWorkingDirectory("test");

        assertNull(testBuilder.getWorkingDirectory());

        builder.call();

        assertEquals("test", testBuilder.getWorkingDirectory());

    }

    public void testRedirectErrorStream() throws IOException {

        TestProcessBuilder testBuilder = new TestProcessBuilder();

        ProcessBuilder builder = ProcessBuilderFactory.createProcessBuilder(testBuilder, "Test builder");

        builder.setExecutable("ls");

        builder.call();

        assertFalse(testBuilder.isRedirectErrorStream());

        builder.setRedirectErrorStream(true);

        assertFalse(testBuilder.isRedirectErrorStream());

        builder.call();

        assertTrue(testBuilder.isRedirectErrorStream());

    }

    private class TestProcessBuilder implements ProcessBuilderImplementation {

        private String executable;

        private String workingDirectory;

        private List<String> arguments;

        private List<String> paths;

        private Map<String, String> environment;

        private boolean redirectErrorStream;

        @Override

        public Process createProcess(String executable, String workingDirectory,

                List<String> arguments, List<String> paths, Map<String, String> environment, boolean redirectErrorStream) throws IOException {

            this.executable = executable;

            this.workingDirectory = workingDirectory;

            this.arguments = arguments;

            this.paths = paths;

            this.environment = environment;

            this.redirectErrorStream = redirectErrorStream;

            return null;

        }

        public String getExecutable() {

            return executable;

        }

        public List<String> getArguments() {

            return arguments;

        }

        public List<String> getPaths() {

            return paths;

        }

        public Map<String, String> getEnvironment() {

            return environment;

        }

        public boolean isRedirectErrorStream() {

            return redirectErrorStream;

        }

        public String getWorkingDirectory() {

            return workingDirectory;

        }

    }

}