Annotations
Interfaces
Classes
- Boolean
- Byte
- Character
- Character.Subset
- Character.UnicodeBlock
- Class
- ClassLoader
- Compiler
- Double
- Enum
- Float
- InheritableThreadLocal
- Integer
- Long
- Math
- Number
- Object
- Package
- Process
- ProcessBuilder
- Runtime
- RuntimePermission
- SecurityManager
- Short
- StackTraceElement
- StrictMath
- String
- StringBuffer
- StringBuilder
- System
- Thread
- ThreadGroup
- ThreadLocal
- Throwable
- Void
Enums
- Thread.State
Exceptions
Errors

Summary: Ctors | Methods | Inherited Methods | [Expand All]

Added in API level 1

public final class

ProcessBuilder

extends Object

java.lang.Object
↳	java.lang.ProcessBuilder

Class Overview

Creates operating system processes. See Process for documentation and example usage.

Summary

Public Constructors
	ProcessBuilder(String... command) Constructs a new `ProcessBuilder` instance with the specified operating system program and its arguments.
	ProcessBuilder(List<String> command) Constructs a new `ProcessBuilder` instance with the specified operating system program and its arguments.

Public Methods
ProcessBuilder	command(List<String> command) Changes the program and arguments of this process builder.
List<String>	command() Returns this process builder's current program and arguments.
ProcessBuilder	command(String... command) Changes the program and arguments of this process builder.
ProcessBuilder	directory(File directory) Changes the working directory of this process builder.
File	directory() Returns the working directory of this process builder.
Map<String, String>	environment() Returns this process builder's current environment.
ProcessBuilder	redirectErrorStream(boolean redirectErrorStream) Changes the state of whether or not standard error is redirected to standard output.
boolean	redirectErrorStream() Indicates whether the standard error should be redirected to standard output.
Process	start() Starts a new process based on the current state of this process builder.

[Expand]

Inherited Methods

From class java.lang.Object

Object	clone() Creates and returns a copy of this `Object`.
boolean	equals(Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class<?>	getClass() Returns the unique instance of `Class` that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait(long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait(long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

Public Constructors

public ProcessBuilder (String... command)

Added in API level 1

Constructs a new ProcessBuilder instance with the specified operating system program and its arguments.

Parameters

command	the requested operating system program and its arguments.

public ProcessBuilder (List<String> command)

Added in API level 1

Constructs a new ProcessBuilder instance with the specified operating system program and its arguments. Note that the list passed to this constructor is not copied, so any subsequent updates to it are reflected in this instance's state.

Parameters

command	the requested operating system program and its arguments.

Throws

NullPointerException	if `command` is `null`.

Public Methods

public ProcessBuilder command (List<String> command)

Added in API level 1

Changes the program and arguments of this process builder. Note that the list passed to this method is not copied, so any subsequent updates to it are reflected in this instance's state.

Parameters

command	the new operating system program and its arguments.

Returns

this process builder instance.

Throws

NullPointerException	if `command` is `null`.

public List<String> command ()

Added in API level 1

Returns this process builder's current program and arguments. Note that the returned list is not a copy and modifications to it will change the state of this instance.

Returns

this process builder's program and arguments.

public ProcessBuilder command (String... command)

Added in API level 1

Changes the program and arguments of this process builder.

Parameters

command	the new operating system program and its arguments.

Returns

this process builder instance.

public ProcessBuilder directory (File directory)

Added in API level 1

Changes the working directory of this process builder. If the specified directory is null, then the working directory of the Java process is used when a process is started.

Parameters

directory	the new working directory for this process builder.

Returns

this process builder instance.

public File directory ()

Added in API level 1

Returns the working directory of this process builder. If null is returned, then the working directory of the Java process is used when a process is started.

Returns

the current working directory, may be null.

public Map<String, String> environment ()

Added in API level 1

Returns this process builder's current environment. When a process builder instance is created, the environment is populated with a copy of the environment, as returned by getenv(). Note that the map returned by this method is not a copy and any changes made to it are reflected in this instance's state.

Returns

the map containing this process builder's environment variables.

public ProcessBuilder redirectErrorStream (boolean redirectErrorStream)

Added in API level 1

Changes the state of whether or not standard error is redirected to standard output.

Parameters

redirectErrorStream	`true` to redirect standard error, `false` otherwise.

Returns

this process builder instance.

public boolean redirectErrorStream ()

Added in API level 1

Indicates whether the standard error should be redirected to standard output. If redirected, the getErrorStream() will always return end of stream and standard error is written to getInputStream().

Returns

true if the standard error is redirected; false otherwise.

public Process start ()

Added in API level 1

Starts a new process based on the current state of this process builder.

Returns

the new Process instance.

Throws

NullPointerException	if any of the elements of `command()` is `null`.
IndexOutOfBoundsException	if `command()` is empty.
IOException	if an I/O error happens.

Results

Annotations

Interfaces

Classes

Enums

Exceptions

Errors

ProcessBuilder

Class Overview

Summary

Public Constructors

public ProcessBuilder (String... command)

Parameters

public ProcessBuilder (List<String> command)

Parameters

Throws

Public Methods

public ProcessBuilder command (List<String> command)

Parameters

Returns

Throws

public List<String> command ()

Returns

public ProcessBuilder command (String... command)

Parameters

Returns

public ProcessBuilder directory (File directory)

Parameters

Returns

public File directory ()

Returns

public Map<String, String> environment ()

Returns

public ProcessBuilder redirectErrorStream (boolean redirectErrorStream)

Parameters

Returns

public boolean redirectErrorStream ()

Returns

public Process start ()

Returns

Throws