ProcessBuilder (Платформа Java SE 8 b92)

java.lang. Объект
- java.lang. ProcessBuilder

```
public final class ProcessBuilder
extends Object
```
Этот class используется, чтобы создать процессы операционной системы.
Каждый ProcessBuilder экземпляр управляет набором атрибутов процесса. start() метод создает новое Process экземпляр с теми атрибутами. start() метод может неоднократно вызываться от того же самого экземпляра, чтобы создать новые подпроцессы с идентичными или связанными атрибутами.
Каждый разработчик процесса управляет этими атрибутами процесса:
- команда, список строк, который показывает внешний программный файл, который будет вызван и его параметры, если любой. То, которые представляют списки в виде строки, представляют допустимую команду операционной системы, системно-зависимо. Например, каждому концептуальному параметру свойственно быть элементом в этом списке, но есть операционные системы, где программы, как ожидают, будут маркировать строки командной строки непосредственно - на такой системе, реализация Java могла бы потребовать, чтобы команды содержали точно два элемента.
- среда, которая является системно-зависимым отображением от переменных до значений. Начальное значение является копией среды текущего процесса (см. System.getenv()).
- рабочий каталог. Значение по умолчанию является текущим рабочим каталогом текущего процесса, обычно каталогом, названным системным свойством user.dir.
- источник стандартного ввода. По умолчанию чтения подпроцесса вводятся от канала. Код Java может получить доступ к этому каналу через поток вывода, возвращенный Process.getOutputStream(). Однако, стандартный ввод может быть перенаправлен к другому исходному использованию redirectInput. В этом случае, Process.getOutputStream() возвратит нулевой поток вывода, для который:
  - write методы всегда бросают IOException
  - close метод ничего не делает
- место назначения для стандартного вывода и стандартной ошибки. По умолчанию подпроцесс пишет стандартный вывод и стандартную ошибку к каналам. Код Java может получить доступ к этим каналам через входные потоки, возвращенные Process.getInputStream() и Process.getErrorStream(). Однако, стандартный вывод и стандартная ошибка могут быть перенаправлены другим местам назначения, использующим redirectOutput и redirectError. В этом случае, Process.getInputStream() и/или Process.getErrorStream() возвратит нулевой входной поток, для который:
  - read методы всегда возвращаются -1
  - available метод всегда возвращается 0
  - close метод ничего не делает
- redirectErrorStream свойство. Первоначально, это свойство false, подразумевать, что стандартный вывод и вывод ошибок подпроцесса отправляются двум отдельным потокам, к которым можно получить доступ, используя Process.getInputStream() и Process.getErrorStream() методы.
  Если значение устанавливается в true, тогда:
  - стандартная ошибка объединяется со стандартным выводом и всегда отправляется тому же самому месту назначения (это облегчает коррелировать сообщения об ошибках с соответствующим выводом),
  - общее место назначения стандартной ошибки и стандартного вывода может быть перенаправлено, используя redirectOutput
  - любое перенаправление, установленное redirectError метод игнорируется, создавая подпроцесс
  - поток, возвращенный из Process.getErrorStream() всегда будет нулевой входной поток
