Package Summary  Overview Summary

method:getJavaFileObjectsFromPaths(java.util.Collection) [CHANGED]

getJavaFileObjectsFromPaths

default Iterable<? extends JavaFileObject>  getJavaFileObjectsFromPaths (Collection<? extends Path> paths)
Returns file objects representing the given paths.
Implementation Requirements:
The default implementation lazilyconverts each path to a file and calls getJavaFileObjectsFromFilesgetJavaObjectsFromFiles. IllegalArgumentException will be thrown if any of the paths cannot be converted to a file at the point the conversion happens.
Parameters:
paths - a list of paths
Returns:
a list of file objects
Throws:
IllegalArgumentException - if the list of paths includes a directory or if this file manager does not support any of the given paths.
Since:
13

getJavaFileObjectsFromPaths

default Iterable<? extends JavaFileObject>  getJavaFileObjectsFromPaths (Collection<? extends Path> paths)
Returns file objects representing the given paths.
Implementation Requirements:
The default implementation lazily converts each path to a file and calls getJavaFileObjectsFromFiles. IllegalArgumentException will be thrown if any of the paths cannot be converted to a file at the point the conversion happens.
Parameters:
paths - a list of paths
Returns:
a list of file objects
Throws:
IllegalArgumentException - if the list of paths includes a directory or if this file manager does not support any of the given paths.
Since:
13

getJavaFileObjectsFromPaths

default Iterable<? extends JavaFileObject>  getJavaFileObjectsFromPaths (Collection<? extends Path> paths)
Returns file objects representing the given paths.
Implementation Requirements:
The default implementation converts each path to a file and calls getJavaObjectsFromFiles. IllegalArgumentException will be thrown if any of the paths cannot be converted to a file.
Parameters:
paths - a list of paths
Returns:
a list of file objects
Throws:
IllegalArgumentException - if the list of paths includes a directory or if this file manager does not support any of the given paths.
Since:
13

method:getJavaFileObjectsFromPaths(java.lang.Iterable) [CHANGED]

getJavaFileObjectsFromPaths

@Deprecated(since="13") default Iterable<? extends JavaFileObject>  getJavaFileObjectsFromPaths (Iterable<? extends Path> paths)
Deprecated.
use getJavaFileObjectsFromPaths(Collection) instead, to prevent the possibility of accidentally calling the method with a single Path as such an argument. Although Path implements Iterable<Path>, it would almost never be correct to pass a single Path and have it be treated as an Iterable of its components.
Returns file objects representing the given paths.
Implementation Requirements:
The default implementation lazilyconverts each path to a file and calls getJavaFileObjectsFromPathsgetJavaObjectsFromFiles. IllegalArgumentException will be thrown if any of the paths cannot be converted to a file at the point the conversion happens.
Parameters:
paths - a list of paths
Returns:
a list of file objects
Throws:
IllegalArgumentException - if the list of paths includes a directory or if this file manager does not support any of the given paths.
Since:
9

getJavaFileObjectsFromPaths

@Deprecated(since="13") default Iterable<? extends JavaFileObject>  getJavaFileObjectsFromPaths (Iterable<? extends Path> paths)
Deprecated.
use getJavaFileObjectsFromPaths(Collection) instead, to prevent the possibility of accidentally calling the method with a single Path as such an argument. Although Path implements Iterable<Path>, it would almost never be correct to pass a single Path and have it be treated as an Iterable of its components.
Returns file objects representing the given paths.
Implementation Requirements:
The default implementation lazily converts each path to a file and calls getJavaFileObjectsFromPaths. IllegalArgumentException will be thrown if any of the paths cannot be converted to a file at the point the conversion happens.
Parameters:
paths - a list of paths
Returns:
a list of file objects
Throws:
IllegalArgumentException - if the list of paths includes a directory or if this file manager does not support any of the given paths.
Since:
9

getJavaFileObjectsFromPaths

@Deprecated(since="13") default Iterable<? extends JavaFileObject>  getJavaFileObjectsFromPaths (Iterable<? extends Path> paths)
Deprecated.
use getJavaFileObjectsFromPaths(Collection) instead, to prevent the possibility of accidentally calling the method with a single Path as such an argument. Although Path implements Iterable<Path>, it would almost never be correct to pass a single Path and have it be treated as an Iterable of its components.
Returns file objects representing the given paths.
Implementation Requirements:
The default implementation converts each path to a file and calls getJavaObjectsFromFiles. IllegalArgumentException will be thrown if any of the paths cannot be converted to a file.
Parameters:
paths - a list of paths
Returns:
a list of file objects
Throws:
IllegalArgumentException - if the list of paths includes a directory or if this file manager does not support any of the given paths.
Since:
9

