Класс InvalidPathException

java.nio.file.InvalidPathException

Все реализованные интерфейсы:: Serializable

public class InvalidPathException extends IllegalArgumentException

Непроверяемое исключение, которое выбрасывается, когда строку пути невозможно преобразовать в Path, поскольку строка пути содержит недопустимые символы или является недопустимой по другим причинам, специфичным для файловой системы.

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

1.7

См. также:

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

Конструктор	Описание
`InvalidPathException(String input, String reason)`	Создает экземпляр на основе указанной входной строки и причины.
`InvalidPathException(String input, String reason, int index)`	Создает экземпляр на основе указанной входной строки, причины и индекса ошибки.

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

Модификатор и тип	Метод	Описание
`int`	`getIndex()`	Возвращает индекс позиции во входной строке, в которой произошла ошибка, или `-1`, если эта позиция неизвестна.
`String`	`getInput()`	Возвращает входную строку.
`String`	`getMessage()`	Возвращает строку с описанием ошибки.
`String`	`getReason()`	Возвращает строку с объяснением, почему входная строка была отклонена.

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

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Модификатор и тип	Метод	Описание
`final void`	`addSuppressed(Throwable exception)`	Добавляет указанное исключение к исключениям, подавленным при возникновении этого исключения.
`Throwable`	`fillInStackTrace()`	Заполняет трассировку стека выполнения.
`Throwable`	`getCause()`	Возвращает причину этого исключения или `null`, если причина отсутствует или неизвестна.
`String`	`getLocalizedMessage()`	Создает локализованное описание этого исключения.
`StackTraceElement[]`	`getStackTrace()`	Предоставляет программный доступ к сведениям о трассировке стека, выводимым методом `Throwable.printStackTrace()`.
`final Throwable[]`	`getSuppressed()`	Возвращает массив, содержащий все исключения, которые были подавлены, обычно оператором `try`-with-resources, при возникновении этого исключения.
`Throwable`	`initCause(Throwable cause)`	Инициализирует причину этого исключения указанным значением.
`void`	`printStackTrace()`	Выводит это исключение и его трассировку в стандартный поток ошибок.
`void`	`printStackTrace(PrintStream s)`	Выводит это исключение и его трассировку в указанный поток печати.
`void`	`printStackTrace(PrintWriter s)`	Выводит это исключение и его трассировку в указанный объект PrintWriter.
`void`	`setStackTrace(StackTraceElement[] stackTrace)`	Задает элементы трассировки стека, которые будут возвращаться методом `Throwable.getStackTrace()` и выводиться методами `Throwable.printStackTrace()` и связанными с ними методами.
`String`	`toString()`	Возвращает краткое описание этого исключения.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

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

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

InvalidPathException

public InvalidPathException(String input, String reason, int index)

Создает экземпляр на основе указанной входной строки, причины и индекса ошибки.

Параметры:: input — входная строка; reason — строка с объяснением, почему входная строка была отклонена; index — индекс позиции, в которой произошла ошибка, или -1, если индекс неизвестен
Выбрасывает:: NullPointerException — если входная строка или строка причины равна null; IllegalArgumentException — если индекс ошибки меньше -1

InvalidPathException

public InvalidPathException(String input, String reason)

Создает экземпляр на основе указанной входной строки и причины. Для созданного объекта индекс ошибки будет равен -1.

Параметры:: input — входная строка; reason — строка с объяснением, почему входная строка была отклонена
Выбрасывает:: NullPointerException — если входная строка или строка причины равна null

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

getInput

public String getInput()

Возвращает входную строку.

Возвращает:: входную строку

getReason

public String getReason()

Возвращает строку с объяснением, почему входная строка была отклонена.

Возвращает:: строку с причиной

getIndex

public int getIndex()

Возвращает индекс позиции во входной строке, в которой произошла ошибка, или -1, если эта позиция неизвестна.

Возвращает:: индекс ошибки

getMessage

public String getMessage()

Возвращает строку с описанием ошибки. Результирующая строка состоит из строки причины, за которой следуют двоеточие (':'), пробел и входная строка. Если индекс ошибки задан, после строки причины и перед двоеточием вставляется строка " at index ", за которой следует индекс в десятичной записи.

Переопределяет:: getMessage в классе Throwable
Возвращает:: строку с описанием ошибки

© 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.