Изменяя процесс атрибуты разработчика будут влиять на процессы, впоследствии запущенные тем объектом start() метод, но никогда не будет влиять на ранее запущенные процессы или процесс Java непосредственно.
Большинство проверки на ошибки выполняется start() метод. Возможно изменить состояние объекта так, чтобы start() перестанет работать. Например, установка атрибута команды к пустому списку не будет выдавать исключение если start() вызывается.
Отметьте, что этот class не синхронизируется. Если многократный доступ потоков a ProcessBuilder экземпляр одновременно, и по крайней мере один из потоков изменяют один из атрибутов структурно, это должно синхронизироваться внешне.
Запуск нового процесса, который использует значение по умолчанию, рабочий каталог и среда легки:
```
 
 Process p = new ProcessBuilder("myCommand", "myArg").start();
 
```
Вот пример, который запускает процесс с измененного рабочего каталога и среды, и перенаправляет стандартный вывод и ошибку, которая будет добавлена к файлу журнала:
```
 
 ProcessBuilder pb =
   new ProcessBuilder("myCommand", "myArg1", "myArg2");
 Map<String, String> env = pb.environment();
 env.put("VAR1", "myValue");
 env.remove("OTHERVAR");
 env.put("VAR2", env.get("VAR1") + "suffix");
 pb.directory(new File("myDir"));
 File log = new File("log");
 pb.redirectErrorStream(true);
 pb.redirectOutput(Redirect.appendTo(log));
 Process p = pb.start();
 assert pb.redirectInput() == Redirect.PIPE;
 assert pb.redirectOutput().file() == log;
 assert p.getInputStream().read() == -1;
 
```
Чтобы запустить процесс с явного набора переменных окружения, сначала вызовите Map.clear() прежде, чем добавить переменные окружения.
С тех пор:

1.5

Вложенная Сводка Класса

Вложенные Классы
Модификатор и Тип	Класс и Описание
`static class`	`ProcessBuilder. Перенаправление` Представляет источник ввода подпроцесса или место назначения вывода подпроцесса.

Сводка конструктора

Конструкторы
Конструктор и Описание
`ProcessBuilder(List<String> command)` Создает разработчика процесса с указанной программой операционной системы и параметрами.
`ProcessBuilder(String... command)` Создает разработчика процесса с указанной программой операционной системы и параметрами.

Сводка метода

Все Методы Методы экземпляра Конкретные Методы
Модификатор и Тип	Метод и Описание
`List<String>`	`command()` Возвраты эта программа операционной системы разработчика процесса и параметры.
`ProcessBuilder`	`command(List<String> command)` Наборы эта программа операционной системы разработчика процесса и параметры.
`ProcessBuilder`	`command(String... command)` Наборы эта программа операционной системы разработчика процесса и параметры.
`Файл`	`directory()` Возвраты рабочий каталог разработчика этого процесса.
`ProcessBuilder`	`directory(File directory)` Наборы рабочий каталог разработчика этого процесса.
`Map<String,String>`	`environment()` Возвращает строковое представление карты этой среды разработчика процесса.
`ProcessBuilder`	`inheritIO()` Устанавливает источник и место назначения для ввода-вывода стандарта подпроцесса, чтобы быть тем же самым как таковыми из текущего процесса Java.
`ProcessBuilder. Перенаправление`	`redirectError()` Возвраты стандартное ошибочное место назначения разработчика этого процесса.
`ProcessBuilder`	`redirectError(File file)` Наборы стандартное ошибочное место назначения разработчика этого процесса к файлу.
`ProcessBuilder`	`redirectError(ProcessBuilder.Redirect destination)` Наборы стандартное ошибочное место назначения разработчика этого процесса.
`boolean`	`redirectErrorStream()` Говорит, объединяет ли этот разработчик процесса стандартную ошибку и стандартный вывод.
`ProcessBuilder`	`redirectErrorStream(boolean redirectErrorStream)` Наборы этот разработчик процесса `redirectErrorStream` свойство.
`ProcessBuilder. Перенаправление`	`redirectInput()` Возвраты этот входной источник стандарта разработчика процесса.
`ProcessBuilder`	`redirectInput(File file)` Наборы этот входной источник стандарта разработчика процесса к файлу.
`ProcessBuilder`	`redirectInput(ProcessBuilder.Redirect source)` Наборы этот входной источник стандарта разработчика процесса.
`ProcessBuilder. Перенаправление`	`redirectOutput()` Возвраты это место назначения стандартного вывода разработчика процесса.
`ProcessBuilder`	`redirectOutput(File file)` Наборы это место назначения стандартного вывода разработчика процесса к файлу.
`ProcessBuilder`	`redirectOutput(ProcessBuilder.Redirect destination)` Наборы это место назначения стандартного вывода разработчика процесса.
`Процесс`	`start()` Запускает новый процесс, используя атрибуты этого разработчика процесса.

