Module java.base
Package 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 or URI.
API Note:
It is recommended to obtain a Path via the Path.of methods instead of via the get methods defined in this class as this class may be deprecated in a future release.
Since:
1.7
See Also:
Path
  • Method Details

    • 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.
      Implementation Requirements:
      This method simply invokes Path.of(String, String...) with the given parameters.
      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...), Path.of(String,String...)
    • get

      public static Path get​(URI uri)
      Converts the given URI to a Path object.
      Implementation Requirements:
      This method simply invokes Path.of(URI) with the given parameter.
      Parameters:
      uri - the URI to convert
      Returns:
      the resulting Path
      Throws:
      IllegalArgumentException - if preconditions on the uri 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
      See Also:
      Path.of(URI)