Uses of Interface
java.nio.file.Path
Package
Description
Provides for system input and output through data streams,
serialization and the file system.
Classes to support module descriptors and creating configurations of modules
by means of resolution and service binding.
Provides the classes for implementing networking applications.
HTTP Client and WebSocket APIs
Defines channels, which represent connections to entities that are capable of
performing I/O operations, such as files and sockets; defines selectors, for
multiplexed, non-blocking I/O operations.
Defines interfaces and classes for the Java virtual machine to access files,
file attributes, and file systems.
Service-provider classes for the
java.nio.file
package.Contains the collections framework, some internationalization support classes,
a service loader, properties, random number generation, string parsing
and scanning classes, base64 encoding and decoding, a bit array, and
several miscellaneous utility classes.
Provides interfaces for tools which can be invoked from a program,
for example, compilers.
-
Uses of Path in java.io
Modifier and TypeMethodDescriptionFile.toPath()
Returns ajava.nio.file.Path
object constructed from this abstract path. -
Uses of Path in java.lang.module
Modifier and TypeMethodDescriptionstatic ModuleFinder
Returns a module finder that locates modules on the file system by searching a sequence of directories and/or packaged modules. -
Uses of Path in java.net
Modifier and TypeMethodDescriptionstatic UnixDomainSocketAddress
Creates a UnixDomainSocketAddress for the given path. -
Uses of Path in java.net.http
Modifier and TypeMethodDescriptionstatic HttpResponse.BodyHandler<Path>
static HttpResponse.BodyHandler<Path>
HttpResponse.BodyHandlers.ofFile
(Path file, OpenOption... openOptions) Returns aBodyHandler<Path>
that returns aBodySubscriber
<Path>
obtained fromBodySubscribers.ofFile(Path,OpenOption...)
.static HttpResponse.BodySubscriber<Path>
Returns aBodySubscriber
which stores the response body in a file opened with the given name.static HttpResponse.BodySubscriber<Path>
HttpResponse.BodySubscribers.ofFile
(Path file, OpenOption... openOptions) Returns aBodySubscriber
which stores the response body in a file opened with the given options and name.static HttpResponse.BodyHandler<Path>
HttpResponse.BodyHandlers.ofFileDownload
(Path directory, OpenOption... openOptions) Returns aBodyHandler<Path>
that returns aBodySubscriber
<Path
> where the download directory is specified, but the filename is obtained from theContent-Disposition
response header.Modifier and TypeMethodDescriptionstatic HttpRequest.BodyPublisher
A request body publisher that takes data from the contents of a File.static HttpResponse.BodyHandler<Path>
static HttpResponse.BodyHandler<Path>
HttpResponse.BodyHandlers.ofFile
(Path file, OpenOption... openOptions) Returns aBodyHandler<Path>
that returns aBodySubscriber
<Path>
obtained fromBodySubscribers.ofFile(Path,OpenOption...)
.static HttpResponse.BodySubscriber<Path>
Returns aBodySubscriber
which stores the response body in a file opened with the given name.static HttpResponse.BodySubscriber<Path>
HttpResponse.BodySubscribers.ofFile
(Path file, OpenOption... openOptions) Returns aBodySubscriber
which stores the response body in a file opened with the given options and name.static HttpResponse.BodyHandler<Path>
HttpResponse.BodyHandlers.ofFileDownload
(Path directory, OpenOption... openOptions) Returns aBodyHandler<Path>
that returns aBodySubscriber
<Path
> where the download directory is specified, but the filename is obtained from theContent-Disposition
response header. -
Uses of Path in java.nio.channels
Modifier and TypeMethodDescriptionstatic AsynchronousFileChannel
AsynchronousFileChannel.open
(Path file, OpenOption... options) Opens or creates a file for reading and/or writing, returning an asynchronous file channel to access the file.static AsynchronousFileChannel
AsynchronousFileChannel.open
(Path file, Set<? extends OpenOption> options, ExecutorService executor, FileAttribute<?>... attrs) Opens or creates a file for reading and/or writing, returning an asynchronous file channel to access the file.static FileChannel
FileChannel.open
(Path path, OpenOption... options) Opens or creates a file, returning a file channel to access the file.static FileChannel
FileChannel.open
(Path path, Set<? extends OpenOption> options, FileAttribute<?>... attrs) Opens or creates a file, returning a file channel to access the file. -
Uses of Path in java.nio.file
Modifier and TypeFieldDescriptionstatic final WatchEvent.Kind<Path>
StandardWatchEventKinds.ENTRY_CREATE
Directory entry created.static final WatchEvent.Kind<Path>
StandardWatchEventKinds.ENTRY_DELETE
Directory entry deleted.static final WatchEvent.Kind<Path>
StandardWatchEventKinds.ENTRY_MODIFY
Directory entry modified.Modifier and TypeMethodDescriptionstatic Path
Files.copy
(Path source, Path target, CopyOption... options) Copy a file to a target file.static Path
Files.createDirectories
(Path dir, FileAttribute<?>... attrs) Creates a directory by creating all nonexistent parent directories first.static Path
Files.createDirectory
(Path dir, FileAttribute<?>... attrs) Creates a new directory.static Path
Files.createFile
(Path path, FileAttribute<?>... attrs) Creates a new and empty file, failing if the file already exists.static Path
Files.createLink
(Path link, Path existing) Creates a new link (directory entry) for an existing file (optional operation).static Path
Files.createSymbolicLink
(Path link, Path target, FileAttribute<?>... attrs) Creates a symbolic link to a target (optional operation).static Path
Files.createTempDirectory
(String prefix, FileAttribute<?>... attrs) Creates a new directory in the default temporary-file directory, using the given prefix to generate its name.static Path
Files.createTempDirectory
(Path dir, String prefix, FileAttribute<?>... attrs) Creates a new directory in the specified directory, using the given prefix to generate its name.static Path
Files.createTempFile
(String prefix, String suffix, FileAttribute<?>... attrs) Creates an empty file in the default temporary-file directory, using the given prefix and suffix to generate its name.static Path
Files.createTempFile
(Path dir, String prefix, String suffix, FileAttribute<?>... attrs) Creates a new empty file in the specified directory, using the given prefix and suffix strings to generate its name.static Path
Converts a path string, or a sequence of strings that when joined form a path string, to aPath
.static Path
Converts the given URI to aPath
object.Path.getFileName()
Returns the name of the file or directory denoted by this path as aPath
object.Path.getName
(int index) Returns a name element of this path as aPath
object.Path.getParent()
Returns the parent path, ornull
if this path does not have a parent.abstract Path
Converts a path string, or a sequence of strings that when joined form a path string, to aPath
.Path.getRoot()
Returns the root component of this path as aPath
object, ornull
if this path does not have a root component.static Path
Files.move
(Path source, Path target, CopyOption... options) Move or rename a file to a target file.Path.normalize()
Returns a path that is this path with redundant name elements eliminated.static Path
Returns aPath
by converting a path string, or a sequence of strings that when joined form a path string.static Path
Returns aPath
by converting a URI.static Path
Files.readSymbolicLink
(Path link) Reads the target of a symbolic link (optional operation).Path.relativize
(Path other) Constructs a relative path between this path and a given path.default Path
Converts a given path string to aPath
and resolves it against thisPath
in exactly the manner specified by theresolve
method.Resolve the given path against this path.default Path
Path.resolveSibling
(String other) Converts a given path string to aPath
and resolves it against this path'sparent
path in exactly the manner specified by theresolveSibling
method.default Path
Path.resolveSibling
(Path other) Resolves the given path against this path'sparent
path.static Path
Files.setAttribute
(Path path, String attribute, Object value, LinkOption... options) Sets the value of a file attribute.static Path
Files.setLastModifiedTime
(Path path, FileTime time) Updates a file's last modified time attribute.static Path
Files.setOwner
(Path path, UserPrincipal owner) Updates the file owner.static Path
Files.setPosixFilePermissions
(Path path, Set<PosixFilePermission> perms) Sets a file's POSIX permissions.Path.subpath
(int beginIndex, int endIndex) Returns a relativePath
that is a subsequence of the name elements of this path.Path.toAbsolutePath()
Returns aPath
object representing the absolute path of this path.Path.toRealPath
(LinkOption... options) Returns the real path of an existing file.static Path
Files.walkFileTree
(Path start, FileVisitor<? super Path> visitor) Walks a file tree.static Path
Files.walkFileTree
(Path start, Set<FileVisitOption> options, int maxDepth, FileVisitor<? super Path> visitor) Walks a file tree.static Path
Files.write
(Path path, byte[] bytes, OpenOption... options) Writes bytes to a file.static Path
Files.write
(Path path, Iterable<? extends CharSequence> lines, Charset cs, OpenOption... options) Write lines of text to a file.static Path
Files.write
(Path path, Iterable<? extends CharSequence> lines, OpenOption... options) Write lines of text to a file.static Path
Files.writeString
(Path path, CharSequence csq, Charset cs, OpenOption... options) Write a CharSequence to a file.static Path
Files.writeString
(Path path, CharSequence csq, OpenOption... options) Write a CharSequence to a file.Modifier and TypeMethodDescriptionFiles.find
(Path start, int maxDepth, BiPredicate<Path, BasicFileAttributes> matcher, FileVisitOption... options) Return aStream
that is lazily populated withPath
by searching for files in a file tree rooted at a given starting file.FileSystem.getRootDirectories()
Returns an object to iterate over the paths of the root directories.Path.iterator()
Returns an iterator over the name elements of this path.Return a lazily populatedStream
, the elements of which are the entries in the directory.static DirectoryStream<Path>
Files.newDirectoryStream
(Path dir) Opens a directory, returning aDirectoryStream
to iterate over all entries in the directory.static DirectoryStream<Path>
Files.newDirectoryStream
(Path dir, String glob) Opens a directory, returning aDirectoryStream
to iterate over the entries in the directory.static DirectoryStream<Path>
Files.newDirectoryStream
(Path dir, DirectoryStream.Filter<? super Path> filter) Opens a directory, returning aDirectoryStream
to iterate over the entries in the directory.Files.walk
(Path start, int maxDepth, FileVisitOption... options) Return aStream
that is lazily populated withPath
by walking the file tree rooted at a given starting file.Files.walk
(Path start, FileVisitOption... options) Return aStream
that is lazily populated withPath
by walking the file tree rooted at a given starting file.Modifier and TypeMethodDescriptionint
Compares two abstract paths lexicographically.static long
Files.copy
(InputStream in, Path target, CopyOption... options) Copies all bytes from an input stream to a file.static long
Files.copy
(Path source, OutputStream out) Copies all bytes from a file to an output stream.static Path
Files.copy
(Path source, Path target, CopyOption... options) Copy a file to a target file.static Path
Files.createDirectories
(Path dir, FileAttribute<?>... attrs) Creates a directory by creating all nonexistent parent directories first.static Path
Files.createDirectory
(Path dir, FileAttribute<?>... attrs) Creates a new directory.static Path
Files.createFile
(Path path, FileAttribute<?>... attrs) Creates a new and empty file, failing if the file already exists.static Path
Files.createLink
(Path link, Path existing) Creates a new link (directory entry) for an existing file (optional operation).static Path
Files.createSymbolicLink
(Path link, Path target, FileAttribute<?>... attrs) Creates a symbolic link to a target (optional operation).static Path
Files.createTempDirectory
(Path dir, String prefix, FileAttribute<?>... attrs) Creates a new directory in the specified directory, using the given prefix to generate its name.static Path
Files.createTempFile
(Path dir, String prefix, String suffix, FileAttribute<?>... attrs) Creates a new empty file in the specified directory, using the given prefix and suffix strings to generate its name.static void
Deletes a file.static boolean
Files.deleteIfExists
(Path path) Deletes a file if it exists.boolean
Tests if this path ends with the given path.static boolean
Files.exists
(Path path, LinkOption... options) Tests whether a file exists.Files.find
(Path start, int maxDepth, BiPredicate<Path, BasicFileAttributes> matcher, FileVisitOption... options) Return aStream
that is lazily populated withPath
by searching for files in a file tree rooted at a given starting file.static Object
Files.getAttribute
(Path path, String attribute, LinkOption... options) Reads the value of a file attribute.static <V extends FileAttributeView>
VFiles.getFileAttributeView
(Path path, Class<V> type, LinkOption... options) Returns a file attribute view of a given type.static FileStore
Files.getFileStore
(Path path) Returns theFileStore
representing the file store where a file is located.static FileTime
Files.getLastModifiedTime
(Path path, LinkOption... options) Returns a file's last modified time.static UserPrincipal
Files.getOwner
(Path path, LinkOption... options) Returns the owner of a file.static Set<PosixFilePermission>
Files.getPosixFilePermissions
(Path path, LinkOption... options) Returns a file's POSIX file permissions.static boolean
Files.isDirectory
(Path path, LinkOption... options) Tests whether a file is a directory.static boolean
Files.isExecutable
(Path path) Tests whether a file is executable.static boolean
Tells whether or not a file is considered hidden.static boolean
Files.isReadable
(Path path) Tests whether a file is readable.static boolean
Files.isRegularFile
(Path path, LinkOption... options) Tests whether a file is a regular file with opaque content.static boolean
Files.isSameFile
(Path path, Path path2) Tests if two paths locate the same file.static boolean
Files.isSymbolicLink
(Path path) Tests whether a file is a symbolic link.static boolean
Files.isWritable
(Path path) Tests whether a file is writable.Read all lines from a file as aStream
.Read all lines from a file as aStream
.Return a lazily populatedStream
, the elements of which are the entries in the directory.boolean
Tells if given path matches this matcher's pattern.static long
Finds and returns the position of the first mismatched byte in the content of two files, or-1L
if there is no mismatch.static Path
Files.move
(Path source, Path target, CopyOption... options) Move or rename a file to a target file.static BufferedReader
Files.newBufferedReader
(Path path) Opens a file for reading, returning aBufferedReader
to read text from the file in an efficient manner.static BufferedReader
Files.newBufferedReader
(Path path, Charset cs) Opens a file for reading, returning aBufferedReader
that may be used to read text from the file in an efficient manner.static BufferedWriter
Files.newBufferedWriter
(Path path, Charset cs, OpenOption... options) Opens or creates a file for writing, returning aBufferedWriter
that may be used to write text to the file in an efficient manner.static BufferedWriter
Files.newBufferedWriter
(Path path, OpenOption... options) Opens or creates a file for writing, returning aBufferedWriter
to write text to the file in an efficient manner.static SeekableByteChannel
Files.newByteChannel
(Path path, OpenOption... options) Opens or creates a file, returning a seekable byte channel to access the file.static SeekableByteChannel
Files.newByteChannel
(Path path, Set<? extends OpenOption> options, FileAttribute<?>... attrs) Opens or creates a file, returning a seekable byte channel to access the file.static DirectoryStream<Path>
Files.newDirectoryStream
(Path dir) Opens a directory, returning aDirectoryStream
to iterate over all entries in the directory.static DirectoryStream<Path>
Files.newDirectoryStream
(Path dir, String glob) Opens a directory, returning aDirectoryStream
to iterate over the entries in the directory.static DirectoryStream<Path>
Files.newDirectoryStream
(Path dir, DirectoryStream.Filter<? super Path> filter) Opens a directory, returning aDirectoryStream
to iterate over the entries in the directory.static FileSystem
FileSystems.newFileSystem
(Path path) Constructs a newFileSystem
to access the contents of a file as a file system.static FileSystem
FileSystems.newFileSystem
(Path path, ClassLoader loader) Constructs a newFileSystem
to access the contents of a file as a file system.static FileSystem
FileSystems.newFileSystem
(Path path, Map<String, ?> env) Constructs a newFileSystem
to access the contents of a file as a file system.static FileSystem
FileSystems.newFileSystem
(Path path, Map<String, ?> env, ClassLoader loader) Constructs a newFileSystem
to access the contents of a file as a file system.static InputStream
Files.newInputStream
(Path path, OpenOption... options) Opens a file, returning an input stream to read from the file.static OutputStream
Files.newOutputStream
(Path path, OpenOption... options) Opens or creates a file, returning an output stream that may be used to write bytes to the file.static boolean
Files.notExists
(Path path, LinkOption... options) Tests whether the file located by this path does not exist.static String
Files.probeContentType
(Path path) Probes the content type of a file.static byte[]
Files.readAllBytes
(Path path) Reads all the bytes from a file.Files.readAllLines
(Path path) Read all lines from a file.Files.readAllLines
(Path path, Charset cs) Read all lines from a file.static <A extends BasicFileAttributes>
AFiles.readAttributes
(Path path, Class<A> type, LinkOption... options) Reads a file's attributes as a bulk operation.Files.readAttributes
(Path path, String attributes, LinkOption... options) Reads a set of file attributes as a bulk operation.static String
Files.readString
(Path path) static String
Files.readString
(Path path, Charset cs) Reads all characters from a file into a string, decoding from bytes to characters using the specified charset.static Path
Files.readSymbolicLink
(Path link) Reads the target of a symbolic link (optional operation).Path.relativize
(Path other) Constructs a relative path between this path and a given path.Resolve the given path against this path.default Path
Path.resolveSibling
(Path other) Resolves the given path against this path'sparent
path.static Path
Files.setAttribute
(Path path, String attribute, Object value, LinkOption... options) Sets the value of a file attribute.static Path
Files.setLastModifiedTime
(Path path, FileTime time) Updates a file's last modified time attribute.static Path
Files.setOwner
(Path path, UserPrincipal owner) Updates the file owner.static Path
Files.setPosixFilePermissions
(Path path, Set<PosixFilePermission> perms) Sets a file's POSIX permissions.static long
Returns the size of a file (in bytes).boolean
Path.startsWith
(Path other) Tests if this path starts with the given path.Files.walk
(Path start, int maxDepth, FileVisitOption... options) Return aStream
that is lazily populated withPath
by walking the file tree rooted at a given starting file.Files.walk
(Path start, FileVisitOption... options) Return aStream
that is lazily populated withPath
by walking the file tree rooted at a given starting file.static Path
Files.walkFileTree
(Path start, FileVisitor<? super Path> visitor) Walks a file tree.static Path
Files.walkFileTree
(Path start, Set<FileVisitOption> options, int maxDepth, FileVisitor<? super Path> visitor) Walks a file tree.static Path
Files.write
(Path path, byte[] bytes, OpenOption... options) Writes bytes to a file.static Path
Files.write
(Path path, Iterable<? extends CharSequence> lines, Charset cs, OpenOption... options) Write lines of text to a file.static Path
Files.write
(Path path, Iterable<? extends CharSequence> lines, OpenOption... options) Write lines of text to a file.static Path
Files.writeString
(Path path, CharSequence csq, Charset cs, OpenOption... options) Write a CharSequence to a file.static Path
Files.writeString
(Path path, CharSequence csq, OpenOption... options) Write a CharSequence to a file.Modifier and TypeMethodDescriptionFiles.find
(Path start, int maxDepth, BiPredicate<Path, BasicFileAttributes> matcher, FileVisitOption... options) Return aStream
that is lazily populated withPath
by searching for files in a file tree rooted at a given starting file.static DirectoryStream<Path>
Files.newDirectoryStream
(Path dir, DirectoryStream.Filter<? super Path> filter) Opens a directory, returning aDirectoryStream
to iterate over the entries in the directory.static Path
Files.walkFileTree
(Path start, FileVisitor<? super Path> visitor) Walks a file tree.static Path
Files.walkFileTree
(Path start, Set<FileVisitOption> options, int maxDepth, FileVisitor<? super Path> visitor) Walks a file tree. -
Uses of Path in java.nio.file.spi
Modifier and TypeMethodDescriptionabstract Path
Return aPath
object by converting the givenURI
.FileSystemProvider.readSymbolicLink
(Path link) Reads the target of a symbolic link.Modifier and TypeMethodDescriptionabstract DirectoryStream<Path>
FileSystemProvider.newDirectoryStream
(Path dir, DirectoryStream.Filter<? super Path> filter) Opens a directory, returning aDirectoryStream
to iterate over the entries in the directory.Modifier and TypeMethodDescriptionabstract void
FileSystemProvider.checkAccess
(Path path, AccessMode... modes) Checks the existence, and optionally the accessibility, of a file.abstract void
FileSystemProvider.copy
(Path source, Path target, CopyOption... options) Copy a file to a target file.abstract void
FileSystemProvider.createDirectory
(Path dir, FileAttribute<?>... attrs) Creates a new directory.void
FileSystemProvider.createLink
(Path link, Path existing) Creates a new link (directory entry) for an existing file.void
FileSystemProvider.createSymbolicLink
(Path link, Path target, FileAttribute<?>... attrs) Creates a symbolic link to a target.abstract void
Deletes a file.boolean
FileSystemProvider.deleteIfExists
(Path path) Deletes a file if it exists.abstract <V extends FileAttributeView>
VFileSystemProvider.getFileAttributeView
(Path path, Class<V> type, LinkOption... options) Returns a file attribute view of a given type.abstract FileStore
FileSystemProvider.getFileStore
(Path path) Returns theFileStore
representing the file store where a file is located.abstract boolean
Tells whether or not a file is considered hidden.abstract boolean
FileSystemProvider.isSameFile
(Path path, Path path2) Tests if two paths locate the same file.abstract void
FileSystemProvider.move
(Path source, Path target, CopyOption... options) Move or rename a file to a target file.FileSystemProvider.newAsynchronousFileChannel
(Path path, Set<? extends OpenOption> options, ExecutorService executor, FileAttribute<?>... attrs) Opens or creates a file for reading and/or writing, returning an asynchronous file channel to access the file.abstract SeekableByteChannel
FileSystemProvider.newByteChannel
(Path path, Set<? extends OpenOption> options, FileAttribute<?>... attrs) Opens or creates a file, returning a seekable byte channel to access the file.abstract DirectoryStream<Path>
FileSystemProvider.newDirectoryStream
(Path dir, DirectoryStream.Filter<? super Path> filter) Opens a directory, returning aDirectoryStream
to iterate over the entries in the directory.FileSystemProvider.newFileChannel
(Path path, Set<? extends OpenOption> options, FileAttribute<?>... attrs) Opens or creates a file for reading and/or writing, returning a file channel to access the file.FileSystemProvider.newFileSystem
(Path path, Map<String, ?> env) Constructs a newFileSystem
to access the contents of a file as a file system.FileSystemProvider.newInputStream
(Path path, OpenOption... options) Opens a file, returning an input stream to read from the file.FileSystemProvider.newOutputStream
(Path path, OpenOption... options) Opens or creates a file, returning an output stream that may be used to write bytes to the file.abstract String
FileTypeDetector.probeContentType
(Path path) Probes the given file to guess its content type.abstract <A extends BasicFileAttributes>
AFileSystemProvider.readAttributes
(Path path, Class<A> type, LinkOption... options) Reads a file's attributes as a bulk operation.FileSystemProvider.readAttributes
(Path path, String attributes, LinkOption... options) Reads a set of file attributes as a bulk operation.FileSystemProvider.readSymbolicLink
(Path link) Reads the target of a symbolic link.abstract void
FileSystemProvider.setAttribute
(Path path, String attribute, Object value, LinkOption... options) Sets the value of a file attribute.Modifier and TypeMethodDescriptionabstract DirectoryStream<Path>
FileSystemProvider.newDirectoryStream
(Path dir, DirectoryStream.Filter<? super Path> filter) Opens a directory, returning aDirectoryStream
to iterate over the entries in the directory. -
Uses of Path in java.util
ModifierConstructorDescriptionConstructs a newScanner
that produces values scanned from the specified file.Constructs a newScanner
that produces values scanned from the specified file.Constructs a newScanner
that produces values scanned from the specified file. -
Uses of Path in javax.tools
Modifier and TypeMethodDescriptiondefault Path
StandardJavaFileManager.asPath
(FileObject file) Returns the path, if any, underlying this file object (optional operation).Converts a path string, or a sequence of strings that when joined form a path string, to a Path.Modifier and TypeMethodDescriptionStandardJavaFileManager.getLocationAsPaths
(JavaFileManager.Location location) Returns the search path associated with the given location.Modifier and TypeMethodDescriptiondefault Iterable<? extends JavaFileObject>
StandardJavaFileManager.getJavaFileObjects
(Path... paths) Returns file objects representing the given paths.Modifier and TypeMethodDescriptiondefault Iterable<? extends JavaFileObject>
StandardJavaFileManager.getJavaFileObjectsFromPaths
(Iterable<? extends Path> paths) Deprecated.default Iterable<? extends JavaFileObject>
StandardJavaFileManager.getJavaFileObjectsFromPaths
(Collection<? extends Path> paths) Returns file objects representing the given paths.default void
StandardJavaFileManager.setLocationForModule
(JavaFileManager.Location location, String moduleName, Collection<? extends Path> paths) Associates the given search path with the given module and location, which must be a module-oriented or output location.default void
StandardJavaFileManager.setLocationFromPaths
(JavaFileManager.Location location, Collection<? extends Path> paths) Associates the given search path with the given location.
StandardJavaFileManager.getJavaFileObjectsFromPaths(Collection)
instead, to prevent the possibility of accidentally calling the method with a singlePath
as such an argument.