method:getJavaFileObjects(java.nio.file.Path...) [CHANGED]

getJavaFileObjects

default Iterable<? extends JavaFileObject>  getJavaFileObjects (Path... paths)
Returns file objects representing the given paths. Convenience method equivalent to:
     getJavaFileObjectsFromPaths(Arrays.asList(paths))
 
Parameters:
paths - an array of paths
Returns:
a list of file objects
Throws:
IllegalArgumentException - if the array of files includes a directory
NullPointerException - if the given array contains null elements and the given element is used by getJavaFileObjectsFromPaths(Collection).
Since:
9

getJavaFileObjects

default Iterable<? extends JavaFileObject>  getJavaFileObjects (Path... paths)
Returns file objects representing the given paths. Convenience method equivalent to:
     getJavaFileObjectsFromPaths(Arrays.asList(paths))
 
Parameters:
paths - an array of paths
Returns:
a list of file objects
Throws:
IllegalArgumentException - if the array of files includes a directory
NullPointerException - if the given array contains null elements and the given element is used by getJavaFileObjectsFromPaths(Collection).
Since:
9

getJavaFileObjects

default Iterable<? extends JavaFileObject>  getJavaFileObjects (Path... paths)
Returns file objects representing the given paths. Convenience method equivalent to:
     getJavaFileObjectsFromPaths(Arrays.asList(paths))
 
Parameters:
paths - an array of paths
Returns:
a list of file objects
Throws:
IllegalArgumentException - if the array of files includes a directory
NullPointerException - if the given array contains null elements
Since:
9

method:setLocationFromPaths(javax.tools.JavaFileManager.Location,java.util.Collection) [CHANGED]

setLocationFromPaths

default void setLocationFromPaths (JavaFileManager.Location location, Collection<? extends Path> paths) throws IOException
Associates the given search path with the given location. Any previous value will be discarded. If the location is a module-oriented or output location, any module-specific associations set up by setLocationForModule will be cancelled.
Implementation Requirements:
The default implementation lazilyconverts each path to a file and calls setLocationgetJavaObjectsFromFiles. IllegalArgumentException will be thrown if any of the paths cannot be converted to a file at the point the conversion happens.
Parameters:
location - a location
paths - a list of paths, if null use the default search path for this location
Throws:
IllegalArgumentException - if location is an output location and paths does not contain exactly one element or if this file manager does not support any of the given paths
IOException - if location is an output location and paths does not represent an existing directory
Since:
9
See Also:

setLocationFromPaths

default void setLocationFromPaths (JavaFileManager.Location location, Collection<? extends Path> paths) throws IOException
Associates the given search path with the given location. Any previous value will be discarded. If the location is a module-oriented or output location, any module-specific associations set up by setLocationForModule will be cancelled.
Implementation Requirements:
The default implementation lazily converts each path to a file and calls setLocation. IllegalArgumentException will be thrown if any of the paths cannot be converted to a file at the point the conversion happens.
Parameters:
location - a location
paths - a list of paths, if null use the default search path for this location
Throws:
IllegalArgumentException - if location is an output location and paths does not contain exactly one element or if this file manager does not support any of the given paths
IOException - if location is an output location and paths does not represent an existing directory
Since:
9
See Also:

setLocationFromPaths

default void setLocationFromPaths (JavaFileManager.Location location, Collection<? extends Path> paths) throws IOException
Associates the given search path with the given location. Any previous value will be discarded. If the location is a module-oriented or output location, any module-specific associations set up by setLocationForModule will be cancelled.
Implementation Requirements:
The default implementation converts each path to a file and calls getJavaObjectsFromFiles. IllegalArgumentException will be thrown if any of the paths cannot be converted to a file.
Parameters:
location - a location
paths - a list of paths, if null use the default search path for this location
Throws:
IllegalArgumentException - if location is an output location and paths does not contain exactly one element or if this file manager does not support any of the given paths
IOException - if location is an output location and paths does not represent an existing directory
Since:
9
See Also: