Movatterモバイル変換

public final classPathsextendsObject

Since:

1.7

• Method Summary

  All Methods Static Methods Concrete Methods 

  Modifier and Type	Method	Description
  staticPath	get(String first,String... more)	Converts a path string, or a sequence of strings that when joined form a path string, to aPath.
  staticPath	get(URI uri)	Converts the given URI to aPath object.

  • Methods inherited from class java.lang.Object

    clone,equals,finalize,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 aPath. Ifmore does not specify any elements then the value of thefirst parameter is the path string to convert. Ifmore specifies one or more elements then each non-empty string, includingfirst, is considered to be a sequence of name elements (seePath) 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 thename-separator as the separator. For example, if the name separator is "/" andgetPath("/foo","bar","gus") is invoked, then the path string"/foo/bar/gus" is converted to aPath. APath representing an empty path is returned iffirst is the empty string andmore does not contain any non-empty strings.

    ThePath is obtained by invoking thegetPath method of thedefaultFileSystem.

    Note that while this method is very convenient, using it will imply an assumed reference to the defaultFileSystem 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 existingPath 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 resultingPath

    Throws:

    InvalidPathException - if the path string cannot be converted to aPath

    See Also:

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

  • get

    public static Path get(URI uri)

    Converts the given URI to aPath object.

    This method iterates over theinstalled providers to locate the provider that is identified by the URIscheme of the given URI. URI schemes are compared without regard to case. If the provider is found then itsgetPath method is invoked to convert the URI.

    In the case of the default provider, identified by the URI scheme "file", the given URI has a non-empty path component, and undefined query and fragment components. Whether the authority component may be present is platform specific. The returnedPath is associated with thedefault file system.

    The default provider provides a similarround-trip guarantee to theFile class. For a givenPathp it is guaranteed that

    Paths.get(p.toUri()).equals(p.toAbsolutePath())

    so long as the originalPath, theURI, and the newPath are all created in (possibly different invocations of) the same Java virtual machine. Whether other providers make any guarantees is provider specific and therefore unspecified.

    Parameters:

    uri - the URI to convert

    Returns:

    the resultingPath

    Throws:

    IllegalArgumentException - if preconditions on theuri parameter do not hold. The format of the URI is provider specific.

    FileSystemNotFoundException - The file system, identified by the URI, does not exist and cannot be created automatically, or the provider identified by the URI's scheme component is not installed

    SecurityException - if a security manager is installed and it denies an unspecified permission to access the file system