compact1, compact2, compact3

java.nio.file

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

Все Суперинтерфейсы:

Сопоставимый <Путь>, Повторяемый <Путь>, Смотрибельный

public interface Path
extends Comparable<Path>, Iterable<Path>, Watchable

Объект, который может использоваться, чтобы определить местоположение файла в файловой системе. Это будет обычно представлять системно-зависимый путь к файлу.

A Path представляет путь, который является иерархическим и составленным из последовательности элементов имени каталога и имени файла, разделенных специальным разделителем или разделителем. Корневой компонент, который идентифицирует иерархию файловой системы, может также присутствовать. Элемент имени, который является самым дальним от корня иерархии каталогов, является именем файла или каталога. Другие элементы имени являются именами каталогов. A Path может представить корень, корень и последовательность имен, или просто один или более элементов имени. A Path как полагают, пустой путь, если он состоит исключительно из одного элемента имени, который пуст. Доступ к файлу, используя пустой путь эквивалентен доступу к каталогу значения по умолчанию файловой системы. Path определяет getFileName, getParent, getRoot, и subpath методы, чтобы получить доступ к компонентам пути или подпоследовательности его элементов имени.

В дополнение к доступу к компонентам пути, a Path также определяет resolve и resolveSibling методы, чтобы объединить пути. relativize метод, который может использоваться, чтобы создать относительный путь между двумя путями. Пути могут быть compared, и протестированный друг против друга, используя startsWith и endsWith методы.

Этот интерфейс расширяется Watchable взаимодействуйте через интерфейс так, чтобы каталог, расположенный путем, мог быть registered с a WatchService и записи в каталоге смотрели.

ПРЕДУПРЕЖДЕНИЕ: Этот интерфейс только предназначается, чтобы быть реализованным теми, которые разрабатывают пользовательские реализации файловой системы. Методы могут быть добавлены к этому интерфейсу в будущих выпусках.

Доступ к Файлам

Пути могут использоваться с Files class, чтобы работать на файлах, каталогах, и других типах файлов. Например, предположите, что мы хотим a BufferedReader считать текст из файла"access.log". Файл располагается в каталоге"logs"относительно текущего рабочего каталога и закодированный UTF-8.

     Path path = FileSystems.getDefault().getPath("logs", "access.log");
     BufferedReader reader = Files.newBufferedReader(path, StandardCharsets.UTF_8);
 

Функциональная совместимость

Пути связались со значением по умолчанию provider являются обычно взаимодействующими с java.io.File class. Пути, создаваемые другими провайдерами, вряд ли будут взаимодействующими с абстрактными путями, представленными java.io.File. toPath метод может использоваться, чтобы получить a Path от абстрактного пути, представленного a java.io.File объект. Получающееся Path может использоваться, чтобы работать на том же самом файле как java.io.File объект. Кроме того, toFile метод полезен, чтобы создать a File от String представление a Path.

Параллелизм

Реализации этого интерфейса являются неизменными и безопасными для использования многократными параллельными потоками.

С тех пор:

1.7

См. Также:

Paths

Сводка метода

Модификатор и Тип	Метод и Описание
int	compareTo(Path other) Сравнивает два абстрактных пути лексикографически.
boolean	endsWith(Path other) Тесты, если этот путь заканчивается данным путем.
boolean	endsWith(String other) Тесты, если этот путь заканчивается a Path, созданный, преобразовывая данную строку пути, точно способом, определенным endsWith(Path) метод.
boolean	equals(Object other) Тесты этот путь для равенства с данным объектом.
Путь	getFileName() Возвращает имя файла или каталога, обозначенного этим путем как a Path объект.
FileSystem	getFileSystem() Возвращает файловую систему, которая создала этот объект.
Путь	getName(int index) Возвращает элемент имени этого пути как a Path объект.
int	getNameCount() Возвращает число элементов имени в пути.
Путь	getParent() Возвращает родительский путь, или null если у этого пути нет родителя.
Путь	getRoot() Возвращает корневой компонент этого пути как a Path объект, или null если у этого пути нет корневого компонента.
int	hashCode() Вычисляет хэш-код для этого пути.
boolean	isAbsolute() Говорит, является ли этот путь абсолютным.
Iterator<Path>	iterator() Возвращает iterator по элементам имени этого пути.
Путь	normalize() Возвращает путь, который является этим путем с избыточными устраненными элементами имени.
WatchKey	register(WatchService watcher, WatchEvent.Kind<?>... events) Регистрирует файл, расположенный этим путем со службой часов.
WatchKey	register(WatchService watcher, WatchEvent.Kind<?>[] events, WatchEvent.Modifier... modifiers) Регистрирует файл, расположенный этим путем со службой часов.
Путь	relativize(Path other) Создает относительный путь между этим путем и данным путем.
Путь	resolve(Path other) Разрешите данный путь против этого пути.
Путь	resolve(String other) Преобразовывает данную строку пути в a Path и решения это против этого Path точно способом, определенным resolve метод.
Путь	resolveSibling(Path other) Разрешает данный путь против этого пути parent путь.
Путь	resolveSibling(String other) Преобразовывает данную строку пути в a Path и решения это против этого пути parent путь точно способом, определенным resolveSibling метод.
boolean	startsWith(Path other) Тесты, если этот путь запускается с данного пути.
boolean	startsWith(String other) Тесты, если этот путь запускается с a Path, созданный, преобразовывая данную строку пути, точно способом, определенным startsWith(Path) метод.
Путь	subpath(int beginIndex, int endIndex) Возвращает родственника Path это - подпоследовательность элементов имени этого пути.
Путь	toAbsolutePath() Возвраты a Path объект, представляющий абсолютный путь этого пути.
Файл	toFile() Возвраты a File объект, представляющий этот путь.
Путь	toRealPath(LinkOption... options) Возвращает реальный путь существующего файла.
Строка	toString() Возвращает строковое представление этого пути.
URI	toUri() Возвращает URI, чтобы представить этот путь.