Методы, наследованные от class java.lang. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Деталь конструктора
  - ProcessBuilder
```
public ProcessBuilder(List<String> command)
```
    Создает разработчика процесса с указанной программой операционной системы и параметрами. Этот конструктор не делает копию command список. Последующие обновления к списку будут отражены в состоянии разработчика процесса. Это не проверяется ли command соответствует допустимой команде операционной системы.
    
    Параметры:
    
    command - список, содержащий программу и ее параметры
    
    Броски:
    
    NullPointerException - если параметром является нуль
  - ProcessBuilder
```
public ProcessBuilder(String... command)
```
    Создает разработчика процесса с указанной программой операционной системы и параметрами. Это - конструктор удобства, который устанавливает команду разработчика процесса в строковый список, содержащий те же самые строки как command массив, в том же самом порядке. Это не проверяется ли command соответствует допустимой команде операционной системы.
    
    Параметры:
    
    command - строковый массив, содержащий программу и ее параметры
- Деталь метода
  - команда
```
public ProcessBuilder command(List<String> command)
```
    Наборы эта программа операционной системы разработчика процесса и параметры. Этот метод не делает копию command список. Последующие обновления к списку будут отражены в состоянии разработчика процесса. Это не проверяется ли command соответствует допустимой команде операционной системы.
    
    Параметры:
    
    command - список, содержащий программу и ее параметры
    
    Возвраты:
    
    этот разработчик процесса
    
    Броски:
    
    NullPointerException - если параметром является нуль
  - команда
```
public ProcessBuilder command(String... command)
```
    Наборы эта программа операционной системы разработчика процесса и параметры. Это - метод удобства, который устанавливает команду в строковый список, содержащий те же самые строки как command массив, в том же самом порядке. Это не проверяется ли command соответствует допустимой команде операционной системы.
    
    Параметры:
    
    command - строковый массив, содержащий программу и ее параметры
    
    Возвраты:
    
    этот разработчик процесса
  - команда
```
public List<String> command()
```
    Возвраты эта программа операционной системы разработчика процесса и параметры. Возвращенный список не является копией. Последующие обновления к списку будут отражены в состоянии этого разработчика процесса.
    
    Возвраты:
    
    эта программа разработчика процесса и ее параметры
  - среда
```
public Map<String,String> environment()
```
    Возвращает строковое представление карты этой среды разработчика процесса. Всякий раз, когда разработчик процесса создается, среда инициализируется к копии текущей среды процесса (см. System.getenv()). Подпроцессы впоследствии запускались этим объектом start() метод будет использовать эту карту в качестве их среды.
    Возвращенный объект может быть изменен, используя обычный Map операции. Эти модификации будут видимы к подпроцессам, запущенным через start() метод. Два ProcessBuilder экземпляры всегда содержат независимые среды процесса, так изменения к возвращенной карте никогда не будут отражаться ни в каком другом ProcessBuilder экземпляр или значения, возвращенные System.getenv.
    Если система не поддерживает переменные окружения, пустая карта возвращается.
    Возвращенная карта не разрешает нулевые ключи или значения. Попытка вставить или запросить присутствие нулевого ключа или значения бросит a NullPointerException. Попытка запросить присутствие ключа или значения, которое не имеет типа String бросит a ClassCastException.
    Поведение возвращенной карты системно-зависимо. Система, возможно, не позволяет модификации переменным окружения или может запретить определенные имена переменной или значения. Поэтому попытки изменить карту могут перестать работать с UnsupportedOperationException или IllegalArgumentException если модификация не разрешается операционной системой.
    Так как внешний формат имен переменной окружения и значений системно-зависим, возможно, нет непосредственного отображения между ними и строками Unicode Java. Однако, карта реализуется таким способом, которым у переменных окружения, которые не изменяются кодом Java, будет неизмененное собственное представление в подпроцессе.
    Возвращенная карта и ее представления набора, возможно, не повинуются общему контракту Object.equals(java.lang.Object) и Object.hashCode() методы.
    Возвращенная карта является обычно чувствительной к регистру на всех платформах.
    Если менеджер безопасности существует, checkPermission метод вызывают с a RuntimePermission("getenv.*") разрешение. Это может привести к a SecurityException быть брошенным.
    Передавая информацию к подпроцессу Java, системные свойства обычно предпочитаются по переменным окружения.
    
    Возвраты:
    
    эта среда разработчика процесса
    
    Броски:
    
    SecurityException - если менеджер безопасности существует и checkPermission метод не предоставляет доступ к среде процесса
    
    См. Также:
    
    Runtime.exec(String[],String[],java.io.File), System.getenv()
  - каталог
