java.nio.file

クラス Paths

java.lang.Object

java.nio.file.Paths

public final class Paths
extends Object

このクラスは、パス文字列または URI を変換することによって Path を返す static メソッドのみで構成されます。

導入されたバージョン:

1.7

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
static Path	get(String first, String... more) 1 つのパス文字列または、連結すると 1 つのパス文字列を形成する文字列のシーケンスを、Path に変換します。
static Path	get(URI uri) 指定された URI を Path オブジェクトに変換します。

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

メソッドの詳細

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 を取得するには、default 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 - セキュリティーマネージャーがインストールされ、それがファイルシステムへの未指定のアクセス権を拒否する場合