Методы, наследованные от интерфейса java.lang. Повторяемый

forEach

Деталь метода

getFileSystem

FileSystem getFileSystem()

Возвращает файловую систему, которая создала этот объект.

Возвраты:

файловая система, которая создала этот объект

isAbsolute

boolean isAbsolute()

Говорит, является ли этот путь абсолютным.

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

Возвраты:

true если, и только если, этот путь является абсолютным

getRoot

Path getRoot()

Возвращает корневой компонент этого пути как a Path объект, или null если у этого пути нет корневого компонента.

Возвраты:

путь, представляющий корневой компонент этого пути, или null

getFileName

Path getFileName()

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

Возвраты:

путь, представляющий имя файла или каталога, или null если у этого пути есть нулевые элементы

getParent

Path getParent()

Возвращает родительский путь, или null если у этого пути нет родителя.

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

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

 subpath(0, getNameCount()-1);
 

Возвраты:

путь, представляющий родителя пути

getNameCount

int getNameCount()

Возвращает число элементов имени в пути.

Возвраты:

число элементов в пути, или 0 если этот путь только представляет корневой компонент

getName

Path getName(int index)

Возвращает элемент имени этого пути как a Path объект.

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

Параметры:

index - индексирование элемента

Возвраты:

элемент имени

Броски:

IllegalArgumentException - если index отрицательно, index больше чем или равен числу элементов, или у этого пути есть нулевые элементы имени

подпуть

Path subpath(int beginIndex,
             int endIndex)

Возвращает родственника Path это - подпоследовательность элементов имени этого пути.

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

Параметры:

beginIndex - индексирование первого элемента, включительно

endIndex - индексирование последнего элемента, монопольного

Возвраты:

новое Path объект, который является подпоследовательностью элементов имени в этом Path

Броски:

IllegalArgumentException - если beginIndex отрицательно, или больше чем или равен числу элементов. Если endIndex меньше чем или равно beginIndex, или больше чем число элементов.

startsWith

boolean startsWith(Path other)

Тесты, если этот путь запускается с данного пути.

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

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

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

Параметры:

other - данный путь

Возвраты:

true если этот путь запускается с данного пути; иначе false

startsWith

boolean startsWith(String other)

Тесты, если этот путь запускается с a Path, созданный, преобразовывая данную строку пути, точно способом, определенным startsWith(Path) метод. На UNIX например, путь"foo/bar"запускается с"foo"и"foo/bar". Это не запускается с"f"или"fo".

Параметры:

other - данная строка пути

Возвраты:

true если этот путь запускается с данного пути; иначе false

Броски:

InvalidPathException - Если строка пути не может быть преобразована в Путь.

endsWith

boolean endsWith(Path other)

Тесты, если этот путь заканчивается данным путем.

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

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

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

Параметры:

other - данный путь

Возвраты:

true если этот путь заканчивается данным путем; иначе false

endsWith

boolean endsWith(String other)

Тесты, если этот путь заканчивается a Path, созданный, преобразовывая данную строку пути, точно способом, определенным endsWith(Path) метод. На UNIX например, путь"foo/bar"концы с"foo/bar"и"bar". Это не заканчивается"r"или"/bar". Отметьте, что запаздывающие разделители не принимаются во внимание, и таким образом вызывая этот метод на Path"foo/bar"с String "bar/"возвраты true.

Параметры:

other - данная строка пути

Возвраты:

true если этот путь заканчивается данным путем; иначе false

Броски:

InvalidPathException - Если строка пути не может быть преобразована в Путь.

нормализовать

Path normalize()

Возвращает путь, который является этим путем с избыточными устраненными элементами имени.

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

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

