Класс Paths
- java.lang.Object
-
- java.nio.file.Paths
public final class Paths extends Object
Этот класс состоит исключительно из статических методов, которые возвращают Path, преобразуя строку пути или URI.
- Since:
- 1.7
Методы
| Модификатор и тип | Метод и описание |
|---|---|
static Path |
get(String first,
String... more)
Преобразует строку пути или последовательность строк, которые при объединении образуют строку пути, в |
static Path |
get(URI uri)
Преобразует заданный URI в объект |
Методы, унаследованные от класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Методы
get
public static Path get(String first,
String... more)
Преобразует строку пути или последовательность строк, которые при объединении образуют строку пути, в Path. Если more не указывает каких-либо элементов, то значение параметра first является строкой пути для преобразования. Если more указывает один или несколько элементов, то каждая непустая строка, включая first, рассматривается как последовательность элементов имени (см. Path) и объединяется в строку пути. Подробности о том, как строки объединяются, зависят от поставщика, но обычно они будут объединены с использованием name-separator в качестве разделителя. Например, если разделитель имен равен "/", и вызывается getPath("/foo","bar","gus"), то строка пути "/foo/bar/gus" преобразуется в Path. Path, представляющий пустой путь, возвращается, если first — это пустая строка, а more не содержит непустых строк.
Полученный Path получается путем вызова метода getPath объекта default FileSystem.
Обратите внимание, что, хотя этот метод очень удобен, его использование подразумевает предполагаемую ссылку на стандартный FileSystem и ограничивает полезность вызывающего кода. Поэтому его не следует использовать в библиотечном коде, предназначенном для гибкого повторного использования. Более гибкой альтернативой является использование существующего объекта Path в качестве якоря, например:
Path dir = ...
Path path = dir.resolve("file");
- Parameters:
-
first- строка пути или начальная часть строки пути -
more- дополнительные строки, которые должны быть объединены в строку пути - Returns:
- результирующий
Path - Throws:
-
InvalidPathException- если строка пути не может быть преобразована вPath - See Also:
FileSystem.getPath(java.lang.String, java.lang.String...)
get
public static Path get(URI uri)
Преобразует заданный URI в объект Path.
Этот метод итерирует по поставщикам installed, чтобы найти поставщика, который идентифицируется схемой URI scheme данного URI. Схемы URI сравниваются без учета регистра. Если поставщик найден, вызывается его метод getPath для преобразования URI.
В случае с предустановленным поставщиком, идентифицируемым схемой URI «file», у заданного URI есть ненулевой компонент пути, и не определены компоненты запроса и фрагмента. Наличие компонента власти зависит от платформы. Возвращаемый Path связан с файловой системой default.
Предустановленный поставщик предоставляет аналогичную гарантию повторного преобразования классу File. Для данного Path p гарантируется, что
Paths.get(p.toUri()).equals( p.toAbsolutePath())
пока исходный Path, URI, и новый Path все созданы в (возможно, разных вызовах) одной виртуальной машине Java. Гарантии других поставщиков зависят от конкретного поставщика и поэтому не определены.
- Parameters:
-
uri- URI для преобразования - Returns:
- результирующий
Path - Throws:
-
IllegalArgumentException- если условия предварительной обработки для параметраuriне выполняются. Формат URI зависит от поставщика. -
FileSystemNotFoundException- Файловая система, идентифицированная URI, не существует и не может быть автоматически создана, или поставщик, идентифицированный схемой компонента URI, не установлен. -
SecurityException- если установлен менеджер безопасности, и он запрещает неопределенный доступ к файловой системе.
© 1993, 2020, 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.