IPath 介面

定義

[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

屬性

RegisterAttribute

實作

IJavaObject IJavaPeerable IComparable IIterable IWatchable IDisposable

備註

一個可用於在檔案系統中定位檔案的物件。 它通常會代表系統相關的檔案路徑。

A Path 代表一條階層式路徑，由一連串目錄和檔案名稱元素組成，並以特殊的分隔符或分隔符分隔。 <也可能存在一個 em>根元件</em>，用以識別檔案系統階層結構。 位於目錄階層根節點 em<> 的最遠/em< 的名稱>元素，是檔案或目錄的名稱。 其他名稱元素是目錄名稱。 A Path 可以代表一個根、一個根和一串名稱，或簡單地表示一個或多個名稱元素。 若 A Path 僅包含一個空的名稱元素，則該 路徑被視為空路徑 。 使用 空路徑 存取檔案等同於存取檔案系統的預設目錄。 Path 定義 #getFileName() getFileName了 、 #getParent getParent、 #getRoot getRoot，以及 #subpath subpath 存取路徑組件或其名稱元素子序列的方法。

除了存取路徑的組件外，a Path 也定義 #resolve(Path) resolve 了 和 #resolveSibling(Path) resolveSibling 方法來結合路徑。 #relativize relativize這種方法可以用來構建兩條路徑之間的相對路徑。 路徑可以是 #compareTo compared，並用 #startsWith startsWith 和 #endsWith endsWith 方法相互測試。

此介面擴展 Watchable 介面，使得路由定位的目錄可以包含 #register registered a WatchService 和 目錄中的項目。

<b>警告：</b> 此介面僅供開發自訂檔案系統實作者實作。 未來版本可能會在此介面新增方法。

<h2>存取檔案</h2>

路徑可與類別一起使用 Files ，以操作檔案、目錄及其他類型的檔案。 例如，假設我們想 java.io.BufferedReader 從一個檔案「access.log」讀取文字。 該檔案位於相對於目前工作目錄的「」目錄logs中，並採用 UTF-8 編碼。

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

「互通性」><h2>互通性</h2>

與預設 java.nio.file.spi.FileSystemProvider provider 相關聯的路徑通常與類別互 java.io.File java.io.File 通。 由其他提供者建立的路徑通常不太可能與 所 java.io.File代表的抽象路徑名稱互通。 此java.io.File#toPath toPath方法可用於從物件Path所代表的抽象路徑名稱中取得 ajava.io.File。 所得結果 Path 可用於操作與物件相同的 java.io.File 檔案。 此外，此#toFile toFile方法有助於從 File 的表示String構造 aPath。

<h2>並行</h2>

此介面的實作是不可變且安全，適合多個並行執行緒使用。

在 1.7 版本中加入。

Java 文件 java.nio.file.Path。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。