Класс ProcessBuilder

Возвращенный объект можно изменять с помощью обычных операций Map. Эти изменения будут видны дочерним процессам, запущенным методом start(). Экземпляры ProcessBuilder всегда содержат независимые среды процессов, поэтому изменения возвращенной карты никогда не будут отражены ни в каком другом экземпляре ProcessBuilder или в значениях, возвращаемых методом System.getenv.

Если система не поддерживает переменные среды, возвращается пустая карта.

Возвращенная карта не допускает ключи или значения, равные null. Попытка вставить ключ или значение null либо проверить их наличие приведет к выбросу исключения NullPointerException. Попытка проверить наличие ключа или значения, тип которого не является String, приведет к выбросу исключения ClassCastException.

Поведение возвращенной карты зависит от системы. Система может не разрешать изменять переменные среды или может запрещать определенные имена переменных или значения. Поэтому попытки изменить карту могут завершиться исключениями UnsupportedOperationException или IllegalArgumentException, если операционная система не допускает такое изменение.

Поскольку внешний формат имен и значений переменных среды зависит от системы, между ними и строками Unicode в Java может не быть взаимно однозначного соответствия. Тем не менее карта реализована так, что переменные среды, не измененные кодом Java, будут иметь в дочернем процессе неизмененное нативное представление.

Возвращенная карта и ее представления коллекций могут не соответствовать общему контракту методов Object.equals(Object) и Object.hashCode().

На большинстве платформ возвращенная карта, как правило, чувствительна к регистру.

При передаче информации дочернему процессу Java обычно предпочтительнее использовать системные свойства, а не переменные среды.

Если источником является Redirect.PIPE (начальное значение), то в стандартный ввод дочернего процесса можно записывать через выходной поток, возвращаемый методом Process.getOutputStream(). Если источнику задано любое другое значение, метод Process.getOutputStream() вернет выходной поток null.

Если назначением является Redirect.PIPE (начальное значение), то стандартный вывод дочернего процесса можно считывать через входной поток, возвращаемый методом Process.getInputStream(). Если назначению задано любое другое значение, метод Process.getInputStream() вернет входной поток null.

Если назначением является Redirect.PIPE (начальное значение), то вывод ошибок дочернего процесса можно считывать через входной поток, возвращаемый методом Process.getErrorStream(). Если назначению задано любое другое значение, метод Process.getErrorStream() вернет входной поток null.

Если свойству redirectErrorStream задано значение true, перенаправление, заданное этим методом, не действует.

Это удобный метод. Вызов вида redirectInput(file) действует точно так же, как вызов redirectInput (Redirect.from(file)).

Это удобный метод. Вызов вида redirectOutput(file) действует точно так же, как вызов redirectOutput (Redirect.to(file)).

Это удобный метод. Вызов вида redirectError(file) действует точно так же, как вызов redirectError (Redirect.to(file)).

Это удобный метод. Вызов вида

     pb.inheritIO()

     pb.redirectInput(Redirect.INHERIT)
         .redirectOutput(Redirect.INHERIT)
         .redirectError(Redirect.INHERIT)

Если этому свойству задано значение true, то любой вывод ошибок, созданный впоследствии дочерними процессами, запущенными методом start() этого объекта, будет объединен со стандартным выводом, и оба потока можно будет считывать методом Process.getInputStream(). Это упрощает сопоставление сообщений об ошибках с соответствующим выводом. Начальное значение — false.

Если этому свойству задано значение true, то любой вывод ошибок, созданный впоследствии дочерними процессами, запущенными методом start() этого объекта, будет объединен со стандартным выводом, и оба потока можно будет считывать методом Process.getInputStream(). Это упрощает сопоставление сообщений об ошибках с соответствующим выводом. Начальное значение — false.

Новый процесс выполнит команду и аргументы, заданные методом command(), в рабочем каталоге, заданном методом directory(), и со средой процесса, заданной методом environment().

Этот метод проверяет, является ли команда допустимой командой операционной системы. Набор допустимых команд зависит от системы, но как минимум команда должна быть непустым списком строк, не содержащих null.

В некоторых операционных системах для запуска процесса может требоваться минимальный набор зависящих от системы переменных среды. В результате дочерний процесс может унаследовать дополнительные параметры переменных среды помимо указанных в environment() построителя процессов. Минимальный набор зависящих от системы переменных среды может переопределять значения, заданные в среде.

Запуск процесса операционной системы в значительной степени зависит от системы. Среди множества возможных проблем:

• Не найден файл программы операционной системы.
• Доступ к файлу программы запрещен.
• Рабочий каталог не существует.
• В аргументе команды содержится недопустимый символ, например NUL.

В таких случаях будет выброшено исключение. Точный тип исключения зависит от системы, но оно всегда будет подклассом IOException.

Если операционная система не поддерживает создание процессов, будет выброшено исключение UnsupportedOperationException.

Последующие изменения этого построителя процессов не повлияют на возвращенный объект Process.

Потоки ввода и вывода между промежуточными процессами недоступны. Метод standard input всех процессов, кроме первого, возвращает выходные потоки null. Метод standard output всех процессов, кроме последнего, возвращает входные потоки null.

Свойство redirectErrorStream() каждого объекта ProcessBuilder применяется к соответствующему процессу. Если ему задано значение true, поток ошибок записывается в тот же поток, что и стандартный вывод.

Если при запуске любого из процессов возникает исключение, все процессы принудительно завершаются.

Метод startPipeline выполняет для каждого объекта ProcessBuilder те же проверки, что и метод start(). Каждый новый процесс выполняет команду и аргументы, заданные методом command() соответствующего построителя процессов, в рабочем каталоге, заданном его методом directory(), и со средой процесса, заданной его методом environment().

Команда каждого построителя процессов проверяется на допустимость для операционной системы. Набор допустимых команд зависит от системы, но как минимум команда должна быть непустым списком строк, не содержащих null.

В некоторых операционных системах для запуска процесса может требоваться минимальный набор зависящих от системы переменных среды. В результате дочерний процесс может унаследовать дополнительные параметры переменных среды помимо указанных в environment() построителя процессов. Минимальный набор зависящих от системы переменных среды может переопределять значения, заданные в среде.

Запуск процесса операционной системы в значительной степени зависит от системы. Среди множества возможных проблем:

• Не найден файл программы операционной системы.
• Доступ к файлу программы запрещен.
• Рабочий каталог не существует.
• В аргументе команды содержится недопустимый символ, например NUL.

В таких случаях будет выброшено исключение. Точный тип исключения зависит от системы, но оно всегда будет подклассом IOException.

Если операционная система не поддерживает создание процессов, будет выброшено исключение UnsupportedOperationException.

Последующие изменения любых указанных построителей не повлияют на возвращенный объект Process.