java.nio.file

Class Paths

java.lang.Object

java.nio.file.Paths

public final class Paths
extends Object

This class consists exclusively of static methods that return a Path by converting a path string.

Since:

1.7, CLDC1.8

Method Summary

Methods

Modifier and Type	Method and Description
static Path	get(String first, String... more) Converts a path string, or a sequence of strings that when joined form a path string, to a Path.

Methods inherited from class java.lang.Object

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

Method Detail

get

public static Path get(String first,
       String... more)

Converts a path string, or a sequence of strings that when joined form a path string, to a Path. If more does not specify any elements then the value of the first parameter is the path string to convert. If more specifies one or more elements then each non-empty string, including first, is considered to be a sequence of name elements (see Path) and is joined to form a path string. The details as to how the Strings are joined is provider specific but typically they will be joined using the name-separator as the separator. For example, if the name separator is "/" and getPath("/foo","bar","gus") is invoked, then the path string "/foo/bar/gus" is converted to a Path. A Path representing an empty path is returned if first is the empty string and more does not contain any non-empty strings.

The Path is obtained by invoking the getPath method of the default FileSystem.

Note that while this method is very convenient, using it will imply an assumed reference to the default FileSystem and limit the utility of the calling code. Hence it should not be used in library code intended for flexible reuse. A more flexible alternative is to use an existing Path instance as an anchor, such as:

     Path dir = ...
     Path path = dir.resolve("file");
 

Parameters:

first - the path string or initial part of the path string

more - additional strings to be joined to form the path string

Returns:

the resulting Path

Throws:

InvalidPathException - if the path string cannot be converted to a Path

See Also:

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