Возвраты:

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

См. Также:

getParent(), toRealPath(java.nio.file.LinkOption...)

решение

Path resolve(Path other)

Разрешите данный путь против этого пути.

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

Параметры:

other - путь, чтобы решить против этого пути

Возвраты:

получающийся путь

См. Также:

relativize(java.nio.file.Path)

решение

Path resolve(String other)

Преобразовывает данную строку пути в a Path и решения это против этого Path точно способом, определенным resolve метод. Например, предположите, что разделитель имени"/"и путь представляет"foo/bar", тогда вызов этого метода с путем представляет в виде строки"gus"приведет к Path "foo/bar/gus".

Параметры:

other - строка пути, чтобы решить против этого пути

Возвраты:

получающийся путь

Броски:

InvalidPathException - если строка пути не может быть преобразована в Путь.

См. Также:

FileSystem.getPath(java.lang.String, java.lang.String...)

resolveSibling

Path resolveSibling(Path other)

Разрешает данный путь против этого пути parent путь. Это полезно, где имя файла должно быть заменено другим именем файла. Например, предположите, что разделитель имени"/"и путь представляет"dir1/dir2/foo", тогда вызывая этот метод с Path "bar"приведет к Path "dir1/dir2/bar". Если у этого пути нет родительского пути, или other absolute, тогда этот метод возвраты other. Если other пустой путь тогда, этот метод возвращает родителя этого пути, или где у этого пути нет родителя, пустого пути.

Параметры:

other - путь, чтобы решить против родителя этого пути

Возвраты:

получающийся путь

См. Также:

resolve(Path)

resolveSibling

Path resolveSibling(String other)

Преобразовывает данную строку пути в a Path и решения это против этого пути parent путь точно способом, определенным resolveSibling метод.

Параметры:

other - строка пути, чтобы решить против родителя этого пути

Возвраты:

получающийся путь

Броски:

InvalidPathException - если строка пути не может быть преобразована в Путь.

См. Также:

FileSystem.getPath(java.lang.String, java.lang.String...)

relativize

Path relativize(Path other)

Создает относительный путь между этим путем и данным путем.

Преобразование абсолютных адресов в относительные является инверсией resolution. Этот метод пытается создать a relative путь это, когда resolved против этого пути, приводит к пути, который определяет местоположение того же самого файла как данный путь. Например, на UNIX, если этот путь "/a/b" и данный путь "/a/b/c/d" тогда получающийся относительный путь был бы "c/d". Где у этого пути и данного пути нет a 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".

Параметры:

other - путь к relativize против этого пути

Возвраты:

получающийся относительный путь, или пустой путь, если оба пути равны

Броски:

IllegalArgumentException - если other не a Path это может быть relativized против этого пути

toUri

URI toUri()

Возвращает URI, чтобы представить этот путь.

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

В случае провайдера значения по умолчанию URI является иерархическим с a path компонент, который является абсолютным. Запрос и компоненты фрагмента неопределены. Определяется ли компонент полномочий или не зависящий от реализации. Нет никакой гарантии что URI может использоваться, чтобы создать a java.io.File. В частности если этот путь представляет Универсальное Соглашение о присвоении имен (ПРОТОКОЛ INTERNET) путь, то имя сервера ПРОТОКОЛА INTERNET может быть закодировано в компоненте полномочий получающегося URI. В случае провайдера значения по умолчанию, и существует файл, и это может быть решено, что файл является каталогом, тогда получающееся URI закончится наклонной чертой.

Провайдер значения по умолчанию обеспечивает подобную гарантию туда и обратно для File class. Для данного Path p этому гарантируют это

Paths.get( p.toUri()).equals(p .toAbsolutePath())

пока оригинал Path, URI, и новое Path все создаются в (возможно различные вызовы) та же самая виртуальная машина Java. Делают ли другие провайдеры какие-либо гарантии, определенный провайдер и поэтому неуказанный.

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

Возвраты:

URI, представляющий этот путь

Броски:

IOError - если ошибка ввода-вывода происходит, получая абсолютный путь, или где файловая система создается, чтобы получить доступ к содержанию файла как файловая система, и URI файловой системы включения не может быть получен

SecurityException - В случае провайдера значения по умолчанию, и менеджера безопасности устанавливается, toAbsolutePath метод выдает исключение безопасности.

toAbsolutePath

Path toAbsolutePath()

Возвраты a Path объект, представляющий абсолютный путь этого пути.

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

Возвраты:

a Path объект, представляющий абсолютный путь

Броски:

IOError - если ошибка ввода-вывода происходит

SecurityException - В случае провайдера значения по умолчанию устанавливается менеджер безопасности, и этот путь не является абсолютным, тогда менеджер безопасности checkPropertyAccess метод вызывается, чтобы проверить доступ к системному свойству user.dir

toRealPath

