Путь к интерфейсу

Path получается путем вызова метода getPath default FileSystem.

Обратите внимание, что, хотя этот метод очень удобен, его использование подразумевает предполагаемую ссылку на стандартную FileSystem и ограничивает полезность вызывающего кода. Поэтому его не следует использовать в библиотечном коде, предназначенном для гибкого повторного использования. Более гибкая альтернатива – использование существующего экземпляра Path в качестве якоря, например:

    Path dir = ...
    Path path = dir.resolve("file");

Этот метод итерирует по поставщикам installed , чтобы найти поставщика, который идентифицируется схемой URI scheme данного URI. Схемы URI сравниваются без учета регистра. Если поставщик найден, вызывается его метод getPath для преобразования URI.

В случае стандартного поставщика, идентифицированного схемой URI "file", у данного URI есть компонент пути, а компоненты запроса и фрагмента не определены. Наличие компонента власти зависит от платформы. Возвращаемый Path ассоциирован с файловой системой default.

Стандартный поставщик обеспечивает гарантию обратного преобразования, аналогичную классу File. Для данного Path p гарантируется, что

Path.of(p.toUri()).equals( p.toAbsolutePath())

Абсолютный путь является полным, поскольку для его определения не требуется объединение с другой информацией о пути.

Родитель этого пути состоит из корневой части этого пути, если она есть, и каждого элемента в пути, кроме последнего от корня в иерархии каталогов. Этот метод не обращается к файловой системе; путь или его родитель могут отсутствовать. Кроме того, этот метод не устраняет специальные имена, такие как "." и "..", которые могут использоваться в некоторых реализациях. Например, в UNIX родитель "/a/b/c" – это "/a/b", а родитель "x/y/. – это "x/y". Этот метод может использоваться с методом normalize для устранения дублирующихся имён в тех случаях, когда требуется подобный оболочке способ навигации.

Если у этого пути более одного элемента и нет корневой части, то этот метод эквивалентен вычислению выражения:

    subpath(0, getNameCount()-1);

Параметр index – это индекс элемента имени для возврата. Элемент, наиболее близкий к корню в иерархии каталогов, имеет индекс 0. Элемент, наиболее удаленный от корня, имеет индекс count-1.

Параметры beginIndex и endIndex определяют подпоследовательность элементов имени. Элемент, наиболее близкий к корню в иерархии каталогов, имеет индекс 0. Элемент, наиболее удаленный от корня, имеет индекс count-1. Возвращаемый объект Path содержит элементы имени, начинающиеся с beginIndex и заканчивающиеся элементом с индексом endIndex-1.

Этот путь начинается с заданного пути, если корневая компонента этого пути начинается с корневой компоненты заданного пути, и этот путь начинается с тех же элементов имени, что и заданный путь. Если заданный путь имеет больше элементов имени, чем этот путь, то false возвращается.

Влияет ли корневая компонента этого пути на корневую компоненту заданного пути, зависит от файловой системы. Если у этого пути нет корневой компоненты, а у заданного пути есть корневая компонента, то этот путь не начинается с заданного пути.

Если заданный путь связан с другой FileSystem этим путём, то false возвращается.

Если заданный путь имеет N элементов и не имеет корневой компоненты, а этот путь имеет N или более элементов, то этот путь заканчивается заданным путём, если последние N элементов каждого пути, начиная с элемента, наиболее удалённого от корня, равны.

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

Если заданный путь связан с другой FileSystem этим путём, то false возвращается.

Точное определение этого метода зависит от реализации, но в общем случае он выводится из этого пути, пути, не содержащего избыточных элементов имени. Во многих файловых системах "." и ".." — это специальные имена, используемые для обозначения текущей и родительской директорий. В таких файловых системах все вхождения "." считаются избыточными. Если ".." предшествует имя, отличное от "..", то оба имени считаются избыточными (процесс идентификации таких имён повторяется до тех пор, пока он больше не применим).

Этот метод не обращается к файловой системе; путь может не указывать на существующий файл. Удаление ".." и предшествующего имени из пути может привести к тому, что путь будет указывать на другой файл, чем исходный путь. Это может произойти, когда предшествующее имя — символическая ссылка.

Если параметр other является absolute путём, то этот метод тривиально возвращает other. Если other является пустым путём, то этот метод тривиально возвращает этот путь. В противном случае этот метод рассматривает этот путь как директорию и разрешает заданный путь относительно этого пути. В самом простом случае заданный путь не имеет компоненты root, в этом случае этот метод соединяет заданный путь с этим путём и возвращает результирующий путь, который ends заданным путём. В случае, если заданный путь имеет корневую компоненту, разрешение сильно зависит от реализации и поэтому не определено.