```
public File directory()
```
    Возвраты рабочий каталог разработчика этого процесса. Подпроцессы впоследствии запускались этим объектом start() метод будет использовать это в качестве их рабочего каталога. Возвращенное значение может быть null - это означает использовать рабочий каталог текущего процесса Java, обычно каталог, названный системным свойством user.dir, как рабочий каталог дочернего процесса.
    
    Возвраты:
    
    рабочий каталог разработчика этого процесса
  - каталог
```
public ProcessBuilder directory(File directory)
```
    Наборы рабочий каталог разработчика этого процесса. Подпроцессы впоследствии запускались этим объектом start() метод будет использовать это в качестве их рабочего каталога. Параметр может быть null - это означает использовать рабочий каталог текущего процесса Java, обычно каталог, названный системным свойством user.dir, как рабочий каталог дочернего процесса.
    
    Параметры:
    
    directory - новый рабочий каталог
    
    Возвраты:
    
    этот разработчик процесса
  - redirectInput
```
public ProcessBuilder redirectInput(ProcessBuilder.Redirect source)
```
    Наборы этот входной источник стандарта разработчика процесса. Подпроцессы впоследствии запускались этим объектом start() метод получает их стандартный ввод из этого источника.
    Если источник Redirect.PIPE (начальное значение), тогда стандартный ввод подпроцесса может быть записан использованию потока вывода, возвращенного Process.getOutputStream(). Если источник устанавливается в любое другое значение, то Process.getOutputStream() возвратит нулевой поток вывода.
    
    Параметры:
    
    source - новый стандартный входной источник
    
    Возвраты:
    
    этот разработчик процесса
    
    Броски:
    
    IllegalArgumentException - если перенаправление не соответствует допустимому источнику данных, то есть, имеет тип WRITE или APPEND
    
    С тех пор:
    
    1.7
  - redirectOutput
```
public ProcessBuilder redirectOutput(ProcessBuilder.Redirect destination)
```
    Наборы это место назначения стандартного вывода разработчика процесса. Подпроцессы впоследствии запускались этим объектом start() метод отправляет их стандартный вывод этому месту назначения.
    Если место назначения Redirect.PIPE (начальное значение), тогда стандартный вывод подпроцесса может быть считан, используя входной поток, возвращенный Process.getInputStream(). Если место назначения устанавливается в любое другое значение, то Process.getInputStream() возвратит нулевой входной поток.
    
    Параметры:
    
    destination - новое место назначения стандартного вывода
    
    Возвраты:
    
    этот разработчик процесса
    
    Броски:
    
    IllegalArgumentException - если перенаправление не соответствует допустимому месту назначения данных, то есть, имеет тип READ
    
    С тех пор:
    
    1.7
  - redirectError
