public class NuProcessBuilder extends Object
Each NuProcessBuilder
instance manages a collection of process
attributes. The start()
method creates a new NuProcess
instance with those attributes. The start()
method can be invoked
repeatedly from the same instance to create new subprocesses with identical
or related attributes.
Each NuProcessBuilder
manages these attributes:
System.getenv()
.
Modifying a process builder's attributes will affect processes subsequently
started by that object's start()
method, but will never affect
previously started processes or the Java process itself.
Constructor and Description |
---|
NuProcessBuilder(List<String> commands)
Constructs a process builder with the specified operating system program
and arguments.
|
NuProcessBuilder(List<String> commands,
Map<String,String> environment)
Constructs a process builder with the specified operating system program
and arguments.
|
NuProcessBuilder(NuProcessHandler nuProcessHandler,
List<String> commands)
Constructs a process builder with the specified
NuProcessHandler
and operating system program and arguments. |
NuProcessBuilder(NuProcessHandler nuProcessHandler,
String... commands)
Constructs a process builder with the specified
NuProcessHandler
and operating system program and arguments. |
NuProcessBuilder(String... commands)
Constructs a process builder with the specified operating system program
and arguments.
|
Modifier and Type | Method and Description |
---|---|
List<String> |
command()
Get the
List of commands that were used to construct this
NuProcessBuilder . |
Map<String,String> |
environment()
Returns a string map view of this process builder's environment.
|
void |
setCwd(Path cwd)
|
void |
setProcessListener(NuProcessHandler listener)
Set the
NuProcessHandler instance that will be used for the next
and subsequent launch of a NuProcess when calling the
start() method. |
NuProcess |
start()
Spawn the child process with the configured commands, environment, and
NuProcessHandler . |
public NuProcessBuilder(List<String> commands, Map<String,String> environment)
setProcessListener(NuProcessHandler)
in order to set a
NuProcessHandler
instance.commands
- a List
of commandsenvironment
- The environment for the processpublic NuProcessBuilder(List<String> commands)
setProcessListener(NuProcessHandler)
in order to set a
NuProcessHandler
instance.commands
- a List
of commandspublic NuProcessBuilder(String... commands)
setProcessListener(NuProcessHandler)
in order to set a
NuProcessHandler
instance.commands
- a list of commandspublic NuProcessBuilder(NuProcessHandler nuProcessHandler, String... commands)
NuProcessHandler
and operating system program and arguments.nuProcessHandler
- a NuProcessHandler
instancecommands
- a list of commandspublic NuProcessBuilder(NuProcessHandler nuProcessHandler, List<String> commands)
NuProcessHandler
and operating system program and arguments. This constructor makes a copy
of the command list.nuProcessHandler
- a NuProcessHandler
instancecommands
- a List
of commandspublic List<String> command()
List
of commands that were used to construct this
NuProcessBuilder
.List
of commandspublic Map<String,String> environment()
start()
method will use this map as their environment.
The returned object may be modified using ordinary Map operations prior to
invoking the start()
method. The returned map is typically
case-sensitive on all platforms.
public void setProcessListener(NuProcessHandler listener)
NuProcessHandler
instance that will be used for the next
and subsequent launch of a NuProcess
when calling the
start()
method.listener
- a NuProcessHandler
instancepublic void setCwd(Path cwd)
Path
to which the current working directory (cwd) of the
subsequent launch of a NuProcess
will be set when calling the
start()
method.cwd
- a Path
to use for the process's current working
directory, or null
to disable setting the cwd of
subsequently launched procesespublic NuProcess start()
NuProcessHandler
.NuProcess
instance or null
if there is an
immediately detectable launch failureCopyright © 2015 Zaxxer.com. All rights reserved.