Класс ProcessBuilder.Redirect

java.lang.Object

java.lang.ProcessBuilder.Redirect

Внешний класс:: ProcessBuilder

public abstract static class ProcessBuilder.Redirect extends Object

Представляет источник ввода дочернего процесса или назначение вывода дочернего процесса. Каждый экземпляр Redirect является одним из следующих вариантов:

специальное значение Redirect.PIPE
специальное значение Redirect.INHERIT
специальное значение Redirect.DISCARD
перенаправление для чтения из файла, созданное вызовом Redirect.from(File)
перенаправление для записи в файл, созданное вызовом Redirect.to(File)
перенаправление для добавления в файл, созданное вызовом Redirect.appendTo(File)

Каждой из перечисленных выше категорий соответствует уникальный тип Type.

Начиная с версии:: 1.7

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`static enum`	`ProcessBuilder.Redirect.Type`	Тип `ProcessBuilder.Redirect`.

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final ProcessBuilder.Redirect`	`DISCARD`	Указывает, что вывод дочернего процесса будет отброшен.
`static final ProcessBuilder.Redirect`	`INHERIT`	Указывает, что источник или назначение ввода-вывода дочернего процесса будет тем же, что и у текущего процесса.
`static final ProcessBuilder.Redirect`	`PIPE`	Указывает, что ввод-вывод дочернего процесса будет связан с текущим процессом Java через канал.

Краткое описание методов

Модификатор и тип	Метод	Описание
`static ProcessBuilder.Redirect`	`appendTo(File file)`	Возвращает перенаправление для добавления данных в указанный файл.
`boolean`	`equals(Object obj)`	Сравнивает указанный объект с этим `Redirect` на равенство.
`File`	`file()`	Возвращает источник или назначение `File`, связанный с этим перенаправлением, или `null`, если такого файла нет.
`static ProcessBuilder.Redirect`	`from(File file)`	Возвращает перенаправление для чтения из указанного файла.
`int`	`hashCode()`	Возвращает хеш-код этого `Redirect`.
`static ProcessBuilder.Redirect`	`to(File file)`	Возвращает перенаправление для записи в указанный файл.
`abstract ProcessBuilder.Redirect.Type`	`type()`	Возвращает тип этого `Redirect`.

Методы, объявленные в классе Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Подробное описание полей

PIPE

public static final ProcessBuilder.Redirect PIPE

Указывает, что ввод-вывод дочернего процесса будет связан с текущим процессом Java через канал. Это способ обработки стандартного ввода-вывода дочернего процесса по умолчанию.

Всегда будет верно, что

    Redirect.PIPE.file() == null &&
    Redirect.PIPE.type() == Redirect.Type.PIPE

INHERIT

public static final ProcessBuilder.Redirect INHERIT

Указывает, что источник или назначение ввода-вывода дочернего процесса будет тем же, что и у текущего процесса. Это обычное поведение большинства интерпретаторов команд операционной системы (оболочек).

Всегда будет верно, что

    Redirect.INHERIT.file() == null &&
    Redirect.INHERIT.type() == Redirect.Type.INHERIT

DISCARD

public static final ProcessBuilder.Redirect DISCARD

Указывает, что вывод дочернего процесса будет отброшен. Типичная реализация отбрасывает вывод, записывая его в зависящий от операционной системы «пустой файл».

Всегда будет верно, что

    Redirect.DISCARD.file() != null && // is the filename appropriate for the operating system
    Redirect.DISCARD.type() == Redirect.Type.WRITE;

Начиная с версии:: 9

Подробное описание методов

type

public abstract ProcessBuilder.Redirect.Type type()

Возвращает тип этого Redirect.

Возвращает:: тип этого Redirect

file

public File file()

Возвращает источник или назначение File, связанный с этим перенаправлением, или null, если такого файла нет.

Возвращает:: файл, связанный с этим перенаправлением, или null, если такого файла нет

from

public static ProcessBuilder.Redirect from(File file)

Возвращает перенаправление для чтения из указанного файла.

Всегда будет верно, что

    Redirect.from(file).file() == file &&
    Redirect.from(file).type() == Redirect.Type.READ

Параметры:: file — File для Redirect.
Возвращает:: перенаправление для чтения из указанного файла

to

public static ProcessBuilder.Redirect to(File file)

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

Всегда будет верно, что

    Redirect.to(file).file() == file &&
    Redirect.to(file).type() == Redirect.Type.WRITE

Параметры:: file — File для Redirect.
Возвращает:: перенаправление для записи в указанный файл

appendTo

public static ProcessBuilder.Redirect appendTo(File file)

Возвращает перенаправление для добавления данных в указанный файл. Каждая операция записи сначала перемещает позицию в конец файла, а затем записывает запрошенные данные. Выполняются ли перемещение позиции и запись данных одной атомарной операцией, зависит от системы и потому не определено.

Всегда будет верно, что

    Redirect.appendTo(file).file() == file &&
    Redirect.appendTo(file).type() == Redirect.Type.APPEND

Параметры:: file — File для Redirect.
Возвращает:: перенаправление для добавления данных в указанный файл

equals

public boolean equals(Object obj)

Сравнивает указанный объект с этим Redirect на равенство. Возвращает true тогда и только тогда, когда два объекта идентичны либо оба объекта являются экземплярами Redirect одного и того же типа, связанными с ненулевыми равными экземплярами File.

Переопределяет:

equals в классе Object

Параметры:

obj — объект-ссылка, с которым выполняется сравнение.

Возвращает:

true, если этот объект совпадает с аргументом obj; в противном случае — false.

См. также:

hashCode

public int hashCode()

Возвращает хеш-код этого Redirect.

Переопределяет:

hashCode в классе Object

Возвращает:

хеш-код этого Redirect

См. также:

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/lang/ProcessBuilder.Redirect.html