IPath Interface

Definição

[Android.Runtime.Register("java/nio/file/Path", "", "Java.Nio.FileNio.IPathInvoker", ApiSince=26)]
public interface IPath : IDisposable, Java.Interop.IJavaPeerable, Java.Lang.IComparable, Java.Lang.IIterable, Java.Nio.FileNio.IWatchable

[<Android.Runtime.Register("java/nio/file/Path", "", "Java.Nio.FileNio.IPathInvoker", ApiSince=26)>]
type IPath = interface
    interface IComparable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IIterable
    interface IWatchable

Atributos

RegisterAttribute

Implementações

IJavaObject IJavaPeerable IComparable IIterable IWatchable IDisposable

Comentários

Um objeto que pode ser usado para localizar um arquivo em um sistema de arquivos. Normalmente, ele representará um caminho de arquivo dependente do sistema.

Um Path representa um caminho hierárquico e composto por uma sequência de elementos de diretório e nome de arquivo separados por um separador ou delimitador especial. >Um <componente</em> raiz em, que identifica uma hierarquia do sistema de arquivos, também pode estar presente. O elemento de nome que está <em>farthest</em> da raiz da hierarquia de diretório é o nome de um arquivo ou diretório. Os outros elementos de nome são nomes de diretório. Uma Path pode representar uma raiz, uma raiz e uma sequência de nomes ou simplesmente um ou mais elementos de nome. Um Path é considerado um caminho vazio se ele consiste apenas em um elemento de nome que está vazio. Acessar um arquivo usando um caminho vazio é equivalente a acessar o diretório padrão do sistema de arquivos. Pathdefine os #getFileName() getFileNamemétodos, #getParent getParente #getRoot getRoot#subpath subpath os métodos para acessar os componentes de caminho ou uma subsequência de seus elementos de nome.

Além de acessar os componentes de um caminho, também Path define os métodos e #resolveSibling(Path) resolveSibling os #resolve(Path) resolve métodos para combinar caminhos. O #relativize relativize método que pode ser usado para construir um caminho relativo entre dois caminhos. Os caminhos podem ser #compareTo comparede testados uns contra os outros usando os métodos e #endsWith endsWith os #startsWith startsWith métodos.

Essa interface estende a Watchable interface para que um diretório localizado por um caminho possa estar #register registered com um WatchService e entradas no diretório observado.

<b>AVISO:</b> Essa interface destina-se apenas a ser implementada por aqueles que desenvolvem implementações personalizadas do sistema de arquivos. Os métodos podem ser adicionados a essa interface em versões futuras.

<h2>Acessando arquivos</h2>

Os caminhos podem ser usados com a Files classe para operar em arquivos, diretórios e outros tipos de arquivos. Por exemplo, suponha que queremos ler o java.io.BufferedReader texto de um arquivo "access.log". O arquivo está localizado em um diretório "logs" relativo ao diretório de trabalho atual e é codificado em UTF-8.

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

"interoperabilidade"><h2>Interoperabilidade</h2>

Os caminhos associados ao padrão java.nio.file.spi.FileSystemProvider provider geralmente são interoperáveis com a java.io.File java.io.File classe. É improvável que os caminhos criados por outros provedores sejam interoperáveis com os nomes de caminho abstrato representados por java.io.File. O java.io.File#toPath toPath método pode ser usado para obter um Path nome de caminho abstrato representado por um java.io.File objeto. O resultado Path pode ser usado para operar no mesmo arquivo que o java.io.File objeto. Além disso, o #toFile toFile método é útil para construir uma File a partir da String representação de um Path.

<h2>Simultaneidade</h2>

As implementações dessa interface são imutáveis e seguras para uso por vários threads simultâneos.

Adicionado em 1.7.

Java documentação para java.nio.file.Path.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.