```
public ProcessBuilder redirectError(ProcessBuilder.Redirect destination)
```
    Наборы стандартное ошибочное место назначения разработчика этого процесса. Подпроцессы впоследствии запускались этим объектом start() метод отправляет их стандартную ошибку этому месту назначения.
    Если место назначения Redirect.PIPE (начальное значение), тогда вывод ошибок подпроцесса может быть считан, используя входной поток, возвращенный Process.getErrorStream(). Если место назначения устанавливается в любое другое значение, то Process.getErrorStream() возвратит нулевой входной поток.
    Если redirectErrorStream атрибут был установлен true, тогда перенаправление, установленное этим методом, не имеет никакого эффекта.
    
    Параметры:
    
    destination - новое стандартное ошибочное место назначения
    
    Возвраты:
    
    этот разработчик процесса
    
    Броски:
    
    IllegalArgumentException - если перенаправление не соответствует допустимому месту назначения данных, то есть, имеет тип READ
    
    С тех пор:
    
    1.7
  - redirectInput
```
public ProcessBuilder redirectInput(File file)
```
    Наборы этот входной источник стандарта разработчика процесса к файлу.
    Это - метод удобства. Вызов формы redirectInput(file) ведет себя точно таким же образом как вызов redirectInput (Redirect.from(file)).
    
    Параметры:
    
    file - новый стандартный входной источник
    
    Возвраты:
    
    этот разработчик процесса
    
    С тех пор:
    
    1.7
  - redirectOutput
```
public ProcessBuilder redirectOutput(File file)
```
    Наборы это место назначения стандартного вывода разработчика процесса к файлу.
    Это - метод удобства. Вызов формы redirectOutput(file) ведет себя точно таким же образом как вызов redirectOutput (Redirect.to(file)).
    
    Параметры:
    
    file - новое место назначения стандартного вывода
    
    Возвраты:
    
    этот разработчик процесса
    
    С тех пор:
    
    1.7
  - redirectError
```
public ProcessBuilder redirectError(File file)
```
    Наборы стандартное ошибочное место назначения разработчика этого процесса к файлу.
    Это - метод удобства. Вызов формы redirectError(file) ведет себя точно таким же образом как вызов redirectError (Redirect.to(file)).
    
    Параметры:
    
    file - новое стандартное ошибочное место назначения
    
    Возвраты:
    
    этот разработчик процесса
    
    С тех пор:
    
    1.7
  - redirectInput
```
public ProcessBuilder.Redirect redirectInput()
```
    Возвраты этот входной источник стандарта разработчика процесса. Подпроцессы впоследствии запускались этим объектом start() метод получает их стандартный ввод из этого источника. Начальное значение Redirect.PIPE.
    
    Возвраты:
    
    этот входной источник стандарта разработчика процесса
    
    С тех пор:
    
    1.7
  - redirectOutput
```
public ProcessBuilder.Redirect redirectOutput()
```
    Возвраты это место назначения стандартного вывода разработчика процесса. Подпроцессы впоследствии запускались этим объектом start() перенаправление метода их стандартный вывод этому месту назначения. Начальное значение Redirect.PIPE.
    
    Возвраты:
    
    это место назначения стандартного вывода разработчика процесса
    
    С тех пор:
    
    1.7
  - redirectError
```
public ProcessBuilder.Redirect redirectError()
```
    Возвраты стандартное ошибочное место назначения разработчика этого процесса. Подпроцессы впоследствии запускались этим объектом start() перенаправление метода их стандартная ошибка этому месту назначения. Начальное значение Redirect.PIPE.
    
    Возвраты:
    
    стандартное ошибочное место назначения разработчика этого процесса
    
    С тех пор:
    
    1.7
  - inheritIO
```
public ProcessBuilder inheritIO()
```
    Устанавливает источник и место назначения для ввода-вывода стандарта подпроцесса, чтобы быть тем же самым как таковыми из текущего процесса Java.
    Это - метод удобства. Вызов формы
```
 
 pb.inheritIO()
 
```
    ведет себя точно таким же образом как вызов
```
 
 pb.redirectInput(Redirect.INHERIT)
   .redirectOutput(Redirect.INHERIT)
   .redirectError(Redirect.INHERIT)
 
```
    Это дает поведение, эквивалентное большинству интерпретаторов команд операционной системы, или функции стандартной библиотеки для C system().
    Возвраты:
    
    этот разработчик процесса
    
    С тех пор:
    
    1.7
  - redirectErrorStream