Path toRealPath(LinkOption... options)
         throws IOException

Возвращает реальный путь существующего файла.

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

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

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

Параметры:

options - опции, указывающие, как обрабатываются символьные ссылки

Возвраты:

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

Броски:

IOException - если файл не существует, или ошибка ввода-вывода происходит

SecurityException - В случае провайдера значения по умолчанию, и менеджера безопасности устанавливается, checkRead метод вызывается, чтобы проверить доступ для чтения к файлу, и где этот путь не является абсолютным, checkPropertyAccess метод вызывается, чтобы проверить доступ к системному свойству user.dir

toFile

File toFile()

Возвраты a File объект, представляющий этот путь. Где это Path связывается с провайдером значения по умолчанию, тогда этот метод эквивалентен возврату a File объект, созданный с String представление этого пути.

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

Возвраты:

a File объект, представляющий этот путь

Броски:

UnsupportedOperationException - если это Path не связывается с провайдером значения по умолчанию

регистр

WatchKey register(WatchService watcher,
                  WatchEvent.Kind<?>[] events,
                  WatchEvent.Modifier... modifiers)
           throws IOException

Регистрирует файл, расположенный этим путем со службой часов.

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

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

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

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

modifiers параметр определяет модификаторы, которые квалифицируют, как каталог регистрируется. Этот выпуск не определяет стандартных модификаторов. Это может содержать реализацию определенные модификаторы.

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

Определенный:

register в интерфейсе Watchable

Параметры:

watcher - служба часов, к которой состоит в том, чтобы быть зарегистрирован этот объект

events - события, для которых должен быть зарегистрирован этот объект

modifiers - модификаторы, если таковые вообще имеются, которые изменяют, как объект регистрируется

Возвраты:

ключ, представляющий регистрацию этого объекта с данной службой часов

Броски:

UnsupportedOperationException - если неподдерживаемые события или модификаторы определяются

IllegalArgumentException - если недопустимая комбинация событий или модификаторов определяется

ClosedWatchServiceException - если служба часов закрывается

NotDirectoryException - если файл регистрируется, чтобы наблюдать записи в каталоге, и файл не является каталогом (дополнительное определенное исключение)

IOException - если ошибка ввода-вывода происходит

SecurityException - В случае провайдера значения по умолчанию, и менеджера безопасности устанавливается, checkRead метод вызывается, чтобы проверить доступ для чтения к файлу.

регистр

WatchKey register(WatchService watcher,
                  WatchEvent.Kind<?>... events)
           throws IOException

Регистрирует файл, расположенный этим путем со службой часов.

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

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

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

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

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

Определенный:

register в интерфейсе Watchable

Параметры:

watcher - Служба часов, к которой состоит в том, чтобы быть зарегистрирован этот объект

events - События, для которых должен быть зарегистрирован этот объект

Возвраты:

Ключ, представляющий регистрацию этого объекта с данной службой часов

Броски:

UnsupportedOperationException - Если неподдерживаемые события определяются

IllegalArgumentException - Если недопустимая комбинация событий определяется

ClosedWatchServiceException - Если служба часов закрывается

NotDirectoryException - Если файл регистрируется, чтобы наблюдать записи в каталоге, и файл не является каталогом (дополнительное определенное исключение)

IOException - Если ошибка ввода-вывода происходит

SecurityException - В случае провайдера значения по умолчанию, и менеджера безопасности устанавливается, checkRead метод вызывается, чтобы проверить доступ для чтения к файлу.

iterator

Iterator<Path> iterator()

Возвращает iterator по элементам имени этого пути.

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

Определенный:

iterator в интерфейсе Iterable<Path>

Возвраты:

iterator по элементам имени этого пути.

compareTo

int compareTo(Path other)

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

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

Определенный:

compareTo в интерфейсе Comparable<Path>

Параметры:

other - путь по сравнению с этим путем.

Возвраты:

обнулите, если параметр equal к этому пути, значение меньше чем нуль, если этот путь является лексикографически меньше чем параметр, или значением, больше чем нуль, если этот путь лексикографически больше чем параметр

Броски:

ClassCastException - если пути связываются с различными провайдерами

равняется

boolean equals(Object other)

Тесты этот путь для равенства с данным объектом.

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

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

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

Переопределения:

equals в class Object

Параметры:

other - объект, с которым состоит в том, чтобы быть сравнен этот объект

Возвраты:

true если, и только если, данный объект является a Path это идентично этому Path

См. Также:

Object.hashCode(), HashMap

хэш-код

int hashCode()

Вычисляет хэш-код для этого пути.

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

Переопределения:

hashCode в class Object

Возвраты:

значение хэш-кода для этого пути

См. Также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

toString

String toString()

Возвращает строковое представление этого пути.

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

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

Переопределения:

toString в class Object

Возвраты:

строковое представление этого пути