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 lazily converts each path to a file and calls ``getJavaObjectsFromFiles`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 | ### 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

### 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 lazily converts each path to a file and calls ``getJavaObjectsFromFiles`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 | ### 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

### method:getJavaFileObjects(java.io.File...) [CHANGED]
### getJavaFileObjects Iterable<? extends JavaFileObject> getJavaFileObjects (File... files) Returns file objects representing the given files. Convenience method equivalent to:
         getJavaFileObjectsFromFiles(Arrays.asList(files))
Parameters: `files` - an array of files Returns: a list of file objects Throws: `IllegalArgumentException` - if the array of files includes a directory or if this file manager does not support any of the given paths `NullPointerException` - if the given array contains null elements
### getJavaFileObjects Iterable<? extends JavaFileObject> getJavaFileObjects (File... files) Returns file objects representing the given files. Convenience method equivalent to:
         getJavaFileObjectsFromFiles(Arrays.asList(files))
Parameters: `files` - an array of files Returns: a list of file objects Throws: `IllegalArgumentException` - if the array of files includes a directory `NullPointerException` - if the given array contains null elements | ### getJavaFileObjects Iterable<? extends JavaFileObject> getJavaFileObjects (File... files) Returns file objects representing the given files. Convenience method equivalent to:
         getJavaFileObjectsFromFiles(Arrays.asList(files))
Parameters: `files` - an array of files Returns: a list of file objects Throws: `IllegalArgumentException` - if the array of files includes a directory or if this file manager does not support any of the given paths `NullPointerException` - if the given array contains null elements

### 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))
Implementation Requirements: The default implementation will only throw `NullPointerException` if getJavaFileObjectsFromPaths(Collection) throws it. Parameters: `paths` - an array of paths Returns: a list of file objects Throws: `IllegalArgumentException` - if the array of files includes a directory or if this file manager does not support any of the given paths `NullPointerException` - if the given array contains null elements 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 | ### getJavaFileObjects default Iterable<? extends JavaFileObject> getJavaFileObjects (Path... paths) Returns file objects representing the given paths. Convenience method equivalent to:
         getJavaFileObjectsFromPaths(Arrays.asList(paths))
Implementation Requirements: The default implementation will only throw `NullPointerException` if getJavaFileObjectsFromPaths(Collection) throws it. Parameters: `paths` - an array of paths Returns: a list of file objects Throws: `IllegalArgumentException` - if the array of files includes a directory or if this file manager does not support any of the given paths `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 lazily converts each path to a file and calls ``getJavaObjectsFromFiles`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: `getLocation(javax.tools.JavaFileManager.Location)`
### 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: `getLocation(javax.tools.JavaFileManager.Location)` | ### 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: `getLocation(javax.tools.JavaFileManager.Location)`