```
public boolean redirectErrorStream()
```
    Говорит, объединяет ли этот разработчик процесса стандартную ошибку и стандартный вывод.
    Если это свойство true, тогда любой вывод ошибок, сгенерированный подпроцессами впоследствии, запускался этим объектом start() метод будет объединен со стандартным выводом, так, чтобы оба могли быть считаны, используя Process.getInputStream() метод. Это облегчает коррелировать сообщения об ошибках с соответствующим выводом. Начальное значение false.
    
    Возвраты:
    
    этот разработчик процесса redirectErrorStream свойство
  - redirectErrorStream
```
public ProcessBuilder redirectErrorStream(boolean redirectErrorStream)
```
    Наборы этот разработчик процесса redirectErrorStream свойство.
    Если это свойство true, тогда любой вывод ошибок, сгенерированный подпроцессами впоследствии, запускался этим объектом start() метод будет объединен со стандартным выводом, так, чтобы оба могли быть считаны, используя Process.getInputStream() метод. Это облегчает коррелировать сообщения об ошибках с соответствующим выводом. Начальное значение false.
    
    Параметры:
    
    redirectErrorStream - новое значение свойства
    
    Возвраты:
    
    этот разработчик процесса
  - запустить
```
public Process start()
              throws IOException
```
    Запускает новый процесс, используя атрибуты этого разработчика процесса.
    Новый процесс вызовет команду и параметры, данные command(), в рабочем каталоге как дано directory(), со средой процесса как дано environment().
    Этот метод проверяет, что команда является допустимой командой операционной системы. То, какие команды допустимы, системно-зависимо, но по крайней мере команда должна быть непустым списком непустых строк.
    Минимальный набор системно-зависимых переменных окружения может быть обязан запускать процесс на некоторых операционных системах. В результате подпроцесс может наследовать дополнительные настройки переменной окружения вне тех в разработчике процесса environment().
    Если есть менеджер безопасности, checkExec метод вызывают с первым компонентом этого объекта command выстройте как его параметр. Это может привести к a SecurityException быть брошенным.
    Запуск процесса операционной системы очень системно-зависим. Среди многих вещей, которые могут пойти не так, как надо:
    - Программный файл операционной системы не был найден.
    - Доступ к программному файлу был лишен.
    - Рабочий каталог не существует.
    В таких случаях будет выдано исключение. Точный характер исключения системно-зависим, но это всегда будет подкласс IOException.
    Последующие модификации этому разработчику процесса не будут влиять на возвращенный Process.
    Возвраты:
    
    новое Process объект для того, чтобы управлять подпроцессом
    
    Броски:
    
    NullPointerException - если элемент списка команд является нулем
    
    IndexOutOfBoundsException - если команда является пустым списком (имеет размер 0)
    SecurityException - если менеджер безопасности существует и
    
    checkExec метод не позволяет создание подпроцесса, или
    стандартный ввод к подпроцессу был перенаправлен от файла и менеджер безопасности checkRead метод отрицает доступ для чтения к файлу, или
    стандартный вывод или стандартная ошибка подпроцесса были перенаправлены к файлу и менеджер безопасности checkWrite метод отрицает доступ для записи к файлу
    IOException - если ошибка ввода-вывода происходит
    
    См. Также:
    
    Runtime.exec(String[], String[], java.io.File)

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92

Класс ProcessBuilder

Вложенная Сводка Класса

Сводка конструктора

Сводка метода

Методы, наследованные от class java.lang. Объект

Деталь конструктора

ProcessBuilder

ProcessBuilder

Деталь метода

команда

команда

команда

среда

каталог

каталог

redirectInput

redirectOutput

redirectError

redirectInput

redirectOutput

redirectError

redirectInput

redirectOutput

redirectError

inheritIO

redirectErrorStream

redirectErrorStream

запустить