モジュール java.base
パッケージ java.nio.file

クラスPaths


  • public final class Paths
extends Object
    このクラスは、パス文字列またはURIを変換することによってPathを返すstaticメソッドのみで構成されます。
    導入されたバージョン:
    1.7

    • メソッドの詳細

      • get

        public static Path get​(String first,
                       String... more)
        1つのパス文字列または、連結すると1つのパス文字列を形成する文字列のシーケンスを、Pathに変換します。 moreに要素が指定されていない場合は、firstパラメータの値は変換するパス文字列です。 moreに1つ以上の要素が指定されている場合は、空でない各文字列(firstを含む)は名前要素のシーケンスであるとみなされ(Pathを参照)、結合されてパス文字列に形成されます。 文字列の結合方法の詳細はプロバイダ固有ですが、通常は名前区切り文字を区切り文字として使用して結合されます。 たとえば、名前区切り文字が"/"でgetPath("/foo","bar","gus")が呼び出された場合、パス文字列"/foo/bar/gus"はPathに変換されます。 firstが空の文字列でmoreに空でない文字列が含まれない場合は、空のパスを示すPathが返されます。

        Pathを取得するには、デフォルトのFileSystemのgetPathメソッドを呼び出します。

        このメソッドは非常に便利ですが、その使用はデフォルトのFileSystemへの想定された参照を意味し、呼出し元のコードの有用性を限定するものであることに注意してください。 したがって、柔軟性のある再利用を目的としたライブラリ・コードでは使用しないようにしてください。 これに代わるより柔軟な方法は、次のように既存のPathインスタンスをアンカーとして使用することです。 

             Path dir = ...
     Path path = dir.resolve("file");
        パラメータ:
        first - パス文字列またはパス文字列の最初の部分
        more - 結合してパス文字列を形成するための追加文字列
        戻り値:
        結果のPath
        例外:
        InvalidPathException - パス文字列をPathに変換できない場合
        関連項目:
        FileSystem.getPath(java.lang.String, java.lang.String...)

      • get

        public static Path get​(URI uri)
        指定されたURIをPathオブジェクトに変換します。

        このメソッドは、インストールされているプロバイダを反復して、指定されたURIのURI スキームで識別されるプロバイダを検索します。 URIスキームは大文字小文字に関係なく比較されます。 プロバイダが見つかった場合は、そのgetPathメソッドが呼び出されてURIが変換されます。

        「file」というURIスキームで識別されるデフォルト・プロバイダの場合、指定されたURIには空でないパス・コンポーネントと、未定義のクエリーおよびフラグメント・コンポーネントが含まれます。 機関コンポーネントが存在するかどうかは、プラットフォームに固有のものです。 返されるPathはdefaultのファイル・システムに関連付けられます。

        デフォルト・プロバイダは同様のラウンド・トリップの保証をFileクラスに提供します。 Path pが指定された場合は、次が保証されます。

        Paths.get( p . toUri ()).equals( p . toAbsolutePath ())
        オリジナルのPath、URI、および新しい Pathがすべて、同じJava仮想マシンの(おそらく異なる呼び出し)で作成されている限りです。 ほかのプロバイダが保証を行うかどうかはプロバイダによって異なるため、未指定です。
        パラメータ:
        uri - 変換対象のURI
        戻り値:
        結果のPath
        例外:
        IllegalArgumentException - uriパラメータの前提条件が満たされていない場合。 URIの形式はプロバイダに固有のものです。
        FileSystemNotFoundException - URIによって識別されるファイル・システムが存在せず、自動的に作成することもできない場合、またはURIスキーム・コンポーネントによって識別されるプロバイダがインストールされていない場合
        SecurityException - セキュリティ・マネージャがインストールされ、それがファイル・システムへの未指定のアクセス権を拒否する場合