Относительный путь является обратным resolution. Этот метод пытается построить relative путь, который при resolved относительно этого пути, даёт путь, указывающий на тот же файл, что и заданный путь. Например, в UNIX, если этот путь "/a/b" , а заданный путь "/a/b/c/d" , то результирующий относительный путь будет "c/d". Когда этот путь и заданный путь не имеют компонента root, тогда можно построить относительный путь. Относительный путь нельзя построить, если у одного из путей есть компонент корня. Когда у обоих путей есть компонент корня, то построение относительного пути зависит от реализации. Если этот путь и заданный путь equal, то возвращается пустой путь.

Для любых двух normalized путей p и q, где q не имеет компонента корня,

p.relativize(p .resolve(q)).equals(q)

При поддержке символических ссылок, то независимо от реализации, результирующий путь, при разрешении относительно этого пути, даёт путь, который можно использовать для поиска same файла, как other . Например, если этот путь "/a/b" , а заданный путь "/a/x" , то результирующий относительный путь может быть "../x". Если "b" является символической ссылкой, тогда зависит от реализации, будет ли "a/b/../x" указывать на тот же файл, что и "/a/x".

Этот метод строит абсолютный URI с scheme, равным схеме URI, которая идентифицирует поставщик. Точная форма схемы зависита от поставщика.

В случае с типом по умолчанию, URI иерархический с path компонентом, который абсолютен. Компоненты запроса и фрагмента не определены. Определённость компонента авторитета зависит от реализации. Нет гарантии, что URI может быть использован для построения java.io.File. В частности, если этот путь представляет собой UNC-путь, то имя UNC-сервера может быть закодировано в компоненте авторитета результирующего URI. В случае по умолчанию, и файл существует, и можно определить, что файл является каталогом, то результирующий URI заканчивается косой чертой.

Поставщик по умолчанию предоставляет аналогичную гарантию «обратного хода» классу File. Для данного Path p гарантируется, что

Path.of(p.toUri()).equals(p .toAbsolutePath())

Когда файловая система создаётся для доступа к содержимому файла как к файловой системе, то высоко зависит от реализации, представляет ли возвращённый URI заданный путь в файловой системе, или он представляет собой составной URI, который кодирует URI содержащей файловой системы. Формат составных URI не определён в этом выпуске; такая схема может быть добавлена в будущих выпусках.

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

Точное определение этого метода зависит от реализации, но в общем случае он выводится из этого пути, absolute путь, который указывает на same файл, как этот путь, но с именами элементов, которые представляют фактические имена каталогов и файла. Например, где сравнение имён файлов в файловой системе не учитывает регистр, то элементы имени представляют имена в их фактическом регистре. Кроме того, результирующий путь удаляет избыточные элементы имени.

Если этот путь относительный, то его абсолютный путь сначала получается, как если бы был вызван метод toAbsolutePath.

Массив options может быть использован для указания того, как обрабатываются символические ссылки. По умолчанию символические ссылки разрешаются до их конечной цели. Если опция NOFOLLOW_LINKS присутствует, то этот метод не разрешает символические ссылки. Некоторые реализации позволяют специальные имена, такие как "..", для ссылки на родительский каталог. При выводе действительного пути и «..» (или эквивалент) предшествует имени, которое не является «..», то реализация обычно заставит удалить оба имени. Когда не разрешаются символические ссылки, а предшествующее имя является символической ссылкой, то имена удаляются только в том случае, если гарантируется, что результирующий путь будет указывать на тот же файл, что и этот путь.

Если этот путь был создан вызовом метода File toPath, то нет гарантии, что объект File , возвращённый этим методом, equal исходному объекту File.

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

• ENTRY_CREATE - элемент создан или перемещен в каталог
• ENTRY_DELETE - элемент удален или перемещен из каталога
• ENTRY_MODIFY - элемент в каталоге был изменен

context для этих событий — это относительный путь между каталогом, указанным этим путем, и путем, указывающим на элемент каталога, который был создан, удален или изменен.

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

Параметр modifiers определяет модификаторы, которые уточняют, как регистрируется каталог. В этом выпуске не определены никакие стандартные модификаторы. Он может содержать модификаторы, специфичные для реализации.

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

Вызов этого метода ведет себя точно так же, как вызов

    register(watcher, events, new WatchEvent.Modifier[0]);

Пример использования: Предположим, что мы хотим зарегистрировать каталог для событий создания, удаления и изменения элементов:

    Path dir = ...
    WatchService watcher = ...

    WatchKey key = dir.register(watcher, ENTRY_CREATE, ENTRY_DELETE, ENTRY_MODIFY);

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

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

Если данный объект не является Path или является Path, связанным с другим поставщиком FileSystem, тогда этот метод возвращает false.

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

Этот метод удовлетворяет общему контракту метода Object.equals.

Хэш-код основан на компонентах пути и удовлетворяет общему контракту метода Object.hashCode.

Если этот путь был создан путем преобразования строки пути с помощью метода getPath, то строка пути, возвращаемая этим методом, может отличаться от исходной строки, используемой для создания пути.

Возвращаемая строка пути использует разделитель имен по умолчанию separator для разделения имен в пути.