Класс 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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация объявлена устаревшей и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного промежутка реального времени.

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

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.